esp-idf/tools/test_apps/system/cxx_build_test/README.md

| Supported Targets | ESP32 | ESP32-C2 | ESP32-C3 | ESP32-C6 | ESP32-H2 | ESP32-S2 | ESP32-S3 |
| ----------------- | ----- | -------- | -------- | -------- | -------- | -------- | -------- |

# C++ build test

This build-only app can be used to check if certain headers, macros or features can be successfully compiled in a C++ source file. It furthermore checks the current C++ language standard set in IDF is the expected one.

## This App Broke My Build :(

It is likely that one of the following situations occurred:
1. The language standard for IDF has been changed without changing the test in this application.
2. Code incompatible to C++ has been added to one of the public header files in IDF. Check the C++ documentation section [Combining C and C++ code](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/cplusplus.html#combining-c-and-c-code) for more details.

## Adding New Test
Create a new file `main/test_<name>.cpp` and add it to main/CMakeLists.txt. If you need to check specific compiler flags, use `set_source_files_properties` CMake function to adjust the compilation flags for the given source file.
esp32h2: add build test 2023-01-10 00:59:46 -05:00			`\| Supported Targets \| ESP32 \| ESP32-C2 \| ESP32-C3 \| ESP32-C6 \| ESP32-H2 \| ESP32-S2 \| ESP32-S3 \|`
			`\| ----------------- \| ----- \| -------- \| -------- \| -------- \| -------- \| -------- \| -------- \|`
docs: changes docs supported targets tables 2022-07-12 22:41:36 -04:00
soc: make register access macros compatible with C++20 In C++20, using the result of an assignment to a 'volatile' value is deprecated. Breaking change: register "setter" or modification macros can no longer be used as expressions. Closes https://github.com/espressif/esp-idf/issues/9170 2022-06-17 10:43:31 -04:00			`# C++ build test`

cxx: gnu++23 -> gnu++2b for clang compatibility, added docs and test * Using -std=gnu++2b now for both gcc and clang as clang does not recognize gnu++23 yet * Added a build test app to check the C++ standard in IDF * Updated english docs to reflect the change to C++23 2023-04-11 22:14:58 -04:00			`This build-only app can be used to check if certain headers, macros or features can be successfully compiled in a C++ source file. It furthermore checks the current C++ language standard set in IDF is the expected one.`
soc: make register access macros compatible with C++20 In C++20, using the result of an assignment to a 'volatile' value is deprecated. Breaking change: register "setter" or modification macros can no longer be used as expressions. Closes https://github.com/espressif/esp-idf/issues/9170 2022-06-17 10:43:31 -04:00
cxx: gnu++23 -> gnu++2b for clang compatibility, added docs and test * Using -std=gnu++2b now for both gcc and clang as clang does not recognize gnu++23 yet * Added a build test app to check the C++ standard in IDF * Updated english docs to reflect the change to C++23 2023-04-11 22:14:58 -04:00			`## This App Broke My Build :(`
soc: make register access macros compatible with C++20 In C++20, using the result of an assignment to a 'volatile' value is deprecated. Breaking change: register "setter" or modification macros can no longer be used as expressions. Closes https://github.com/espressif/esp-idf/issues/9170 2022-06-17 10:43:31 -04:00
cxx: gnu++23 -> gnu++2b for clang compatibility, added docs and test * Using -std=gnu++2b now for both gcc and clang as clang does not recognize gnu++23 yet * Added a build test app to check the C++ standard in IDF * Updated english docs to reflect the change to C++23 2023-04-11 22:14:58 -04:00			`It is likely that one of the following situations occurred:`
			`1. The language standard for IDF has been changed without changing the test in this application.`
			`2. Code incompatible to C++ has been added to one of the public header files in IDF. Check the C++ documentation section [Combining C and C++ code](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/cplusplus.html#combining-c-and-c-code) for more details.`

			`## Adding New Test`
			Create a new file `main/test_<name>.cpp` and add it to main/CMakeLists.txt. If you need to check specific compiler flags, use `set_source_files_properties` CMake function to adjust the compilation flags for the given source file.