pstk.h

来自「开放源码的编译器open watcom 1.6.0版的源代码」· C头文件 代码 · 共 82 行

/****************************************************************************
*
*                            Open Watcom Project
*
*    Portions Copyright (c) 1983-2002 Sybase, Inc. All Rights Reserved.
*
*  ========================================================================
*
*    This file contains Original Code and/or Modifications of Original
*    Code as defined in and that are subject to the Sybase Open Watcom
*    Public License version 1.0 (the 'License'). You may not use this file
*    except in compliance with the License. BY USING THIS FILE YOU AGREE TO
*    ALL TERMS AND CONDITIONS OF THE LICENSE. A copy of the License is
*    provided with the Original Code and Modifications, and is also
*    available at www.sybase.com/developer/opensource.
*
*    The Original Code and all software distributed under the License are
*    distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
*    EXPRESS OR IMPLIED, AND SYBASE AND ALL CONTRIBUTORS HEREBY DISCLAIM
*    ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF
*    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR
*    NON-INFRINGEMENT. Please see the License for the specific language
*    governing rights and limitations under the License.
*
*  ========================================================================
*
* Description:  WHEN YOU FIGURE OUT WHAT THIS FILE DOES, PLEASE
*               DESCRIBE IT HERE!
*
****************************************************************************/


#ifndef __PSTK_H__
#define __PSTK_H__

#ifdef __cplusplus
extern "C" {
#endif

// PSTK.H -- virtual pointer stacking
//
typedef struct pstk_ctl     PSTK_CTL;       // control element for PSTK
typedef struct pstk_blk     PSTK_BLK;       // block of items
typedef struct pstk_iter    PSTK_ITER;      // iterator

struct pstk_ctl {               // PSTK_CTL -- controller for a pointer stack
    void const **top_item;      // - top occupied slot
    PSTK_BLK *top_blk;          // - top of blocks
    PSTK_BLK *popped_blk;       // - last popped block
};

struct pstk_iter {              // PSTK_ITER -- iterator for PSTK
    PSTK_CTL const *pstk;       // - pstack being iterated
    PSTK_BLK const *block;      // - current block
    void const * const *item;   // - last item returned
    void const * const *top;    // - addr[ top element in stack ]
    void const * const *bot;    // - addr[ bottom element in stack ]
};

void PstkPush( PSTK_CTL *, void const * );
void **PstkPop( PSTK_CTL * );
void* PstkPopElement( PSTK_CTL * );
void PstkOpen( PSTK_CTL * );
void PstkClose( PSTK_CTL * );
void PstkPopAll( PSTK_CTL * );
void* PstkTopElement( PSTK_CTL * );
void *PstkContainsElement( PSTK_CTL *, void const * );

int PstkIterDnOpen( PSTK_ITER*, PSTK_CTL const * );
void* PstkIterDnNext( PSTK_ITER* );

int PstkIterUpOpen( PSTK_ITER*, PSTK_CTL const * );
void* PstkIterUpNext( PSTK_ITER* );

#define PstkTop( addr_ctl )     ((addr_ctl)->top_item)

#ifdef __cplusplus
};
#endif

#endif