php-src/Zend/zend_variables.h

/*
   +----------------------------------------------------------------------+
   | Zend Engine                                                          |
   +----------------------------------------------------------------------+
   | Copyright (c) 1998-2012 Zend Technologies Ltd. (http://www.zend.com) |
   +----------------------------------------------------------------------+
   | This source file is subject to version 2.00 of the Zend license,     |
   | that is bundled with this package in the file LICENSE, and is        | 
   | available through the world-wide-web at the following url:           |
   | http://www.zend.com/license/2_00.txt.                                |
   | If you did not receive a copy of the Zend license and are unable to  |
   | obtain it through the world-wide-web, please send a note to          |
   | license@zend.com so we can mail you a copy immediately.              |
   +----------------------------------------------------------------------+
   | Authors: Andi Gutmans <andi@zend.com>                                |
   |          Zeev Suraski <zeev@zend.com>                                |
   +----------------------------------------------------------------------+
*/

/* $Id$ */

#ifndef ZEND_VARIABLES_H
#define ZEND_VARIABLES_H


BEGIN_EXTERN_C()

ZEND_API void _zval_dtor_func(zval *zvalue ZEND_FILE_LINE_DC);

static inline void _zval_dtor(zval *zvalue ZEND_FILE_LINE_DC)
{
	if (zvalue->type <= IS_BOOL) {
		return;
	}
	_zval_dtor_func(zvalue ZEND_FILE_LINE_RELAY_CC);
}

ZEND_API void _zval_copy_ctor_func(zval *zvalue ZEND_FILE_LINE_DC);

static inline void _zval_copy_ctor(zval *zvalue ZEND_FILE_LINE_DC)
{
	if (zvalue->type <= IS_BOOL) {
		return;
	}
	_zval_copy_ctor_func(zvalue ZEND_FILE_LINE_RELAY_CC);
}


ZEND_API int zend_print_variable(zval *var);
ZEND_API void _zval_ptr_dtor(zval **zval_ptr ZEND_FILE_LINE_DC);
ZEND_API void _zval_internal_dtor(zval *zvalue ZEND_FILE_LINE_DC);
ZEND_API void _zval_internal_ptr_dtor(zval **zvalue ZEND_FILE_LINE_DC);
ZEND_API void _zval_dtor_wrapper(zval *zvalue);
#define zval_copy_ctor(zvalue) _zval_copy_ctor((zvalue) ZEND_FILE_LINE_CC)
#define zval_dtor(zvalue) _zval_dtor((zvalue) ZEND_FILE_LINE_CC)
#define zval_ptr_dtor(zval_ptr) _zval_ptr_dtor((zval_ptr) ZEND_FILE_LINE_CC)
#define zval_internal_dtor(zvalue) _zval_internal_dtor((zvalue) ZEND_FILE_LINE_CC)
#define zval_internal_ptr_dtor(zvalue) _zval_internal_ptr_dtor((zvalue) ZEND_FILE_LINE_CC)
#define zval_dtor_wrapper _zval_dtor_wrapper

#if ZEND_DEBUG
ZEND_API void _zval_copy_ctor_wrapper(zval *zvalue);
ZEND_API void _zval_ptr_dtor_wrapper(zval **zval_ptr);
ZEND_API void _zval_internal_dtor_wrapper(zval *zvalue);
ZEND_API void _zval_internal_ptr_dtor_wrapper(zval **zvalue);
#define zval_copy_ctor_wrapper _zval_copy_ctor_wrapper
#define zval_ptr_dtor_wrapper _zval_ptr_dtor_wrapper
#define zval_internal_dtor_wrapper _zval_internal_dtor_wrapper
#define zval_internal_ptr_dtor_wrapper _zval_internal_ptr_dtor_wrapper
#else
#define zval_copy_ctor_wrapper _zval_copy_ctor_func
#define zval_ptr_dtor_wrapper _zval_ptr_dtor
#define zval_internal_dtor_wrapper _zval_internal_dtor
#define zval_internal_ptr_dtor_wrapper _zval_internal_ptr_dtor
#endif

ZEND_API void zval_add_ref(zval **p);

ZEND_API void zval_property_ctor(zval **);

#ifdef ZTS
# define zval_shared_property_ctor zval_property_ctor
#else
# define zval_shared_property_ctor zval_add_ref
#endif

