xref: /PHP-7.2/ext/json/php_json.h (revision 7a7ec01a)
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   | Author: Omar Kilani <omar@php.net>                                   |
16   |         Jakub Zelenka <bukka@php.net>                                |
17   +----------------------------------------------------------------------+
18 */
19 
20 #ifndef PHP_JSON_H
21 #define PHP_JSON_H
22 
23 #define PHP_JSON_VERSION "1.6.0"
24 #include "zend_smart_str_public.h"
25 
26 extern zend_module_entry json_module_entry;
27 #define phpext_json_ptr &json_module_entry
28 
29 #if defined(PHP_WIN32) && defined(JSON_EXPORTS)
30 #define PHP_JSON_API __declspec(dllexport)
31 #else
32 #define PHP_JSON_API PHPAPI
33 #endif
34 
35 #ifdef ZTS
36 #include "TSRM.h"
37 #endif
38 
39 extern PHP_JSON_API zend_class_entry *php_json_serializable_ce;
40 
41 /* error codes */
42 typedef enum {
43 	PHP_JSON_ERROR_NONE = 0,
44 	PHP_JSON_ERROR_DEPTH,
45 	PHP_JSON_ERROR_STATE_MISMATCH,
46 	PHP_JSON_ERROR_CTRL_CHAR,
47 	PHP_JSON_ERROR_SYNTAX,
48 	PHP_JSON_ERROR_UTF8,
49 	PHP_JSON_ERROR_RECURSION,
50 	PHP_JSON_ERROR_INF_OR_NAN,
51 	PHP_JSON_ERROR_UNSUPPORTED_TYPE,
52 	PHP_JSON_ERROR_INVALID_PROPERTY_NAME,
53 	PHP_JSON_ERROR_UTF16
54 } php_json_error_code;
55 
56 /* json_decode() options */
57 #define PHP_JSON_OBJECT_AS_ARRAY            (1<<0)
58 #define PHP_JSON_BIGINT_AS_STRING           (1<<1)
59 
60 /* json_encode() options */
61 #define PHP_JSON_HEX_TAG                    (1<<0)
62 #define PHP_JSON_HEX_AMP                    (1<<1)
63 #define PHP_JSON_HEX_APOS                   (1<<2)
64 #define PHP_JSON_HEX_QUOT                   (1<<3)
65 #define PHP_JSON_FORCE_OBJECT               (1<<4)
66 #define PHP_JSON_NUMERIC_CHECK              (1<<5)
67 #define PHP_JSON_UNESCAPED_SLASHES          (1<<6)
68 #define PHP_JSON_PRETTY_PRINT               (1<<7)
69 #define PHP_JSON_UNESCAPED_UNICODE          (1<<8)
70 #define PHP_JSON_PARTIAL_OUTPUT_ON_ERROR    (1<<9)
71 #define PHP_JSON_PRESERVE_ZERO_FRACTION     (1<<10)
72 #define PHP_JSON_UNESCAPED_LINE_TERMINATORS (1<<11)
73 
74 /* json_decode() and json_encode() common options */
75 #define PHP_JSON_INVALID_UTF8_IGNORE        (1<<20)
76 #define PHP_JSON_INVALID_UTF8_SUBSTITUTE    (1<<21)
77 
78 /* Internal flags */
79 #define PHP_JSON_OUTPUT_ARRAY	0
80 #define PHP_JSON_OUTPUT_OBJECT	1
81 
82 /* default depth */
83 #define PHP_JSON_PARSER_DEFAULT_DEPTH 512
84 
85 ZEND_BEGIN_MODULE_GLOBALS(json)
86 	int encoder_depth;
87 	int encode_max_depth;
88 	php_json_error_code error_code;
89 ZEND_END_MODULE_GLOBALS(json)
90 
91 PHP_JSON_API ZEND_EXTERN_MODULE_GLOBALS(json)
92 #define JSON_G(v) ZEND_MODULE_GLOBALS_ACCESSOR(json, v)
93 
94 #if defined(ZTS) && defined(COMPILE_DL_JSON)
95 ZEND_TSRMLS_CACHE_EXTERN()
96 #endif
97 
98 PHP_JSON_API int php_json_encode_ex(smart_str *buf, zval *val, int options, zend_long depth);
99 PHP_JSON_API int php_json_encode(smart_str *buf, zval *val, int options);
100 PHP_JSON_API int php_json_decode_ex(zval *return_value, char *str, size_t str_len, zend_long options, zend_long depth);
101 
php_json_decode(zval * return_value,char * str,int str_len,zend_bool assoc,zend_long depth)102 static inline int php_json_decode(zval *return_value, char *str, int str_len, zend_bool assoc, zend_long depth)
103 {
104 	return php_json_decode_ex(return_value, str, str_len, assoc ? PHP_JSON_OBJECT_AS_ARRAY : 0, depth);
105 }
106 
107 #endif  /* PHP_JSON_H */
108 
109 /*
110  * Local variables:
111  * tab-width: 4
112  * c-basic-offset: 4
113  * End:
114  * vim600: noet sw=4 ts=4 fdm=marker
115  * vim<600: noet sw=4 ts=4
116  */
117