spl_iterators.h 5.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187
  1. /*
  2. +----------------------------------------------------------------------+
  3. | PHP Version 7 |
  4. +----------------------------------------------------------------------+
  5. | Copyright (c) 1997-2018 The PHP Group |
  6. +----------------------------------------------------------------------+
  7. | This source file is subject to version 3.01 of the PHP 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.php.net/license/3_01.txt |
  11. | If you did not receive a copy of the PHP license and are unable to |
  12. | obtain it through the world-wide-web, please send a note to |
  13. | license@php.net so we can mail you a copy immediately. |
  14. +----------------------------------------------------------------------+
  15. | Authors: Marcus Boerger <helly@php.net> |
  16. +----------------------------------------------------------------------+
  17. */
  18. #ifndef SPL_ITERATORS_H
  19. #define SPL_ITERATORS_H
  20. #include "php.h"
  21. #include "php_spl.h"
  22. #if HAVE_PCRE || HAVE_BUNDLED_PCRE
  23. #include "ext/pcre/php_pcre.h"
  24. #endif
  25. #define spl_ce_Traversable zend_ce_traversable
  26. #define spl_ce_Iterator zend_ce_iterator
  27. #define spl_ce_Aggregate zend_ce_aggregate
  28. #define spl_ce_ArrayAccess zend_ce_arrayaccess
  29. #define spl_ce_Serializable zend_ce_serializable
  30. #define spl_ce_Countable zend_ce_countable
  31. extern PHPAPI zend_class_entry *spl_ce_RecursiveIterator;
  32. extern PHPAPI zend_class_entry *spl_ce_RecursiveIteratorIterator;
  33. extern PHPAPI zend_class_entry *spl_ce_RecursiveTreeIterator;
  34. extern PHPAPI zend_class_entry *spl_ce_FilterIterator;
  35. extern PHPAPI zend_class_entry *spl_ce_RecursiveFilterIterator;
  36. extern PHPAPI zend_class_entry *spl_ce_ParentIterator;
  37. extern PHPAPI zend_class_entry *spl_ce_SeekableIterator;
  38. extern PHPAPI zend_class_entry *spl_ce_LimitIterator;
  39. extern PHPAPI zend_class_entry *spl_ce_CachingIterator;
  40. extern PHPAPI zend_class_entry *spl_ce_RecursiveCachingIterator;
  41. extern PHPAPI zend_class_entry *spl_ce_OuterIterator;
  42. extern PHPAPI zend_class_entry *spl_ce_IteratorIterator;
  43. extern PHPAPI zend_class_entry *spl_ce_NoRewindIterator;
  44. extern PHPAPI zend_class_entry *spl_ce_InfiniteIterator;
  45. extern PHPAPI zend_class_entry *spl_ce_EmptyIterator;
  46. extern PHPAPI zend_class_entry *spl_ce_AppendIterator;
  47. extern PHPAPI zend_class_entry *spl_ce_RegexIterator;
  48. extern PHPAPI zend_class_entry *spl_ce_RecursiveRegexIterator;
  49. extern PHPAPI zend_class_entry *spl_ce_CallbackFilterIterator;
  50. extern PHPAPI zend_class_entry *spl_ce_RecursiveCallbackFilterIterator;
  51. PHP_MINIT_FUNCTION(spl_iterators);
  52. PHP_FUNCTION(iterator_to_array);
  53. PHP_FUNCTION(iterator_count);
  54. PHP_FUNCTION(iterator_apply);
  55. typedef enum {
  56. DIT_Default = 0,
  57. DIT_FilterIterator = DIT_Default,
  58. DIT_RecursiveFilterIterator = DIT_Default,
  59. DIT_ParentIterator = DIT_Default,
  60. DIT_LimitIterator,
  61. DIT_CachingIterator,
  62. DIT_RecursiveCachingIterator,
  63. DIT_IteratorIterator,
  64. DIT_NoRewindIterator,
  65. DIT_InfiniteIterator,
  66. DIT_AppendIterator,
  67. #if HAVE_PCRE || HAVE_BUNDLED_PCRE
  68. DIT_RegexIterator,
  69. DIT_RecursiveRegexIterator,
  70. #endif
  71. DIT_CallbackFilterIterator,
  72. DIT_RecursiveCallbackFilterIterator,
  73. DIT_Unknown = ~0
  74. } dual_it_type;
  75. typedef enum {
  76. RIT_Default = 0,
  77. RIT_RecursiveIteratorIterator = RIT_Default,
  78. RIT_RecursiveTreeIterator,
  79. RIT_Unknow = ~0
  80. } recursive_it_it_type;
  81. enum {
  82. /* public */
  83. CIT_CALL_TOSTRING = 0x00000001,
  84. CIT_TOSTRING_USE_KEY = 0x00000002,
  85. CIT_TOSTRING_USE_CURRENT = 0x00000004,
  86. CIT_TOSTRING_USE_INNER = 0x00000008,
  87. CIT_CATCH_GET_CHILD = 0x00000010,
  88. CIT_FULL_CACHE = 0x00000100,
  89. CIT_PUBLIC = 0x0000FFFF,
  90. /* private */
  91. CIT_VALID = 0x00010000,
  92. CIT_HAS_CHILDREN = 0x00020000
  93. };
  94. enum {
  95. /* public */
  96. REGIT_USE_KEY = 0x00000001,
  97. REGIT_INVERTED = 0x00000002
  98. };
  99. typedef enum {
  100. REGIT_MODE_MATCH,
  101. REGIT_MODE_GET_MATCH,
  102. REGIT_MODE_ALL_MATCHES,
  103. REGIT_MODE_SPLIT,
  104. REGIT_MODE_REPLACE,
  105. REGIT_MODE_MAX
  106. } regex_mode;
  107. typedef struct _spl_cbfilter_it_intern {
  108. zend_fcall_info fci;
  109. zend_fcall_info_cache fcc;
  110. zend_object *object;
  111. } _spl_cbfilter_it_intern;
  112. typedef struct _spl_dual_it_object {
  113. struct {
  114. zval zobject;
  115. zend_class_entry *ce;
  116. zend_object *object;
  117. zend_object_iterator *iterator;
  118. } inner;
  119. struct {
  120. zval data;
  121. zval key;
  122. zend_long pos;
  123. } current;
  124. dual_it_type dit_type;
  125. union {
  126. struct {
  127. zend_long offset;
  128. zend_long count;
  129. } limit;
  130. struct {
  131. zend_long flags; /* CIT_* */
  132. zval zstr;
  133. zval zchildren;
  134. zval zcache;
  135. } caching;
  136. struct {
  137. zval zarrayit;
  138. zend_object_iterator *iterator;
  139. } append;
  140. #if HAVE_PCRE || HAVE_BUNDLED_PCRE
  141. struct {
  142. zend_long flags;
  143. zend_long preg_flags;
  144. pcre_cache_entry *pce;
  145. zend_string *regex;
  146. regex_mode mode;
  147. int use_flags;
  148. } regex;
  149. #endif
  150. _spl_cbfilter_it_intern *cbfilter;
  151. } u;
  152. zend_object std;
  153. } spl_dual_it_object;
  154. static inline spl_dual_it_object *spl_dual_it_from_obj(zend_object *obj) /* {{{ */ {
  155. return (spl_dual_it_object*)((char*)(obj) - XtOffsetOf(spl_dual_it_object, std));
  156. } /* }}} */
  157. #define Z_SPLDUAL_IT_P(zv) spl_dual_it_from_obj(Z_OBJ_P((zv)))
  158. typedef int (*spl_iterator_apply_func_t)(zend_object_iterator *iter, void *puser);
  159. PHPAPI int spl_iterator_apply(zval *obj, spl_iterator_apply_func_t apply_func, void *puser);
  160. #endif /* SPL_ITERATORS_H */
  161. /*
  162. * Local Variables:
  163. * c-basic-offset: 4
  164. * tab-width: 4
  165. * End:
  166. * vim600: fdm=marker
  167. * vim: noet sw=4 ts=4
  168. */