#define zval_copy_property_ctor(ce) ((copy_ctor_func_t) (((ce)->type == ZEND_INTERNAL_CLASS) ? zval_shared_property_ctor : zval_add_ref))


END_EXTERN_C()

#define ZVAL_DESTRUCTOR (void (*)(void *)) zval_dtor_wrapper
#define ZVAL_PTR_DTOR (void (*)(void *)) zval_ptr_dtor_wrapper
#define ZVAL_INTERNAL_DTOR (void (*)(void *)) zval_internal_dtor_wrapper
#define ZVAL_INTERNAL_PTR_DTOR (void (*)(void *)) zval_internal_ptr_dtor_wrapper
#define ZVAL_COPY_CTOR (void (*)(void *)) zval_copy_ctor_wrapper

#endif

/*
 * Local variables:
 * tab-width: 4
 * c-basic-offset: 4
 * indent-tabs-mode: t
 * End:
 */
Zend Library 1999-04-08 02:10:10 +08:00			`/*`
			`+----------------------------------------------------------------------+`
			`\| Zend Engine \|`
			`+----------------------------------------------------------------------+`
- Year++ 2012-01-01 21:15:04 +08:00			`\| Copyright (c) 1998-2012 Zend Technologies Ltd. (http://www.zend.com) \|`
Zend Library 1999-04-08 02:10:10 +08:00			`+----------------------------------------------------------------------+`
Update headers. 2001-12-11 23:16:21 +08:00			`\| This source file is subject to version 2.00 of the Zend license, \|`
License update 1999-07-16 22:58:16 +08:00			`\| that is bundled with this package in the file LICENSE, and is \|`
updating license information in the headers. 2003-06-11 04:04:29 +08:00			`\| available through the world-wide-web at the following url: \|`
Update headers. 2001-12-11 23:16:21 +08:00			`\| http://www.zend.com/license/2_00.txt. \|`
License update 1999-07-16 22:58:16 +08:00			`\| If you did not receive a copy of the Zend license and are unable to \|`
			`\| obtain it through the world-wide-web, please send a note to \|`
			`\| license@zend.com so we can mail you a copy immediately. \|`
Zend Library 1999-04-08 02:10:10 +08:00			`+----------------------------------------------------------------------+`
			`\| Authors: Andi Gutmans <andi@zend.com> \|`
- Fix the header (thanks Johannes) 2008-07-20 23:10:24 +08:00			`\| Zeev Suraski <zeev@zend.com> \|`
Zend Library 1999-04-08 02:10:10 +08:00			`+----------------------------------------------------------------------+`
			`*/`

- Added some missing CVS $Id$ tags, headers and footers. 2003-02-01 09:49:15 +08:00			`/* $Id$ */`
License update 1999-07-16 22:58:16 +08:00
Replace macros which begin with an underscore through an appropiately named macro. 2000-07-03 08:55:36 +08:00			`#ifndef ZEND_VARIABLES_H`
			`#define ZEND_VARIABLES_H`
Zend Library 1999-04-08 02:10:10 +08:00

Ok, call me crazy, because I probably am. Thread safe version now uses a C++ scanner object. Works fully. 1999-04-23 11:32:33 +08:00			`BEGIN_EXTERN_C()`
- Apply Thies and Sterling's patch which doesn't call ctor/dtor functions - for types which don't require it (BOOL/NULL/LONG/DOUBLE) - Breaks serialization!!! 2004-09-27 04:03:54 +08:00
			`ZEND_API void _zval_dtor_func(zval *zvalue ZEND_FILE_LINE_DC);`

			`static inline void _zval_dtor(zval *zvalue ZEND_FILE_LINE_DC)`
			`{`
- WS fix 2008-07-20 20:47:34 +08:00			`if (zvalue->type <= IS_BOOL) {`
			`return;`
			`}`
MFH:- Fix compile warning in debug mode 2009-05-02 05:46:53 +08:00			`_zval_dtor_func(zvalue ZEND_FILE_LINE_RELAY_CC);`
- Apply Thies and Sterling's patch which doesn't call ctor/dtor functions - for types which don't require it (BOOL/NULL/LONG/DOUBLE) - Breaks serialization!!! 2004-09-27 04:03:54 +08:00			`}`

