Annotation of embedaddon/php/Zend/zend_list.h, revision 1.1

1.1     ! misho       1: /*
        !             2:    +----------------------------------------------------------------------+
        !             3:    | Zend Engine                                                          |
        !             4:    +----------------------------------------------------------------------+
        !             5:    | Copyright (c) 1998-2012 Zend Technologies Ltd. (http://www.zend.com) |
        !             6:    +----------------------------------------------------------------------+
        !             7:    | This source file is subject to version 2.00 of the Zend license,     |
        !             8:    | that is bundled with this package in the file LICENSE, and is        | 
        !             9:    | available through the world-wide-web at the following url:           |
        !            10:    | http://www.zend.com/license/2_00.txt.                                |
        !            11:    | If you did not receive a copy of the Zend license and are unable to  |
        !            12:    | obtain it through the world-wide-web, please send a note to          |
        !            13:    | license@zend.com so we can mail you a copy immediately.              |
        !            14:    +----------------------------------------------------------------------+
        !            15:    | Authors: Andi Gutmans <andi@zend.com>                                |
        !            16:    |          Zeev Suraski <zeev@zend.com>                                |
        !            17:    +----------------------------------------------------------------------+
        !            18: */
        !            19: 
        !            20: /* $Id: zend_list.h 321634 2012-01-01 13:15:04Z felipe $ */
        !            21: 
        !            22: #ifndef ZEND_LIST_H
        !            23: #define ZEND_LIST_H
        !            24: 
        !            25: #include "zend_hash.h"
        !            26: #include "zend_globals.h"
        !            27: 
        !            28: BEGIN_EXTERN_C()
        !            29: 
        !            30: #define ZEND_RESOURCE_LIST_TYPE_STD    1
        !            31: #define ZEND_RESOURCE_LIST_TYPE_EX     2
        !            32: 
        !            33: typedef struct _zend_rsrc_list_entry {
        !            34:        void *ptr;
        !            35:        int type;
        !            36:        int refcount;
        !            37: } zend_rsrc_list_entry;
        !            38: 
        !            39: typedef void (*rsrc_dtor_func_t)(zend_rsrc_list_entry *rsrc TSRMLS_DC);
        !            40: #define ZEND_RSRC_DTOR_FUNC(name)              void name(zend_rsrc_list_entry *rsrc TSRMLS_DC)
        !            41: 
        !            42: typedef struct _zend_rsrc_list_dtors_entry {
        !            43:        /* old style destructors */
        !            44:        void (*list_dtor)(void *);
        !            45:        void (*plist_dtor)(void *);
        !            46: 
        !            47:        /* new style destructors */
        !            48:        rsrc_dtor_func_t list_dtor_ex;
        !            49:        rsrc_dtor_func_t plist_dtor_ex;
        !            50: 
        !            51:        char *type_name;
        !            52: 
        !            53:        int module_number;
        !            54:        int resource_id;
        !            55:        unsigned char type;
        !            56: } zend_rsrc_list_dtors_entry;
        !            57: 
        !            58: 
        !            59: #define register_list_destructors(ld, pld) zend_register_list_destructors((void (*)(void *))ld, (void (*)(void *))pld, module_number);
        !            60: ZEND_API int zend_register_list_destructors(void (*ld)(void *), void (*pld)(void *), int module_number);
        !            61: ZEND_API int zend_register_list_destructors_ex(rsrc_dtor_func_t ld, rsrc_dtor_func_t pld, char *type_name, int module_number);
        !            62: 
        !            63: void list_entry_destructor(void *ptr);
        !            64: void plist_entry_destructor(void *ptr);
        !            65: 
        !            66: void zend_clean_module_rsrc_dtors(int module_number TSRMLS_DC);
        !            67: int zend_init_rsrc_list(TSRMLS_D);
        !            68: int zend_init_rsrc_plist(TSRMLS_D);
        !            69: void zend_destroy_rsrc_list(HashTable *ht TSRMLS_DC);
        !            70: int zend_init_rsrc_list_dtors(void);
        !            71: void zend_destroy_rsrc_list_dtors(void);
        !            72: 
        !            73: ZEND_API int zend_list_insert(void *ptr, int type);
        !            74: ZEND_API int _zend_list_addref(ulong id TSRMLS_DC);
        !            75: ZEND_API int _zend_list_delete(ulong id TSRMLS_DC);
        !            76: ZEND_API void *_zend_list_find(ulong id, int *type TSRMLS_DC);
        !            77: 
        !            78: #define zend_list_addref(id)           _zend_list_addref(id TSRMLS_CC)
        !            79: #define zend_list_delete(id)           _zend_list_delete(id TSRMLS_CC)
        !            80: #define zend_list_find(id, type)       _zend_list_find(id, type TSRMLS_CC)
        !            81: 
        !            82: ZEND_API int zend_register_resource(zval *rsrc_result, void *rsrc_pointer, int rsrc_type);
        !            83: ZEND_API void *zend_fetch_resource(zval **passed_id TSRMLS_DC, int default_id, char *resource_type_name, int *found_resource_type, int num_resource_types, ...);
        !            84: 
        !            85: ZEND_API char *zend_rsrc_list_get_rsrc_type(ulong resource TSRMLS_DC);
        !            86: ZEND_API int zend_fetch_list_dtor_id(char *type_name);
        !            87: 
        !            88: extern ZEND_API int le_index_ptr;  /* list entry type for index pointers */
        !            89: 
        !            90: #define ZEND_VERIFY_RESOURCE(rsrc)             \
        !            91:        if (!rsrc) {                                            \
        !            92:                RETURN_FALSE;                                   \
        !            93:        }
        !            94: 
        !            95: #define ZEND_FETCH_RESOURCE(rsrc, rsrc_type, passed_id, default_id, resource_type_name, resource_type) \
        !            96:        rsrc = (rsrc_type) zend_fetch_resource(passed_id TSRMLS_CC, default_id, resource_type_name, NULL, 1, resource_type);    \
        !            97:        ZEND_VERIFY_RESOURCE(rsrc);
        !            98:        
        !            99: #define ZEND_FETCH_RESOURCE_NO_RETURN(rsrc, rsrc_type, passed_id, default_id, resource_type_name, resource_type)       \
        !           100:        (rsrc = (rsrc_type) zend_fetch_resource(passed_id TSRMLS_CC, default_id, resource_type_name, NULL, 1, resource_type))
        !           101: 
        !           102: #define ZEND_FETCH_RESOURCE2(rsrc, rsrc_type, passed_id, default_id, resource_type_name, resource_type1, resource_type2)       \
        !           103:        rsrc = (rsrc_type) zend_fetch_resource(passed_id TSRMLS_CC, default_id, resource_type_name, NULL, 2, resource_type1, resource_type2);   \
        !           104:        ZEND_VERIFY_RESOURCE(rsrc);
        !           105:        
        !           106: #define ZEND_FETCH_RESOURCE2_NO_RETURN(rsrc, rsrc_type, passed_id, default_id, resource_type_name, resource_type1, resource_type2)     \
        !           107:        (rsrc = (rsrc_type) zend_fetch_resource(passed_id TSRMLS_CC, default_id, resource_type_name, NULL, 2, resource_type1, resource_type2))
        !           108: 
        !           109: #define ZEND_REGISTER_RESOURCE(rsrc_result, rsrc_pointer, rsrc_type)  \
        !           110:     zend_register_resource(rsrc_result, rsrc_pointer, rsrc_type);
        !           111: 
        !           112: #define ZEND_GET_RESOURCE_TYPE_ID(le_id, le_type_name) \
        !           113:     if (le_id == 0) {                                  \
        !           114:         le_id = zend_fetch_list_dtor_id(le_type_name); \
        !           115:        }
        !           116: END_EXTERN_C()
        !           117: 
        !           118: #endif
        !           119: 
        !           120: /*
        !           121:  * Local variables:
        !           122:  * tab-width: 4
        !           123:  * c-basic-offset: 4
        !           124:  * indent-tabs-mode: t
        !           125:  * End:
        !           126:  */

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>