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 not defined( DAW_JSON_USE_STRTOD ) and not defined( __cpp_lib_to_chars )
124#define DAW_JSON_USE_STRTOD
125#endif
126
127// define DAW_JSON_DISABLE_RANDOM to disable creating random iterators when the
128// size is known up front. This is playing to the implementations prior to
129// C++23 when range constructors are added to containers. It is disabled on
130// MSVC as that impl does not work with it
131#if defined( DAW_HAS_MSVC )
132#if not defined( DAW_JSON_DISABLE_RANDOM )
133#define DAW_JSON_DISABLE_RANDOM
134#endif
135#endif
136
137// DAW_JSON_HAS_BUILTIN_UADD is used to switch to a constexpr method of overflow
138// addition when available
139#if DAW_HAS_GCC_VER_GTE( 8, 0 ) or defined( DAW_HAS_CLANG ) or \
140 ( DAW_HAS_BUILTIN( __builtin_uadd_overflow ) and \
141 DAW_HAS_BUILTIN( __builtin_uaddl_overflow ) and \
142 DAW_HAS_BUILTIN( __builtin_uaddll_overflow ) )
143#define DAW_JSON_HAS_BUILTIN_UADD
144#endif
145
146// DAW_JSON_BUGFIX_FROM_JSON_001
147// Defined for MSVC as it has been ICE'ing on daw_json_ensure in from_json
148#if defined( DAW_HAS_MSVC )
149#define DAW_JSON_BUGFIX_FROM_JSON_001
150#endif
151
152// DAW_JSON_BUGFIX_MSVC_EVAL_ORDER_002
153// MSVC cannot always evaluate in the correct order as defined by the standard.
154// JSON Link uses the left->right guarantees in places like constructors so that
155// less state is needed. In MSVC one must keep more state in places like
156// parse_tuple_value
157#if defined( DAW_HAS_MSVC )
158#define DAW_JSON_BUGFIX_MSVC_EVAL_ORDER_002
159#endif
160
161// DAW_JSON_BUGFIX_MSVC_KNOWN_LOC_ICE_003
162// MSVC in C++20 mode will ICE when known locations is evaluated at compile time
163#if defined( DAW_HAS_MSVC ) and __cpp_constexpr > 201700L
164#define DAW_JSON_BUGFIX_MSVC_KNOWN_LOC_ICE_003
165#endif
166
170#if not defined( NDEBUG ) or defined( DEBUG ) or \
171 defined( DAW_JSON_PARSER_DIAGNOSTICS ) or defined( DAW_HAS_MSVC )
172#if not defined( DAW_JSON_ALWAYS_FULL_NAME_MATCH )
173#define DAW_JSON_ALWAYS_FULL_NAME_MATCH
174#endif
175#endif
176
177// Allows pack expansions with get<Is> without separate methods. This should
178// improve symbol sizes
179#if defined( __cpp_generic_lambdas )
180#if __cpp_generic_lambdas >= 201707L
181#define DAW_JSON_USE_GENERIC_LAMBDAS
182#endif
183#endif
184
185// Use static operator( ) when supported
186#if defined( __cpp_static_call_operator )
187#if __cpp_static_call_operator >= 202207L
188#define DAW_JSON_HAS_STATIC_CALL_OP
189#endif
190#endif
191#if defined( DAW_JSON_HAS_STATIC_CALL_OP )
192#define DAW_JSON_CPP23_STATIC_CALL_OP static
193#define DAW_JSON_CPP23_STATIC_CALL_OP_CONST
194
195#if DAW_HAS_CLANG_VER_GTE( 17, 0 )
196#define DAW_JSON_CPP23_STATIC_CALL_OP_DISABLE_WARNING \
197 _Pragma( "clang diagnostic push" ) \
198 _Pragma( "clang diagnostic ignored \"-Wc++23-extensions\"" )
199
200#define DAW_JSON_CPP23_STATIC_CALL_OP_ENABLE_WARNING \
201 _Pragma( "clang diagnostic pop" )
202#else
203#define DAW_JSON_CPP23_STATIC_CALL_OP_DISABLE_WARNING
204#define DAW_JSON_CPP23_STATIC_CALL_OP_ENABLE_WARNING
205#endif
206#else
207#define DAW_JSON_CPP23_STATIC_CALL_OP
208#define DAW_JSON_CPP23_STATIC_CALL_OP_CONST const
209#define DAW_JSON_CPP23_STATIC_CALL_OP_DISABLE_WARNING
210#define DAW_JSON_CPP23_STATIC_CALL_OP_ENABLE_WARNING
211#endif
212
213#if defined( __cpp_constexpr_dynamic_alloc )
214#if __cpp_constexpr_dynamic_alloc >= 201907L
215#define DAW_JSON_HAS_CPP20_CX_ALLOC
216#endif
217#endif
218
219#if defined( DAW_JSON_HAS_CPP20_CX_ALLOC )
220#define DAW_JSON_HAS_CPP20_CX_DTOR
221#define DAW_JSON_CPP20_CX_DTOR constexpr
222#else
223#define DAW_JSON_CPP20_CX_DTOR
224#endif
225
226#if defined( DAW_JSON_HAS_CPP20_CX_ALLOC ) and \
227 defined( __cpp_lib_constexpr_vector )
228#if __cpp_lib_constexpr_vector >= 201907L
229#define DAW_JSON_HAS_CPP20_CX_VECTOR
230#endif
231#endif
232
233#if defined( DAW_JSON_HAS_CPP20_CX_VECTOR )
234#define DAW_JSON_CX_VECTOR constexpr
235#else
236#define DAW_JSON_CX_VECTOR
237#endif
238
239#if defined( DAW_JSON_HAS_CPP20_CX_ALLOC ) and \
240 defined( __cpp_lib_constexpr_string )
241#if __cpp_lib_constexpr_string >= 201907L
242#define DAW_JSON_HAS_CPP20_CX_STRING
243#endif
244#endif
245
246#if defined( DAW_JSON_HAS_CPP20_CX_STRING )
247#define DAW_JSON_CX_STRING constexpr
248#else
249#define DAW_JSON_CX_STRING inline
250#endif
251
252#if defined( DAW_JSON_HAS_CPP20_CX_STRING ) and \
253 defined( DAW_JSON_HAS_CPP20_CX_VECTOR )
254#define DAW_JSON_HAS_CPP20_CX_STRVEC
255#define DAW_JSON_CX_STRVEC constexpr
256#else
257#define DAW_JSON_CX_STRVEC
258#endif
259
260// Many of the iterators used offer some extra checking when this is set. By
261// default in debug mode they are enabled. Prior to C++20 affects the triviality
262// of their destructors and can prevent their use in constexpr code. Setting
263// DAW_JSON_NO_FULL_DEBUG_ITERATORS disables the destructor checks when compiler
264// support for constexpr destructors is unavailable
265#if defined( DAW_JSON_HAS_CPP20_CX_DTOR )
266#if not defined( NDEBUG ) and not defined( DAW_JSON_USE_FULL_DEBUG_ITERATORS )
267#define DAW_JSON_USE_FULL_DEBUG_ITERATORS
268#endif
269#endif
270
271#if defined( __cpp_lib_containers_ranges )
272#if __cpp_lib_containers_ranges > 202202L
273#define DAW_JSON_HAS_CPP23_RANGE_CTOR
274#endif
275#endif
276
277#if defined( __cpp_lib_constexpr_exceptions )
278#if __cpp_lib_constexpr_exceptions >= 202411L
279#define DAW_JSON_HAS_CONSTEXPR_EXCEPTIONS
280#endif
281#endif
282
283#if defined( DAW_JSON_HAS_CONSTEXPR_EXCEPTIONS )
284#define DAW_JSON_CPP26_CX_EXCEPT constexpr
285#else
286#define DAW_JSON_CPP26_CX_EXCEPT inline
287#endif
288
289#if defined( __cpp_lib_reflection )
290#if __cpp_lib_reflection >= 202506L
291#define DAW_JSON_HAS_REFLECTION 1
292#endif
293#endif
294
295#if defined( __cpp_generic_lambdas )
296#if __cpp_generic_lambdas >= 201707L
297#define DAW_JSON_CPP20_TEMPLATE_LAMBDAS
298#endif
299#endif