- Make zval_copy_ctor() return void like dtor(). No one ever checks the - return value which is SUCCESS always. 2004-09-27 10:29:01 +08:00			`ZEND_API void _zval_copy_ctor_func(zval *zvalue ZEND_FILE_LINE_DC);`
- Apply Thies and Sterling's patch which doesn't call ctor/dtor functions - for types which don't require it (BOOL/NULL/LONG/DOUBLE) - Breaks serialization!!! 2004-09-27 04:03:54 +08:00
- Make zval_copy_ctor() return void like dtor(). No one ever checks the - return value which is SUCCESS always. 2004-09-27 10:29:01 +08:00			`static inline void _zval_copy_ctor(zval *zvalue ZEND_FILE_LINE_DC)`
- Apply Thies and Sterling's patch which doesn't call ctor/dtor functions - for types which don't require it (BOOL/NULL/LONG/DOUBLE) - Breaks serialization!!! 2004-09-27 04:03:54 +08:00			`{`
- WS fix 2008-07-20 20:47:34 +08:00			`if (zvalue->type <= IS_BOOL) {`
			`return;`
			`}`
MFH:- Fix compile warning in debug mode 2009-05-02 05:46:53 +08:00			`_zval_copy_ctor_func(zvalue ZEND_FILE_LINE_RELAY_CC);`
- Apply Thies and Sterling's patch which doesn't call ctor/dtor functions - for types which don't require it (BOOL/NULL/LONG/DOUBLE) - Breaks serialization!!! 2004-09-27 04:03:54 +08:00			`}`


more EXTERN_C wrapping of ZEND_API prototypes 2004-02-20 16:03:27 +08:00			`ZEND_API int zend_print_variable(zval *var);`
Destructors no longer return ints, the low level problem it was intended to solve is long gone now... 2000-01-18 01:33:37 +08:00			`ZEND_API void _zval_ptr_dtor(zval **zval_ptr ZEND_FILE_LINE_DC);`
- Provide appropriate way to destroy internal zval's. - Allow internal zval's of type string and disallow complex types. - Define the default string for extensions at class level instead of ctor. 2003-08-25 01:32:47 +08:00			`ZEND_API void _zval_internal_dtor(zval *zvalue ZEND_FILE_LINE_DC);`
			`ZEND_API void _zval_internal_ptr_dtor(zval **zvalue ZEND_FILE_LINE_DC);`
Fixed bug #50519 (segfault in garbage collection when using set_error_handler and DomDocument) 2010-01-11 18:07:10 +08:00			`ZEND_API void _zval_dtor_wrapper(zval *zvalue);`
Better debug macros 1999-08-28 03:17:19 +08:00			`#define zval_copy_ctor(zvalue) _zval_copy_ctor((zvalue) ZEND_FILE_LINE_CC)`
			`#define zval_dtor(zvalue) _zval_dtor((zvalue) ZEND_FILE_LINE_CC)`
			`#define zval_ptr_dtor(zval_ptr) _zval_ptr_dtor((zval_ptr) ZEND_FILE_LINE_CC)`
- Provide appropriate way to destroy internal zval's. - Allow internal zval's of type string and disallow complex types. - Define the default string for extensions at class level instead of ctor. 2003-08-25 01:32:47 +08:00			`#define zval_internal_dtor(zvalue) _zval_internal_dtor((zvalue) ZEND_FILE_LINE_CC)`
			`#define zval_internal_ptr_dtor(zvalue) _zval_internal_ptr_dtor((zvalue) ZEND_FILE_LINE_CC)`
Fixed bug #50519 (segfault in garbage collection when using set_error_handler and DomDocument) 2010-01-11 18:07:10 +08:00			`#define zval_dtor_wrapper _zval_dtor_wrapper`
Better debug macros 1999-08-28 03:17:19 +08:00
* empty log message * 1999-08-29 05:43:24 +08:00			`#if ZEND_DEBUG`
- Use zval_ctor_func() for wrapper and update the prototype to void 2004-09-27 15:04:36 +08:00			`ZEND_API void _zval_copy_ctor_wrapper(zval *zvalue);`
Destructors no longer return ints, the low level problem it was intended to solve is long gone now... 2000-01-18 01:33:37 +08:00			`ZEND_API void _zval_ptr_dtor_wrapper(zval **zval_ptr);`
- Provide appropriate way to destroy internal zval's. - Allow internal zval's of type string and disallow complex types. - Define the default string for extensions at class level instead of ctor. 2003-08-25 01:32:47 +08:00			`ZEND_API void _zval_internal_dtor_wrapper(zval *zvalue);`
			`ZEND_API void _zval_internal_ptr_dtor_wrapper(zval **zvalue);`
