[{"data":1,"prerenderedAt":880},["ShallowReactive",2],{"doc-configuration":3},{"id":4,"title":5,"body":6,"description":160,"extension":871,"meta":872,"navigation":873,"path":874,"seo":875,"slug":876,"source":877,"stem":878,"__hash__":879},"docs\u002Fdocs\u002Fconfiguration.md","Compile-time configuration",{"type":7,"value":8,"toc":851},"minimark",[9,50,54,144,147,151,161,180,182,188,216,222,228,231,250,263,269,272,288,295,309,321,324,330,356,359,365,377,387,390,396,415,427,435,442,454,463,469,475,488,498,505,522,527,533,540,546,552,555,563,566,569,575,586,598,601,606,612,618,621,643,646,652,655,725,728,733,740,746,749,754,764,771,778,781,786,793,796,802,807,813,818,821,825,830,833,839,847],[10,11,12],"blockquote",{},[13,14,15,19,20,24,25,28,29,32,33,36,37,36,40,43,44,49],"p",{},[16,17,18],"strong",{},"Catch3 compatibility reference:"," This page describes the test-writing API Catch3 shares with Catch2: the macros, such as ",[21,22,23],"code",{},"TEST_CASE"," and ",[21,26,27],{},"REQUIRE",", and the ",[21,30,31],{},"Catch::"," namespace keep Catch2's names. Headers and build names are Catch3's own (",[21,34,35],{},"\u003CProgmasoft\u002FCatch3\u002FTestMacros.hpp>",", ",[21,38,39],{},"find_package(Catch3)",[21,41,42],{},"Catch3::Catch3WithMain","). See ",[45,46,48],"a",{"href":47},"\u002Fdocs\u002Fprogmasoft-catch3\u002F","Catch3 additions"," for Progmasoft APIs.",[51,52,5],"h1",{"id":53},"compile-time-configuration",[13,55,56,59,62,66,68,72,74,78,80,84,86,90,92,96,98,102,104,108,110,114,116,120,122,130,132,136,138,142],{},[16,57,58],{},"Contents",[60,61],"br",{},[45,63,65],{"href":64},"#prefixing-catch-macros","Prefixing Catch macros",[60,67],{},[45,69,71],{"href":70},"#stdout","stdout",[60,73],{},[45,75,77],{"href":76},"#fallback-stringifier","Fallback stringifier",[60,79],{},[45,81,83],{"href":82},"#bazel-support","Bazel support",[60,85],{},[45,87,89],{"href":88},"#c11-toggles","C++11 toggles",[60,91],{},[45,93,95],{"href":94},"#c17-toggles","C++17 toggles",[60,97],{},[45,99,101],{"href":100},"#other-toggles","Other toggles",[60,103],{},[45,105,107],{"href":106},"#enabling-stringification","Enabling stringification",[60,109],{},[45,111,113],{"href":112},"#disabling-exceptions","Disabling exceptions",[60,115],{},[45,117,119],{"href":118},"#disabling-deprecation-warnings","Disabling deprecation warnings",[60,121],{},[45,123,125,126,129],{"href":124},"#overriding-catchs-debug-break--b","Overriding Catch's debug break (",[21,127,128],{},"-b",")",[60,131],{},[45,133,135],{"href":134},"#static-analysis-support","Static analysis support",[60,137],{},[45,139,141],{"href":140},"#thread-safety-in-assertions-and-messages","Thread safety in assertions (and messages)",[60,143],{},[13,145,146],{},"Catch2 is designed to \"just work\" as much as possible, and most of the\nconfiguration options below are changed automatically during compilation,\naccording to the detected environment. However, this detection can also\nbe overridden by users, using macros documented below, and\u002For CMake options\nwith the same name.",[148,149,65],"h2",{"id":150},"prefixing-catch-macros",[152,153,158],"pre",{"className":154,"code":156,"language":157},[155],"language-text","CATCH_CONFIG_PREFIX_ALL       \u002F\u002F Prefix all macros with CATCH_\nCATCH_CONFIG_PREFIX_MESSAGES  \u002F\u002F Prefix only message macros ((UNSCOPED_)INFO, WARN, (UNSCOPED_)CAPTURE)\n","text",[21,159,156],{"__ignoreMap":160},"",[13,162,163,164,24,166,168,169,172,173,24,176,179],{},"To keep test code clean and uncluttered Catch uses short macro names (e.g. ",[21,165,23],{},[21,167,27],{},"). Occasionally these may conflict with identifiers from platform headers or the system under test. In this case the above identifier can be defined. This will cause all the Catch user macros to be prefixed with ",[21,170,171],{},"CATCH_"," (e.g. ",[21,174,175],{},"CATCH_TEST_CASE",[21,177,178],{},"CATCH_REQUIRE",").",[148,181,71],{"id":71},[152,183,186],{"className":184,"code":185,"language":157},[155],"CATCH_CONFIG_NOSTDOUT\n",[21,187,185],{"__ignoreMap":160},[13,189,190,191,36,194,197,198,201,202,36,205,24,208,211,212,215],{},"To support platforms that do not provide ",[21,192,193],{},"std::cout",[21,195,196],{},"std::cerr"," and\n",[21,199,200],{},"std::clog",", Catch does not use them directly, but rather calls\n",[21,203,204],{},"Catch::cout",[21,206,207],{},"Catch::cerr",[21,209,210],{},"Catch::clog",". You can replace their\nimplementation by defining ",[21,213,214],{},"CATCH_CONFIG_NOSTDOUT"," and implementing\nthem yourself, their signatures are:",[152,217,220],{"className":218,"code":219,"language":157},[155],"std::ostream& cout();\nstd::ostream& cerr();\nstd::ostream& clog();\n",[21,221,219],{"__ignoreMap":160},[13,223,224],{},[45,225,227],{"href":226},"..\u002Fexamples\u002F231-Cfg-OutputStreams.cpp","You can see an example of replacing these functions here.",[148,229,77],{"id":230},"fallback-stringifier",[13,232,233,234,237,238,241,242,245,246,249],{},"By default, when Catch's stringification machinery has to stringify\na type that does not specialize ",[21,235,236],{},"StringMaker",", does not overload ",[21,239,240],{},"operator\u003C\u003C",",\nis not an enumeration and is not a range, it uses ",[21,243,244],{},"\"{?}\"",". This can be\noverridden by defining ",[21,247,248],{},"CATCH_CONFIG_FALLBACK_STRINGIFIER"," to name of a\nfunction that should perform the stringification instead.",[13,251,252,253,255,256,258,259,262],{},"All types that do not provide ",[21,254,236],{}," specialization or ",[21,257,240],{},"\noverload will be sent to this function (this includes enums and ranges).\nThe provided function must return ",[21,260,261],{},"std::string"," and must accept any type,\ne.g. via overloading.",[13,264,265],{},[266,267,268],"em",{},"Note that if the provided function does not handle a type and this type\nrequires to be stringified, the compilation will fail.",[148,270,83],{"id":271},"bazel-support",[13,273,274,275,278,279,283,284,287],{},"Compiling Catch2 with ",[21,276,277],{},"CATCH_CONFIG_BAZEL_SUPPORT"," makes the runner read\n",[45,280,282],{"href":281},"\u002Fdocs\u002Fprogmasoft-runner\u002F#bazel-and-ctest","Bazel's environment variables","\nalways; otherwise it reads them when ",[21,285,286],{},"BAZEL_TEST=1"," is set.",[13,289,290,291,294],{},"This can be useful if you are using older versions of Bazel, that do not\nyet have ",[21,292,293],{},"BAZEL_TEST"," env var support.",[10,296,297],{},[13,298,299,301,302,308],{},[21,300,277],{}," was ",[45,303,307],{"href":304,"rel":305},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fpull\u002F2399",[306],"nofollow","introduced"," in Catch2 3.0.1.",[10,310,311],{},[13,312,313,301,315,320],{},[21,314,277],{},[45,316,319],{"href":317,"rel":318},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fpull\u002F2459",[306],"deprecated"," in Catch2 3.1.0.",[148,322,89],{"id":323},"c11-toggles",[152,325,328],{"className":326,"code":327,"language":157},[155],"CATCH_CONFIG_CPP11_TO_STRING \u002F\u002F Use `std::to_string`\n",[21,329,327],{"__ignoreMap":160},[13,331,332,333,336,337,340,341,343,344,347,348,351,352,355],{},"Because we support platforms whose standard library does not contain\n",[21,334,335],{},"std::to_string",", it is possible to force Catch to use a workaround\nbased on ",[21,338,339],{},"std::stringstream",". On platforms other than Android,\nthe default is to use ",[21,342,335],{},". On Android, the default is to\nuse the ",[21,345,346],{},"stringstream"," workaround. As always, it is possible to override\nCatch's selection, by defining either ",[21,349,350],{},"CATCH_CONFIG_CPP11_TO_STRING"," or\n",[21,353,354],{},"CATCH_CONFIG_NO_CPP11_TO_STRING",".",[148,357,95],{"id":358},"c17-toggles",[152,360,363],{"className":361,"code":362,"language":157},[155],"CATCH_CONFIG_CPP17_UNCAUGHT_EXCEPTIONS  \u002F\u002F Override std::uncaught_exceptions (instead of std::uncaught_exception) support detection\nCATCH_CONFIG_CPP17_STRING_VIEW          \u002F\u002F Override std::string_view support detection (Catch provides a StringMaker specialization by default)\nCATCH_CONFIG_CPP17_VARIANT              \u002F\u002F Override std::variant support detection (checked by CATCH_CONFIG_ENABLE_VARIANT_STRINGMAKER)\nCATCH_CONFIG_CPP17_OPTIONAL             \u002F\u002F Override std::optional support detection (checked by CATCH_CONFIG_ENABLE_OPTIONAL_STRINGMAKER)\nCATCH_CONFIG_CPP17_BYTE                 \u002F\u002F Override std::byte support detection (Catch provides a StringMaker specialization by default)\n",[21,364,362],{"__ignoreMap":160},[10,366,367],{},[13,368,369,301,372,376],{},[21,370,371],{},"CATCH_CONFIG_CPP17_STRING_VIEW",[45,373,307],{"href":374,"rel":375},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fissues\u002F1376",[306]," in Catch2 2.4.1.",[13,378,379,380,383,384,355],{},"Catch contains basic compiler\u002Fstandard detection and attempts to use\nsome C++17 features whenever appropriate. This automatic detection\ncan be manually overridden in both directions, that is, a feature\ncan be enabled by defining the macro in the table above, and disabled\nby using ",[21,381,382],{},"_NO_"," in the macro, e.g. ",[21,385,386],{},"CATCH_CONFIG_NO_CPP17_UNCAUGHT_EXCEPTIONS",[148,388,101],{"id":389},"other-toggles",[152,391,394],{"className":392,"code":393,"language":157},[155],"CATCH_CONFIG_COUNTER                    \u002F\u002F Use __COUNTER__ to generate unique names for test cases\nCATCH_CONFIG_WINDOWS_SEH                \u002F\u002F Enable SEH handling on Windows\nCATCH_CONFIG_FAST_COMPILE               \u002F\u002F Sacrifices some (rather minor) features for compilation speed\nCATCH_CONFIG_POSIX_SIGNALS              \u002F\u002F Enable handling POSIX signals\nCATCH_CONFIG_WINDOWS_CRTDBG             \u002F\u002F Enable leak checking using Windows's CRT Debug Heap\nCATCH_CONFIG_DISABLE_STRINGIFICATION    \u002F\u002F Disable stringifying the original expression\nCATCH_CONFIG_DISABLE                    \u002F\u002F Disables assertions and test case registration\nCATCH_CONFIG_WCHAR                      \u002F\u002F Enables use of wchart_t\nCATCH_CONFIG_EXPERIMENTAL_REDIRECT      \u002F\u002F Enables the new (experimental) way of capturing stdout\u002Fstderr\nCATCH_CONFIG_USE_ASYNC                  \u002F\u002F Force parallel statistical processing of samples during benchmarking\nCATCH_CONFIG_ANDROID_LOGWRITE           \u002F\u002F Use android's logging system for debug output\nCATCH_CONFIG_GLOBAL_NEXTAFTER           \u002F\u002F Use nextafter{,f,l} instead of std::nextafter\nCATCH_CONFIG_GETENV                     \u002F\u002F System has a working `getenv`\nCATCH_CONFIG_USE_BUILTIN_CONSTANT_P     \u002F\u002F Use __builtin_constant_p to trigger warnings\n",[21,395,393],{"__ignoreMap":160},[10,397,398],{},[13,399,400,24,407,414],{},[45,401,404],{"href":402,"rel":403},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fissues\u002F1743",[306],[21,405,406],{},"CATCH_CONFIG_ANDROID_LOGWRITE",[45,408,411],{"href":409,"rel":410},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fpull\u002F1739",[306],[21,412,413],{},"CATCH_CONFIG_GLOBAL_NEXTAFTER"," were introduced in Catch2 2.10.0",[10,416,417],{},[13,418,419,301,422,426],{},[21,420,421],{},"CATCH_CONFIG_GETENV",[45,423,307],{"href":424,"rel":425},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fpull\u002F2562",[306]," in Catch2 3.2.0",[10,428,429],{},[13,430,431,434],{},[21,432,433],{},"CATCH_CONFIG_USE_BUILTIN_CONSTANT_P"," was introduced in Catch2 3.8.0",[13,436,437,438,441],{},"Currently Catch enables ",[21,439,440],{},"CATCH_CONFIG_WINDOWS_SEH"," only when compiled with MSVC, because some versions of MinGW do not have the necessary Win32 API support.",[13,443,444,447,448,451,452,179],{},[21,445,446],{},"CATCH_CONFIG_POSIX_SIGNALS"," is on by default, except when Catch is compiled under ",[21,449,450],{},"Cygwin",", where it is disabled by default (but can be force-enabled by defining ",[21,453,446],{},[13,455,456,458,459,462],{},[21,457,421],{}," is on by default, except when Catch2 is compiled for\nplatforms that lacks working ",[21,460,461],{},"std::getenv"," (currently Windows UWP and\nPlaystation).",[13,464,465,468],{},[21,466,467],{},"CATCH_CONFIG_WINDOWS_CRTDBG"," is off by default. If enabled, Windows's\nCRT is used to check for memory leaks, and displays them after the tests\nfinish running. This option only works when linking against the default\nmain, and must be defined for the whole library build.",[13,470,471,474],{},[21,472,473],{},"CATCH_CONFIG_WCHAR"," is on by default, but can be disabled. Currently\nit is only used in support for DJGPP cross-compiler.",[13,476,477,478,481,482,484,485,355],{},"With the exception of ",[21,479,480],{},"CATCH_CONFIG_EXPERIMENTAL_REDIRECT",",\nthese toggles can be disabled by using ",[21,483,382],{}," form of the toggle,\ne.g. ",[21,486,487],{},"CATCH_CONFIG_NO_WINDOWS_SEH",[13,489,490,492,493,355],{},[21,491,433],{}," is ON by default for Clang and GCC\n(but as far as possible, not for other compilers masquerading for these\ntwo). However, it can cause bugs where the enclosed code is evaluated, even\nthough it should not be, e.g. in ",[45,494,497],{"href":495,"rel":496},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fissues\u002F2925",[306],"#2925",[499,500,502],"h3",{"id":501},"catch_config_fast_compile",[21,503,504],{},"CATCH_CONFIG_FAST_COMPILE",[13,506,507,508,510,511,514,515,36,518,521],{},"This compile-time flag speeds up compilation of assertion macros by ~20%,\nby disabling the generation of assertion-local try-catch blocks for\nnon-exception family of assertion macros ({",[21,509,27],{},",",[21,512,513],{},"CHECK","}{``,",[21,516,517],{},"_FALSE",[21,519,520],{},"_THAT","}).\nThis disables translation of exceptions thrown under these assertions, but\nshould not lead to false negatives.",[13,523,524,526],{},[21,525,504],{}," has to be either defined, or not defined,\nin all translation units that are linked into single test binary.",[499,528,530],{"id":529},"catch_config_disable_stringification",[21,531,532],{},"CATCH_CONFIG_DISABLE_STRINGIFICATION",[13,534,535,536,355],{},"This toggle enables a workaround for VS 2017 bug. For details see ",[45,537,539],{"href":538},"\u002Fdocs\u002Flimitations\u002F#visual-studio-2017----raw-string-literal-in-assert-fails-to-compile","known limitations",[499,541,543],{"id":542},"catch_config_disable",[21,544,545],{},"CATCH_CONFIG_DISABLE",[13,547,548,549,551],{},"This toggle removes most of Catch from given file. This means that ",[21,550,23],{},"s are not registered and assertions are turned into no-ops. Useful for keeping tests within implementation files (ie for functions with internal linkage), instead of in external files.",[13,553,554],{},"This feature is considered experimental and might change at any point.",[13,556,557],{},[266,558,559,560],{},"Inspired by Doctest's ",[21,561,562],{},"DOCTEST_CONFIG_DISABLE",[148,564,107],{"id":565},"enabling-stringification",[13,567,568],{},"By default, Catch does not stringify some types from the standard library. This is done to avoid dragging in various standard library headers by default. However, Catch does contain these and can be configured to provide them, using these macros:",[152,570,573],{"className":571,"code":572,"language":157},[155],"CATCH_CONFIG_ENABLE_PAIR_STRINGMAKER     \u002F\u002F Provide StringMaker specialization for std::pair\nCATCH_CONFIG_ENABLE_TUPLE_STRINGMAKER    \u002F\u002F Provide StringMaker specialization for std::tuple\nCATCH_CONFIG_ENABLE_VARIANT_STRINGMAKER  \u002F\u002F Provide StringMaker specialization for std::variant, std::monostate (on C++17)\nCATCH_CONFIG_ENABLE_OPTIONAL_STRINGMAKER \u002F\u002F Provide StringMaker specialization for std::optional (on C++17)\nCATCH_CONFIG_ENABLE_ALL_STRINGMAKERS     \u002F\u002F Defines all of the above\n",[21,574,572],{"__ignoreMap":160},[10,576,577],{},[13,578,579,301,582,376],{},[21,580,581],{},"CATCH_CONFIG_ENABLE_VARIANT_STRINGMAKER",[45,583,307],{"href":584,"rel":585},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fissues\u002F1380",[306],[10,587,588],{},[13,589,590,301,593,597],{},[21,591,592],{},"CATCH_CONFIG_ENABLE_OPTIONAL_STRINGMAKER",[45,594,307],{"href":595,"rel":596},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fissues\u002F1510",[306]," in Catch2 2.6.0.",[148,599,113],{"id":600},"disabling-exceptions",[10,602,603],{},[13,604,605],{},"Introduced in Catch2 2.4.0.",[13,607,608,609,611],{},"By default, Catch2 uses exceptions to signal errors and to abort tests\nwhen an assertion from the ",[21,610,27],{}," family of assertions fails. We also\nprovide an experimental support for disabling exceptions. Catch2 should\nautomatically detect when it is compiled with exceptions disabled, but\nit can be forced to compile without exceptions by defining",[152,613,616],{"className":614,"code":615,"language":157},[155],"CATCH_CONFIG_DISABLE_EXCEPTIONS\n",[21,617,615],{"__ignoreMap":160},[13,619,620],{},"Note that when using Catch2 without exceptions, there are 2 major\nlimitations:",[622,623,624,634],"ol",{},[625,626,627,628,197,630,633],"li",{},"If there is an error that would normally be signalled by an exception,\nthe exception's message will instead be written to ",[21,629,207],{},[21,631,632],{},"std::terminate"," will be called.",[625,635,636,637,639,640,642],{},"If an assertion from the ",[21,638,27],{}," family of macros fails,\n",[21,641,632],{}," will be called after the active reporter returns.",[13,644,645],{},"There is also a customization point for the exact behaviour of what\nhappens instead of exception being thrown. To use it, define",[152,647,650],{"className":648,"code":649,"language":157},[155],"CATCH_CONFIG_DISABLE_EXCEPTIONS_CUSTOM_HANDLER\n",[21,651,649],{"__ignoreMap":160},[13,653,654],{},"and provide a definition for this function:",[152,656,660],{"className":657,"code":658,"language":659,"meta":160,"style":160},"language-cpp shiki shiki-themes github-dark","namespace Catch {\n    [[noreturn]]\n    void throw_exception(std::exception const&);\n}\n","cpp",[21,661,662,679,692,719],{"__ignoreMap":160},[663,664,667,671,675],"span",{"class":665,"line":666},"line",1,[663,668,670],{"class":669},"snl16","namespace",[663,672,674],{"class":673},"svObZ"," Catch",[663,676,678],{"class":677},"s95oV"," {\n",[663,680,682,686,689],{"class":665,"line":681},2,[663,683,685],{"class":684},"sDLfK","    [[",[663,687,688],{"class":673},"noreturn",[663,690,691],{"class":684},"]]\n",[663,693,695,698,701,704,707,710,713,716],{"class":665,"line":694},3,[663,696,697],{"class":669},"    void",[663,699,700],{"class":673}," throw_exception",[663,702,703],{"class":677},"(",[663,705,706],{"class":673},"std",[663,708,709],{"class":677},"::",[663,711,712],{"class":673},"exception",[663,714,715],{"class":669}," const&",[663,717,718],{"class":677},");\n",[663,720,722],{"class":665,"line":721},4,[663,723,724],{"class":677},"}\n",[148,726,119],{"id":727},"disabling-deprecation-warnings",[10,729,730],{},[13,731,732],{},"Introduced in Catch2 3.9.0",[13,734,735,736,739],{},"Catch2 has started using the C++ macro ",[21,737,738],{},"[[deprecated]]"," to mark things\nthat are deprecated and should not be used any more. If you need to\ntemporarily disable these warnings, use",[152,741,744],{"className":742,"code":743,"language":157},[155],"CATCH_CONFIG_NO_DEPRECATION_ANNOTATIONS\n",[21,745,743],{"__ignoreMap":160},[13,747,748],{},"Catch2 currently does not support more fine-grained deprecation warning\ncontrol, nor do we plan to.",[148,750,125,752,129],{"id":751},"overriding-catchs-debug-break-b",[21,753,128],{},[10,755,756],{},[13,757,758,763],{},[45,759,762],{"href":760,"rel":761},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fpull\u002F1846",[306],"Introduced"," in Catch2 2.11.2.",[13,765,766,767,770],{},"You can override Catch2's break-into-debugger code by defining the\n",[21,768,769],{},"CATCH_BREAK_INTO_DEBUGGER()"," macro. This can be used if e.g. Catch2 does\nnot know your platform, or your platform is misdetected.",[13,772,773,774,777],{},"The macro will be used as is, that is, ",[21,775,776],{},"CATCH_BREAK_INTO_DEBUGGER();","\nmust compile and must break into debugger.",[148,779,135],{"id":780},"static-analysis-support",[10,782,783],{},[13,784,785],{},"Introduced in Catch2 3.4.0.",[13,787,788,789,792],{},"Some parts of Catch2, e.g. ",[21,790,791],{},"SECTION","s, can be hard for static analysis\ntools to reason about. Catch2 can change its internals to help static\nanalysis tools reason about the tests.",[13,794,795],{},"Catch2 automatically detects some static analysis tools (initial\nimplementation checks for clang-tidy and Coverity), but you can override\nits detection (in either direction) via",[152,797,800],{"className":798,"code":799,"language":157},[155],"CATCH_CONFIG_EXPERIMENTAL_STATIC_ANALYSIS_SUPPORT     \u002F\u002F force enables static analysis help\nCATCH_CONFIG_NO_EXPERIMENTAL_STATIC_ANALYSIS_SUPPORT  \u002F\u002F force disables static analysis help\n",[21,801,799],{"__ignoreMap":160},[13,803,804],{},[266,805,806],{},"As the name suggests, this is currently experimental, and thus we provide\nno backwards compatibility guarantees.",[13,808,809,812],{},[16,810,811],{},"DO NOT ENABLE THIS FOR BUILDS YOU INTEND TO RUN."," The changed internals\nare not meant to be runnable, only \"scannable\".",[13,814,815],{},[45,816],{"id":817},"experimental-thread-safety",[148,819,141],{"id":820},"thread-safety-in-assertions-and-messages",[10,822,823],{},[13,824,732],{},[10,826,827],{},[13,828,829],{},"Made non-experimental in Catch2 3.12.0",[13,831,832],{},"Catch2 can optionally support thread-safe assertions, that means, multiple\nuser-spawned threads can use the assertion macros at the same time. Due\nto the performance cost this imposes even on single-threaded usage, Catch2\ndefaults to non-thread-safe assertions.",[152,834,837],{"className":835,"code":836,"language":157},[155],"CATCH_CONFIG_THREAD_SAFE_ASSERTIONS     \u002F\u002F enables thread safe assertions\nCATCH_CONFIG_NO_THREAD_SAFE_ASSERTIONS  \u002F\u002F force-disables thread safe assertions\n",[21,838,836],{"__ignoreMap":160},[13,840,841,842,846],{},"See ",[45,843,845],{"href":844},"\u002Fdocs\u002Fthread-safety\u002F","the documentation on thread safety in Catch2","\nfor details on which macros are safe and other notes.",[848,849,850],"style",{},"html pre.shiki code .snl16, html code.shiki .snl16{--shiki-default:#F97583}html pre.shiki code .svObZ, html code.shiki .svObZ{--shiki-default:#B392F0}html pre.shiki code .s95oV, html code.shiki .s95oV{--shiki-default:#E1E4E8}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":160,"searchDepth":681,"depth":681,"links":852},[853,854,855,856,857,858,859,864,865,866,867,869,870],{"id":150,"depth":681,"text":65},{"id":71,"depth":681,"text":71},{"id":230,"depth":681,"text":77},{"id":271,"depth":681,"text":83},{"id":323,"depth":681,"text":89},{"id":358,"depth":681,"text":95},{"id":389,"depth":681,"text":101,"children":860},[861,862,863],{"id":501,"depth":694,"text":504},{"id":529,"depth":694,"text":532},{"id":542,"depth":694,"text":545},{"id":565,"depth":681,"text":107},{"id":600,"depth":681,"text":113},{"id":727,"depth":681,"text":119},{"id":751,"depth":681,"text":868},"Overriding Catch's debug break (-b)",{"id":780,"depth":681,"text":135},{"id":820,"depth":681,"text":141},"md",{},true,"\u002Fdocs\u002Fconfiguration",{"title":5,"description":160},"configuration","docs\u002Fconfiguration.md","docs\u002Fconfiguration","XF0KYTMNhVXWKAqPHPuD8pzrKkbkbt-SxErzIrs4r2o",1794961593272]