mirror of
https://github.com/php/php-src.git
synced 2024-12-16 21:37:49 +08:00
bf1cfc0753
Cf. <https://github.com/php/php-src/pull/10220#issuecomment-1383739816>. This reverts commit68ada76f9a. his reverts commit45384c6e20. This reverts commitef7fbfd710. This reverts commit9b9ea0d7c6. This reverts commitf15747c26b. This reverts commite883ba93c4. This reverts commit7e87551c37. This reverts commit921274d2b8. This reverts commitfc1f528e5e. This reverts commit0961715cda. This reverts commita93f264526. This reverts commit72dd94e1c6. This reverts commit29b2dc8964. This reverts commit05c7653bba. This reverts commit5190e5c260. This reverts commit6b55bf228c. This reverts commit184b4a12d3. This reverts commit4c31b7888a. This reverts commitd44e9680f0. This reverts commit4069a5c43f.
92 lines
3.7 KiB
C
92 lines
3.7 KiB
C
/*
|
|
+----------------------------------------------------------------------+
|
|
| Zend Engine |
|
|
+----------------------------------------------------------------------+
|
|
| Copyright (c) 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. |
|
|
+----------------------------------------------------------------------+
|
|
| Author: Wez Furlong <wez@thebrainroom.com> |
|
|
| Marcus Boerger <helly@php.net> |
|
|
+----------------------------------------------------------------------+
|
|
*/
|
|
|
|
/* These iterators were designed to operate within the foreach()
|
|
* structures provided by the engine, but could be extended for use
|
|
* with other iterative engine opcodes.
|
|
* These methods have similar semantics to the zend_hash API functions
|
|
* with similar names.
|
|
* */
|
|
|
|
typedef struct _zend_object_iterator zend_object_iterator;
|
|
|
|
typedef struct _zend_object_iterator_funcs {
|
|
/* release all resources associated with this iterator instance */
|
|
void (*dtor)(zend_object_iterator *iter);
|
|
|
|
/* check for end of iteration (FAILURE or SUCCESS if data is valid) */
|
|
int (*valid)(zend_object_iterator *iter);
|
|
|
|
/* fetch the item data for the current element */
|
|
zval *(*get_current_data)(zend_object_iterator *iter);
|
|
|
|
/* fetch the key for the current element (optional, may be NULL). The key
|
|
* should be written into the provided zval* using the ZVAL_* macros. If
|
|
* this handler is not provided auto-incrementing integer keys will be
|
|
* used. */
|
|
void (*get_current_key)(zend_object_iterator *iter, zval *key);
|
|
|
|
/* step forwards to next element */
|
|
void (*move_forward)(zend_object_iterator *iter);
|
|
|
|
/* rewind to start of data (optional, may be NULL) */
|
|
void (*rewind)(zend_object_iterator *iter);
|
|
|
|
/* invalidate current value/key (optional, may be NULL) */
|
|
void (*invalidate_current)(zend_object_iterator *iter);
|
|
|
|
/* Expose owned values to GC.
|
|
* This has the same semantics as the corresponding object handler. */
|
|
HashTable *(*get_gc)(zend_object_iterator *iter, zval **table, int *n);
|
|
} zend_object_iterator_funcs;
|
|
|
|
struct _zend_object_iterator {
|
|
zend_object std;
|
|
zval data;
|
|
const zend_object_iterator_funcs *funcs;
|
|
zend_ulong index; /* private to fe_reset/fe_fetch opcodes */
|
|
};
|
|
|
|
typedef struct _zend_class_iterator_funcs {
|
|
zend_function *zf_new_iterator;
|
|
zend_function *zf_valid;
|
|
zend_function *zf_current;
|
|
zend_function *zf_key;
|
|
zend_function *zf_next;
|
|
zend_function *zf_rewind;
|
|
} zend_class_iterator_funcs;
|
|
|
|
typedef struct _zend_class_arrayaccess_funcs {
|
|
zend_function *zf_offsetget;
|
|
zend_function *zf_offsetexists;
|
|
zend_function *zf_offsetset;
|
|
zend_function *zf_offsetunset;
|
|
} zend_class_arrayaccess_funcs;
|
|
|
|
BEGIN_EXTERN_C()
|
|
/* given a zval, returns stuff that can be used to iterate it. */
|
|
ZEND_API zend_object_iterator* zend_iterator_unwrap(zval *array_ptr);
|
|
|
|
/* given an iterator, wrap it up as a zval for use by the engine opcodes */
|
|
ZEND_API void zend_iterator_init(zend_object_iterator *iter);
|
|
ZEND_API void zend_iterator_dtor(zend_object_iterator *iter);
|
|
|
|
ZEND_API void zend_register_iterator_wrapper(void);
|
|
END_EXTERN_C()
|