Better debug macros 1999-08-28 03:17:19 +08:00			`#define zval_copy_ctor_wrapper _zval_copy_ctor_wrapper`
			`#define zval_ptr_dtor_wrapper _zval_ptr_dtor_wrapper`
- Provide appropriate way to destroy internal zval's. - Allow internal zval's of type string and disallow complex types. - Define the default string for extensions at class level instead of ctor. 2003-08-25 01:32:47 +08:00			`#define zval_internal_dtor_wrapper _zval_internal_dtor_wrapper`
			`#define zval_internal_ptr_dtor_wrapper _zval_internal_ptr_dtor_wrapper`
Better debug macros 1999-08-28 03:17:19 +08:00			`#else`
- Use zval_ctor_func() for wrapper and update the prototype to void 2004-09-27 15:04:36 +08:00			`#define zval_copy_ctor_wrapper _zval_copy_ctor_func`
Better debug macros 1999-08-28 03:17:19 +08:00			`#define zval_ptr_dtor_wrapper _zval_ptr_dtor`
- Provide appropriate way to destroy internal zval's. - Allow internal zval's of type string and disallow complex types. - Define the default string for extensions at class level instead of ctor. 2003-08-25 01:32:47 +08:00			`#define zval_internal_dtor_wrapper _zval_internal_dtor`
			`#define zval_internal_ptr_dtor_wrapper _zval_internal_ptr_dtor`
Better debug macros 1999-08-28 03:17:19 +08:00			`#endif`

export zval_add-ref and zvale_del_ref 2000-04-21 22:45:10 +08:00			`ZEND_API void zval_add_ref(zval **p);`
Zend Library 1999-04-08 02:10:10 +08:00
separate properties of internal classes in ZTS mode fully, otherwise multiple threads will modify the zvals' contents without any synchronisation. 2010-08-12 15:58:14 +08:00			`ZEND_API void zval_property_ctor(zval **);`

			`#ifdef ZTS`
			`# define zval_shared_property_ctor zval_property_ctor`
			`#else`
			`# define zval_shared_property_ctor zval_add_ref`
			`#endif`

- fix cast 2010-08-13 01:28:08 +08:00			`#define zval_copy_property_ctor(ce) ((copy_ctor_func_t) (((ce)->type == ZEND_INTERNAL_CLASS) ? zval_shared_property_ctor : zval_add_ref))`
separate properties of internal classes in ZTS mode fully, otherwise multiple threads will modify the zvals' contents without any synchronisation. 2010-08-12 15:58:14 +08:00

more EXTERN_C wrapping of ZEND_API prototypes 2004-02-20 16:03:27 +08:00			`END_EXTERN_C()`

Destructors no longer return ints, the low level problem it was intended to solve is long gone now... 2000-01-18 01:33:37 +08:00			`#define ZVAL_DESTRUCTOR (void ()(void )) zval_dtor_wrapper`
			`#define ZVAL_PTR_DTOR (void ()(void )) zval_ptr_dtor_wrapper`
- Provide appropriate way to destroy internal zval's. - Allow internal zval's of type string and disallow complex types. - Define the default string for extensions at class level instead of ctor. 2003-08-25 01:32:47 +08:00			`#define ZVAL_INTERNAL_DTOR (void ()(void )) zval_internal_dtor_wrapper`
			`#define ZVAL_INTERNAL_PTR_DTOR (void ()(void )) zval_internal_ptr_dtor_wrapper`
We're using ZVAL's now. 1999-12-22 01:14:31 +08:00			`#define ZVAL_COPY_CTOR (void ()(void )) zval_copy_ctor_wrapper`
Zend Library 1999-04-08 02:10:10 +08:00
			`#endif`
- Added some missing CVS $Id$ tags, headers and footers. 2003-02-01 09:49:15 +08:00
			`/*`
			`* Local variables:`
			`* tab-width: 4`
			`* c-basic-offset: 4`
			`* indent-tabs-mode: t`
			`* End:`
			`*/`