xref: /PHP-7.4/Zend/zend_interfaces.h (revision 92ac598a)
1 /*
2    +----------------------------------------------------------------------+
3    | Zend Engine                                                          |
4    +----------------------------------------------------------------------+
5    | Copyright (c) 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: Marcus Boerger <helly@php.net>                              |
16    +----------------------------------------------------------------------+
17 */
18 
19 #ifndef ZEND_INTERFACES_H
20 #define ZEND_INTERFACES_H
21 
22 #include "zend.h"
23 #include "zend_API.h"
24 
25 BEGIN_EXTERN_C()
26 
27 extern ZEND_API zend_class_entry *zend_ce_traversable;
28 extern ZEND_API zend_class_entry *zend_ce_aggregate;
29 extern ZEND_API zend_class_entry *zend_ce_iterator;
30 extern ZEND_API zend_class_entry *zend_ce_arrayaccess;
31 extern ZEND_API zend_class_entry *zend_ce_serializable;
32 extern ZEND_API zend_class_entry *zend_ce_countable;
33 
34 typedef struct _zend_user_iterator {
35 	zend_object_iterator     it;
36 	zend_class_entry         *ce;
37 	zval                     value;
38 } zend_user_iterator;
39 
40 ZEND_API zval* zend_call_method(zval *object_pp, zend_class_entry *obj_ce, zend_function **fn_proxy, const char *function_name, size_t function_name_len, zval *retval, int param_count, zval* arg1, zval* arg2);
41 
42 #define zend_call_method_with_0_params(obj, obj_ce, fn_proxy, function_name, retval) \
43 	zend_call_method(obj, obj_ce, fn_proxy, function_name, sizeof(function_name)-1, retval, 0, NULL, NULL)
44 
45 #define zend_call_method_with_1_params(obj, obj_ce, fn_proxy, function_name, retval, arg1) \
46 	zend_call_method(obj, obj_ce, fn_proxy, function_name, sizeof(function_name)-1, retval, 1, arg1, NULL)
47 
48 #define zend_call_method_with_2_params(obj, obj_ce, fn_proxy, function_name, retval, arg1, arg2) \
49 	zend_call_method(obj, obj_ce, fn_proxy, function_name, sizeof(function_name)-1, retval, 2, arg1, arg2)
50 
51 #define REGISTER_MAGIC_INTERFACE(class_name, class_name_str) \
52 	{\
53 		zend_class_entry ce;\
54 		INIT_CLASS_ENTRY(ce, # class_name_str, zend_funcs_ ## class_name) \
55 		zend_ce_ ## class_name = zend_register_internal_interface(&ce);\
56 		zend_ce_ ## class_name->interface_gets_implemented = zend_implement_ ## class_name;\
57 	}
58 
59 #define REGISTER_MAGIC_IMPLEMENT(class_name, interface_name) \
60 	zend_class_implements(zend_ce_ ## class_name, 1, zend_ce_ ## interface_name)
61 
62 ZEND_API void zend_user_it_rewind(zend_object_iterator *_iter);
63 ZEND_API int zend_user_it_valid(zend_object_iterator *_iter);
64 ZEND_API void zend_user_it_get_current_key(zend_object_iterator *_iter, zval *key);
65 ZEND_API zval *zend_user_it_get_current_data(zend_object_iterator *_iter);
66 ZEND_API void zend_user_it_move_forward(zend_object_iterator *_iter);
67 ZEND_API void zend_user_it_invalidate_current(zend_object_iterator *_iter);
68 
69 ZEND_API void zend_user_it_new_iterator(zend_class_entry *ce, zval *object, zval *iterator);
70 ZEND_API zend_object_iterator *zend_user_it_get_new_iterator(zend_class_entry *ce, zval *object, int by_ref);
71 
72 ZEND_API void zend_register_interfaces(void);
73 
74 ZEND_API int zend_user_serialize(zval *object, unsigned char **buffer, size_t *buf_len, zend_serialize_data *data);
75 ZEND_API int zend_user_unserialize(zval *object, zend_class_entry *ce, const unsigned char *buf, size_t buf_len, zend_unserialize_data *data);
76 
77 ZEND_API int zend_class_serialize_deny(zval *object, unsigned char **buffer, size_t *buf_len, zend_serialize_data *data);
78 ZEND_API int zend_class_unserialize_deny(zval *object, zend_class_entry *ce, const unsigned char *buf, size_t buf_len, zend_unserialize_data *data);
79 
80 END_EXTERN_C()
81 
82 #endif /* ZEND_INTERFACES_H */
83