1 /* 2 +----------------------------------------------------------------------+ 3 | Zend Engine | 4 +----------------------------------------------------------------------+ 5 | Copyright (c) 1998-2013 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 | Author: Wez Furlong <wez@thebrainroom.com> | 16 | Marcus Boerger <helly@php.net> | 17 +----------------------------------------------------------------------+ 18 */ 19 20 /* $Id$ */ 21 22 /* These iterators were designed to operate within the foreach() 23 * structures provided by the engine, but could be extended for use 24 * with other iterative engine opcodes. 25 * These methods have similar semantics to the zend_hash API functions 26 * with similar names. 27 * */ 28 29 typedef struct _zend_object_iterator zend_object_iterator; 30 31 typedef struct _zend_object_iterator_funcs { 32 /* release all resources associated with this iterator instance */ 33 void (*dtor)(zend_object_iterator *iter TSRMLS_DC); 34 35 /* check for end of iteration (FAILURE or SUCCESS if data is valid) */ 36 int (*valid)(zend_object_iterator *iter TSRMLS_DC); 37 38 /* fetch the item data for the current element */ 39 void (*get_current_data)(zend_object_iterator *iter, zval ***data TSRMLS_DC); 40 41 /* fetch the key for the current element (return HASH_KEY_IS_STRING or HASH_KEY_IS_LONG) (optional, may be NULL) */ 42 int (*get_current_key)(zend_object_iterator *iter, char **str_key, uint *str_key_len, ulong *int_key TSRMLS_DC); 43 44 /* step forwards to next element */ 45 void (*move_forward)(zend_object_iterator *iter TSRMLS_DC); 46 47 /* rewind to start of data (optional, may be NULL) */ 48 void (*rewind)(zend_object_iterator *iter TSRMLS_DC); 49 50 /* invalidate current value/key (optional, may be NULL) */ 51 void (*invalidate_current)(zend_object_iterator *iter TSRMLS_DC); 52 } zend_object_iterator_funcs; 53 54 struct _zend_object_iterator { 55 void *data; 56 zend_object_iterator_funcs *funcs; 57 ulong index; /* private to fe_reset/fe_fetch opcodes */ 58 }; 59 60 typedef struct _zend_class_iterator_funcs { 61 zend_object_iterator_funcs *funcs; 62 union _zend_function *zf_new_iterator; 63 union _zend_function *zf_valid; 64 union _zend_function *zf_current; 65 union _zend_function *zf_key; 66 union _zend_function *zf_next; 67 union _zend_function *zf_rewind; 68 } zend_class_iterator_funcs; 69 70 enum zend_object_iterator_kind { 71 ZEND_ITER_INVALID, 72 ZEND_ITER_PLAIN_ARRAY, 73 ZEND_ITER_PLAIN_OBJECT, 74 ZEND_ITER_OBJECT 75 }; 76 77 BEGIN_EXTERN_C() 78 /* given a zval, returns stuff that can be used to iterate it. */ 79 ZEND_API enum zend_object_iterator_kind zend_iterator_unwrap(zval *array_ptr, zend_object_iterator **iter TSRMLS_DC); 80 81 /* given an iterator, wrap it up as a zval for use by the engine opcodes */ 82 ZEND_API zval *zend_iterator_wrap(zend_object_iterator *iter TSRMLS_DC); 83 84 ZEND_API void zend_register_iterator_wrapper(TSRMLS_D); 85 END_EXTERN_C() 86 87 /* 88 * Local variables: 89 * tab-width: 4 90 * c-basic-offset: 4 91 * indent-tabs-mode: t 92 * End: 93 */ 94