DAW JSON Link
Loading...
Searching...
No Matches
daw_json_switches.h
Go to the documentation of this file.
1// Copyright (c) Darrell Wright
2//
3// Distributed under the Boost Software License, Version 1.0. (See accompanying
4// file LICENSE or copy at http://www.boost.org/LICENSE_1_0.txt)
5//
6// Official repository: https://github.com/beached/daw_json_link
7//
8
9// This file will have all the preprocessor based switches that users can
10// switch. Many are controllable from cmake via commandline options too.
11
12#pragma once
13
14#include <daw/daw_consteval.h>
15#include <daw/daw_cpp_feature_check.h>
16#include <daw/daw_is_detected.h>
17#include <daw/stdinc/enable_if.h>
18
21#if defined( DAW_HAS_GCC ) and not defined( DAW_JSON_FLATTEN )
22#if not defined( DAW_NO_FLATTEN )
23#define DAW_NO_FLATTEN
24#endif
25#endif
26
27// Does json_link throw itself. Other things like constructors for the user
28// types may.
29#if defined( DAW_USE_EXCEPTIONS )
30#if defined( DAW_JSON_DONT_USE_EXCEPTIONS )
31#error Conflicting defines DAW_USE_EXCEPTIONS and DAW_JSON_DONT_USE_EXCEPTIONS
32#endif
33#if defined( DAW_DONT_USE_EXCEPTIONS )
34#error Conflicting defines DAW_USE_EXCEPTIONS and DAW_DONT_USE_EXCEPTIONS
35#endif
36#else
37#if not defined( DAW_JSON_DONT_USE_EXCEPTIONS )
38#define DAW_JSON_DONT_USE_EXCEPTIONS
39#endif
40#if not defined( DAW_DONT_USE_EXCEPTIONS )
41#define DAW_JSON_DONT_USE_EXCEPTIONS
42#endif
43#endif
44
45// Disable using guaranteed RVO to clean up after return value construction.
46// Use DAW_NO_CONSTEXPR_SCOPE_GUARD to disable constexpr scope guard.
47// DAW_HAS_CONSTEXPR_SCOPE_GUARD is defined when it is enabled and in
48// <daw/daw_scope_guard.h>
49// This has performance impacts on MSVC as on_exit_success calls
50// std::uncaught_exceptions( ) which is very slow there
51#if not defined( DAW_NO_CONSTEXPR_SCOPE_GUARD ) and \
52 not defined( DAW_JSON_ENABLE_FULL_RVO )
53#define DAW_NO_CONSTEXPR_SCOPE_GUARD
54#endif
55
56// DAW_IS_CONSTANT_EVALUATED is defined when a builtin or
57// std::is_constant_evaluated( ) is available in
58// <daw/daw_is_constant_evaluated.h>
59
60// Show extra diagnostic information like unmapped members when parsing
61// by defining DAW_JSON_PARSER_DIAGNOSTICS
62
63// DAW_CAN_CONSTANT_EVAL is used to test if we are in a constant expression
64#if defined( DAW_HAS_GCC_LIKE )
65#define DAW_CAN_CONSTANT_EVAL( ... ) \
66 ( __builtin_constant_p( __VA_ARGS__ ) == 1 )
67#else
68#define DAW_CAN_CONSTANT_EVAL( ... ) true
69#endif
70
71// If the compiler supports CNTTP types allow for strings in json data
72// contracts. Both support passing local char const[], but the type is
73// different. To keep old behaviour when using C++20, define
74// DAW_USE_CPP17_ABI
75#if not defined( DAW_USE_CPP17_ABI )
76#if defined( __cpp_nontype_template_parameter_class )
77#if not defined( DAW_JSON_CNTTP_JSON_NAME )
78#define DAW_JSON_CNTTP_JSON_NAME
79#endif
80#endif
81#if defined( __cpp_nontype_template_args )
82#if __cpp_nontype_template_args >= 201911L
83#if not defined( DAW_JSON_CNTTP_JSON_NAME )
84#define DAW_JSON_CNTTP_JSON_NAME
85#endif
86#endif
87#endif
88#if DAW_HAS_CLANG_VER_GTE( 12, 0 ) and DAW_CPP_VERSION >= 202002L
89// Clang 12 supports enough of CNTTP string literals and compiles the tests
90// successfully, but does not define the feature macro
91#if not defined( DAW_JSON_CNTTP_JSON_NAME )
92#define DAW_JSON_CNTTP_JSON_NAME
93#endif
94#endif
95#endif
96
97#if defined( __cpp_constexpr_dynamic_alloc )
98#define CPP20CONSTEXPR constexpr
99#else
100// TODO: rename in v4
101#define CPP20CONSTEXPR
102#endif
103
104// Fix bug in MSVC
105#if defined( DAW_HAS_MSVC )
106#define DAW_JSON_MAKE_LOC_INFO_CONSTEVAL constexpr
107#else
108#define DAW_JSON_MAKE_LOC_INFO_CONSTEVAL DAW_CONSTEVAL
109#endif
110
111// Allow experimental SIMD paths, if available
112// by defining DAW_ALLOW_SSE42 and using the parser policy ExecModeType simd
113#if not defined( DAW_JSON_NO_SSE42 )
114#if defined( __SSE4_2__ ) or defined( __AVX__ ) or defined( __AVX2__ )
115#if not defined( DAW_ALLOW_SSE42 )
116#define DAW_ALLOW_SSE42 1
117#endif
118#endif
119#endif
120
121// Use strtod instead of from_chars when avialable by defining
122// DAW_JSON_USE_STRTOD
123#if defined( __cpp_lib_to_chars )
124#if __cpp_lib_to_chars >= 201611L
125#define DAW_HAS_CPP17_FP_FROM_CHARS 1
126#endif
127#endif
128#if not defined( DAW_JSON_USE_STRTOD ) and \
129 not defined( DAW_HAS_CPP17_FP_FROM_CHARS )
130#define DAW_JSON_USE_STRTOD
131#endif
132
133// define DAW_JSON_DISABLE_RANDOM to disable creating random iterators when the
134// size is known up front. This is playing to the implementations prior to
135// C++23 when range constructors are added to containers. It is disabled on
136// MSVC as that impl does not work with it
137#if defined( DAW_HAS_MSVC )
138#if not defined( DAW_JSON_DISABLE_RANDOM )
139#define DAW_JSON_DISABLE_RANDOM
140#endif
141#endif
142
143// DAW_JSON_HAS_BUILTIN_UADD is used to switch to a constexpr method of overflow
144// addition when available
145#if DAW_HAS_GCC_VER_GTE( 8, 0 ) or defined( DAW_HAS_CLANG ) or \
146 ( DAW_HAS_BUILTIN( __builtin_uadd_overflow ) and \
147 DAW_HAS_BUILTIN( __builtin_uaddl_overflow ) and \
148 DAW_HAS_BUILTIN( __builtin_uaddll_overflow ) )
149#define DAW_JSON_HAS_BUILTIN_UADD
150#endif
151
152// DAW_JSON_BUGFIX_FROM_JSON_001
153// Defined for MSVC as it has been ICE'ing on daw_json_ensure in from_json
154#if defined( DAW_HAS_MSVC )
155#define DAW_JSON_BUGFIX_FROM_JSON_001
156#endif
157
158// DAW_JSON_BUGFIX_MSVC_EVAL_ORDER_002
159// MSVC cannot always evaluate in the correct order as defined by the standard.
160// JSON Link uses the left->right guarantees in places like constructors so that
161// less state is needed. In MSVC one must keep more state in places like
162// parse_tuple_value
163#if defined( DAW_HAS_MSVC )
164#define DAW_JSON_BUGFIX_MSVC_EVAL_ORDER_002
165#endif
166
167// DAW_JSON_BUGFIX_MSVC_KNOWN_LOC_ICE_003
168// MSVC in C++20 mode will ICE when known locations is evaluated at compile time
169#if defined( DAW_HAS_MSVC ) and __cpp_constexpr > 201700L
170#define DAW_JSON_BUGFIX_MSVC_KNOWN_LOC_ICE_003
171#endif
172
176#if not defined( NDEBUG ) or defined( DEBUG ) or \
177 defined( DAW_JSON_PARSER_DIAGNOSTICS ) or defined( DAW_HAS_MSVC )
178#if not defined( DAW_JSON_ALWAYS_FULL_NAME_MATCH )
179#define DAW_JSON_ALWAYS_FULL_NAME_MATCH
180#endif
181#endif
182
183// Allows pack expansions with get<Is> without separate methods. This should
184// improve symbol sizes
185#if defined( __cpp_generic_lambdas )
186#if __cpp_generic_lambdas >= 201707L
187#define DAW_JSON_USE_GENERIC_LAMBDAS
188#endif
189#endif
190
191// Use static operator( ) when supported
192#if defined( __cpp_static_call_operator )
193#if __cpp_static_call_operator >= 202207L
194#define DAW_JSON_HAS_STATIC_CALL_OP
195#endif
196#endif
197#if defined( DAW_JSON_HAS_STATIC_CALL_OP )
198#define DAW_JSON_CPP23_STATIC_CALL_OP static
199#define DAW_JSON_CPP23_STATIC_CALL_OP_CONST
200
201#if DAW_HAS_CLANG_VER_GTE( 17, 0 )
202#define DAW_JSON_CPP23_STATIC_CALL_OP_DISABLE_WARNING \
203 _Pragma( "clang diagnostic push" ) \
204 _Pragma( "clang diagnostic ignored \"-Wc++23-extensions\"" )
205
206#define DAW_JSON_CPP23_STATIC_CALL_OP_ENABLE_WARNING \
207 _Pragma( "clang diagnostic pop" )
208#else
209#define DAW_JSON_CPP23_STATIC_CALL_OP_DISABLE_WARNING
210#define DAW_JSON_CPP23_STATIC_CALL_OP_ENABLE_WARNING
211#endif
212#else
213#define DAW_JSON_CPP23_STATIC_CALL_OP
214#define DAW_JSON_CPP23_STATIC_CALL_OP_CONST const
215#define DAW_JSON_CPP23_STATIC_CALL_OP_DISABLE_WARNING
216#define DAW_JSON_CPP23_STATIC_CALL_OP_ENABLE_WARNING
217#endif
218
219#if defined( __cpp_constexpr_dynamic_alloc )
220#if __cpp_constexpr_dynamic_alloc >= 201907L
221#define DAW_JSON_HAS_CPP20_CX_ALLOC
222#endif
223#endif
224
225#if defined( DAW_JSON_HAS_CPP20_CX_ALLOC )
226#define DAW_JSON_HAS_CPP20_CX_DTOR
227#define DAW_JSON_CPP20_CX_DTOR constexpr
228#else
229#define DAW_JSON_CPP20_CX_DTOR
230#endif
231
232#if defined( DAW_JSON_HAS_CPP20_CX_ALLOC ) and \
233 defined( __cpp_lib_constexpr_vector )
234#if __cpp_lib_constexpr_vector >= 201907L
235#define DAW_JSON_HAS_CPP20_CX_VECTOR
236#endif
237#endif
238
239#if defined( DAW_JSON_HAS_CPP20_CX_VECTOR )
240#define DAW_JSON_CX_VECTOR constexpr
241#else
242#define DAW_JSON_CX_VECTOR
243#endif
244
245#if defined( DAW_JSON_HAS_CPP20_CX_ALLOC ) and \
246 defined( __cpp_lib_constexpr_string )
247#if __cpp_lib_constexpr_string >= 201907L
248#define DAW_JSON_HAS_CPP20_CX_STRING
249#endif
250#endif
251
252#if defined( DAW_JSON_HAS_CPP20_CX_STRING )
253#define DAW_JSON_CX_STRING constexpr
254#else
255#define DAW_JSON_CX_STRING inline
256#endif
257
258#if defined( DAW_JSON_HAS_CPP20_CX_STRING ) and \
259 defined( DAW_JSON_HAS_CPP20_CX_VECTOR )
260#define DAW_JSON_HAS_CPP20_CX_STRVEC
261#define DAW_JSON_CX_STRVEC constexpr
262#else
263#define DAW_JSON_CX_STRVEC
264#endif
265
266// Many of the iterators used offer some extra checking when this is set. By
267// default in debug mode they are enabled. Prior to C++20 affects the triviality
268// of their destructors and can prevent their use in constexpr code. Setting
269// DAW_JSON_NO_FULL_DEBUG_ITERATORS disables the destructor checks when compiler
270// support for constexpr destructors is unavailable
271#if defined( DAW_JSON_HAS_CPP20_CX_DTOR )
272#if not defined( NDEBUG ) and not defined( DAW_JSON_USE_FULL_DEBUG_ITERATORS )
273#define DAW_JSON_USE_FULL_DEBUG_ITERATORS
274#endif
275#endif
276
277#if defined( __cpp_lib_containers_ranges )
278#if __cpp_lib_containers_ranges > 202202L
279#define DAW_JSON_HAS_CPP23_RANGE_CTOR
280#endif
281#endif
282
283#if defined( __cpp_lib_constexpr_exceptions )
284#if __cpp_lib_constexpr_exceptions >= 202411L
285#define DAW_JSON_HAS_CONSTEXPR_EXCEPTIONS
286#endif
287#endif
288
289#if defined( DAW_JSON_HAS_CONSTEXPR_EXCEPTIONS )
290#define DAW_JSON_CPP26_CX_EXCEPT constexpr
291#else
292#define DAW_JSON_CPP26_CX_EXCEPT inline
293#endif
294
295#if defined( __cpp_lib_reflection ) and not defined( DAW_JSON_NO_RELFECTION )
296#if __cpp_lib_reflection >= 202506L
297#define DAW_JSON_HAS_REFLECTION 1
298#endif
299#endif
300
301#if defined( __cpp_generic_lambdas )
302#if __cpp_generic_lambdas >= 201707L
303#define DAW_JSON_CPP20_TEMPLATE_LAMBDAS
304#endif
305#endif