zend_objects_API.h 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100
  1. /*
  2. +----------------------------------------------------------------------+
  3. | Zend Engine |
  4. +----------------------------------------------------------------------+
  5. | Copyright (c) 1998-2016 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: Andi Gutmans <andi@zend.com> |
  16. | Zeev Suraski <zeev@zend.com> |
  17. +----------------------------------------------------------------------+
  18. */
  19. /* $Id$ */
  20. #ifndef ZEND_OBJECTS_API_H
  21. #define ZEND_OBJECTS_API_H
  22. #include "zend.h"
  23. typedef void (*zend_objects_store_dtor_t)(void *object, zend_object_handle handle TSRMLS_DC);
  24. typedef void (*zend_objects_free_object_storage_t)(void *object TSRMLS_DC);
  25. typedef void (*zend_objects_store_clone_t)(void *object, void **object_clone TSRMLS_DC);
  26. typedef struct _zend_object_store_bucket {
  27. zend_bool destructor_called;
  28. zend_bool valid;
  29. zend_uchar apply_count;
  30. union _store_bucket {
  31. struct _store_object {
  32. void *object;
  33. zend_objects_store_dtor_t dtor;
  34. zend_objects_free_object_storage_t free_storage;
  35. zend_objects_store_clone_t clone;
  36. const zend_object_handlers *handlers;
  37. zend_uint refcount;
  38. gc_root_buffer *buffered;
  39. } obj;
  40. struct {
  41. int next;
  42. } free_list;
  43. } bucket;
  44. } zend_object_store_bucket;
  45. typedef struct _zend_objects_store {
  46. zend_object_store_bucket *object_buckets;
  47. zend_uint top;
  48. zend_uint size;
  49. int free_list_head;
  50. } zend_objects_store;
  51. /* Global store handling functions */
  52. BEGIN_EXTERN_C()
  53. ZEND_API void zend_objects_store_init(zend_objects_store *objects, zend_uint init_size);
  54. ZEND_API void zend_objects_store_call_destructors(zend_objects_store *objects TSRMLS_DC);
  55. ZEND_API void zend_objects_store_mark_destructed(zend_objects_store *objects TSRMLS_DC);
  56. ZEND_API void zend_objects_store_destroy(zend_objects_store *objects);
  57. /* Store API functions */
  58. ZEND_API zend_object_handle zend_objects_store_put(void *object, zend_objects_store_dtor_t dtor, zend_objects_free_object_storage_t storage, zend_objects_store_clone_t clone TSRMLS_DC);
  59. ZEND_API void zend_objects_store_add_ref(zval *object TSRMLS_DC);
  60. ZEND_API void zend_objects_store_del_ref(zval *object TSRMLS_DC);
  61. ZEND_API void zend_objects_store_add_ref_by_handle(zend_object_handle handle TSRMLS_DC);
  62. ZEND_API void zend_objects_store_del_ref_by_handle_ex(zend_object_handle handle, const zend_object_handlers *handlers TSRMLS_DC);
  63. static zend_always_inline void zend_objects_store_del_ref_by_handle(zend_object_handle handle TSRMLS_DC) {
  64. zend_objects_store_del_ref_by_handle_ex(handle, NULL TSRMLS_CC);
  65. }
  66. ZEND_API zend_uint zend_objects_store_get_refcount(zval *object TSRMLS_DC);
  67. ZEND_API zend_object_value zend_objects_store_clone_obj(zval *object TSRMLS_DC);
  68. ZEND_API void *zend_object_store_get_object(const zval *object TSRMLS_DC);
  69. ZEND_API void *zend_object_store_get_object_by_handle(zend_object_handle handle TSRMLS_DC);
  70. /* See comment in zend_objects_API.c before you use this */
  71. ZEND_API void zend_object_store_set_object(zval *zobject, void *object TSRMLS_DC);
  72. ZEND_API void zend_object_store_ctor_failed(zval *zobject TSRMLS_DC);
  73. ZEND_API void zend_objects_store_free_object_storage(zend_objects_store *objects TSRMLS_DC);
  74. #define ZEND_OBJECTS_STORE_HANDLERS zend_objects_store_add_ref, zend_objects_store_del_ref, zend_objects_store_clone_obj
  75. ZEND_API zval *zend_object_create_proxy(zval *object, zval *member TSRMLS_DC);
  76. ZEND_API zend_object_handlers *zend_get_std_object_handlers(void);
  77. END_EXTERN_C()
  78. #endif /* ZEND_OBJECTS_H */
  79. /*
  80. * Local variables:
  81. * tab-width: 4
  82. * c-basic-offset: 4
  83. * indent-tabs-mode: t
  84. * End:
  85. */