add STL4038 prefix to "requires C++NN or later" messages (#2061)

Co-authored-by: Adam Bucior <[email protected]>
Co-authored-by: Stephan T. Lavavej <[email protected]>

stl/inc/any

@@ -10,7 +10,7 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX17
-#pragma message("The contents of <any> are available only with C++17 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <any> are available only with C++17 or later."))
 #else // ^^^ !_HAS_CXX17 / _HAS_CXX17 vvv
 #include <initializer_list>
 #include <type_traits>

stl/inc/barrier

@@ -14,7 +14,7 @@
 #endif // _M_CEE_PURE
 
 #if !_HAS_CXX20
-#pragma message("The contents of <barrier> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <barrier> are available only with C++20 or later."))
 #else // ^^^ !_HAS_CXX20 / _HAS_CXX20 vvv
 
 #include <atomic>

stl/inc/bit

@@ -9,7 +9,7 @@
 #include <yvals_core.h>
 #if _STL_COMPILER_PREPROCESSOR
 #if !_HAS_CXX20
-#pragma message("The contents of <bit> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <bit> are available only with C++20 or later."))
 #else // ^^^ !_HAS_CXX20 / _HAS_CXX20 vvv
 
 #include <intrin0.h>

stl/inc/charconv

@@ -10,7 +10,7 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX17
-#pragma message("The contents of <charconv> are available only with C++17 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <charconv> are available only with C++17 or later."))
 #else // ^^^ !_HAS_CXX17 / _HAS_CXX17 vvv
 #include <cstring>
 #include <intrin0.h>

stl/inc/compare

@@ -10,7 +10,7 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX20
-#pragma message("The contents of <compare> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <compare> are available only with C++20 or later."))
 #else // ^^^ !_HAS_CXX20 / _HAS_CXX20 vvv
 #ifdef __cpp_lib_concepts
 #include <bit>

stl/inc/concepts

@@ -10,7 +10,8 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #ifndef __cpp_lib_concepts
-#pragma message("The contents of <concepts> are available only with C++20 concepts support.")
+#pragma message( \
+    _WARNING_MESSAGE("STL4038", "The contents of <concepts> are available only with C++20 concepts support."))
 #else // ^^^ !defined(__cpp_lib_concepts) / defined(__cpp_lib_concepts) vvv
 #include <type_traits>
 #include <vcruntime_new.h>

stl/inc/coroutine

@@ -10,12 +10,17 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #ifdef _RESUMABLE_FUNCTIONS_SUPPORTED
-#pragma message("The contents of <coroutine> are not available with /await.")
-#pragma message("Remove /await or use /await:strict for standard coroutines.")
-#pragma message("Use <experimental/coroutine> for legacy /await support.")
+#define _STL4039_COROUTINE                                         \
+    "The contents of <coroutine> are not available with /await. "  \
+    "Remove /await or use /await:strict for standard coroutines. " \
+    "Use <experimental/coroutine> for legacy /await support."
+#pragma message(_WARNING_MESSAGE("STL4039", _STL4039_COROUTINE))
+#undef _STL4039_COROUTINE // TRANSITION, DevCom-1479701
 #else // ^^^ /await ^^^ / vvv no /await vvv
 #ifndef __cpp_lib_coroutine
-#pragma message("The contents of <coroutine> are available only with C++20 or later or /await:strict.")
+#define _STL4038_COROUTINE "The contents of <coroutine> are available only with C++20 or later or /await:strict."
+#pragma message(_WARNING_MESSAGE("STL4038", _STL4038_COROUTINE))
+#undef _STL4038_COROUTINE // TRANSITION, DevCom-1479701
 #else // ^^^ <coroutine> is not available / <coroutine> is available vvv
 #ifndef _ALLOW_COROUTINE_ABI_MISMATCH
 #pragma detect_mismatch("_COROUTINE_ABI", "2")

stl/inc/execution

@@ -10,7 +10,7 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX17
-#pragma message("The contents of <execution> are available only with C++17 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <execution> are available only with C++17 or later."))
 #else // ^^^ !_HAS_CXX17 / _HAS_CXX17 vvv
 #include <algorithm>
 #include <atomic>

stl/inc/expected

@@ -9,7 +9,7 @@
 #include <yvals.h>
 #if _STL_COMPILER_PREPROCESSOR
 #ifndef __cpp_lib_expected
-#pragma message("The contents of <expected> are available only with C++23 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <expected> are available only with C++23 or later."))
 #else // ^^^ !__cpp_lib_expected / __cpp_lib_expected vvv
 #include <exception>
 #include <initializer_list>

stl/inc/filesystem

@@ -10,7 +10,7 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX17
-#pragma message("The contents of <filesystem> are available only with C++17 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <filesystem> are available only with C++17 or later."))
 #else // ^^^ !_HAS_CXX17 / _HAS_CXX17 vvv
 #include <algorithm>
 #include <chrono>

stl/inc/format

@@ -40,7 +40,7 @@
 #include <yvals_core.h>
 #if _STL_COMPILER_PREPROCESSOR
 #ifndef __cpp_lib_format
-#pragma message("The contents of <format> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <format> are available only with C++20 or later."))
 #else // ^^^ !defined(__cpp_lib_format) / defined(__cpp_lib_format) vvv
 
 #include <__msvc_format_ucd_tables.hpp>

stl/inc/latch

@@ -14,7 +14,7 @@
 #endif // _M_CEE_PURE
 
 #if !_HAS_CXX20
-#pragma message("The contents of <latch> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <latch> are available only with C++20 or later."))
 #else // ^^^ !_HAS_CXX20 / _HAS_CXX20 vvv
 
 #include <atomic>

stl/inc/memory_resource

@@ -10,7 +10,8 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX17
-#pragma message("The contents of <memory_resource> are available only with C++17 or later.")
+#pragma message( \
+    _WARNING_MESSAGE("STL4038", "The contents of <memory_resource> are available only with C++17 or later."))
 #else // ^^^ !_HAS_CXX17 / _HAS_CXX17 vvv
 #include <vector>
 #include <xbit_ops.h>

stl/inc/numbers

@@ -9,7 +9,7 @@
 #include <yvals_core.h>
 #if _STL_COMPILER_PREPROCESSOR
 #if !_HAS_CXX20
-#pragma message("The contents of <numbers> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <numbers> are available only with C++20 or later."))
 #else // ^^^ !_HAS_CXX20 / _HAS_CXX20 vvv
 #ifdef __cpp_lib_concepts
 #include <concepts>

stl/inc/optional

@@ -9,7 +9,7 @@
 #include <yvals.h>
 #if _STL_COMPILER_PREPROCESSOR
 #if !_HAS_CXX17
-#pragma message("The contents of <optional> are available only with C++17 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <optional> are available only with C++17 or later."))
 #else // ^^^ !_HAS_CXX17 / _HAS_CXX17 vvv
 #if _HAS_CXX20
 #include <compare>

stl/inc/ranges

@@ -9,7 +9,7 @@
 #include <yvals_core.h>
 #if _STL_COMPILER_PREPROCESSOR
 #ifndef __cpp_lib_ranges
-#pragma message("The contents of <ranges> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <ranges> are available only with C++20 or later."))
 #else // ^^^ !defined(__cpp_lib_ranges) / defined(__cpp_lib_ranges) vvv
 #include <__msvc_int128.hpp>
 #include <iosfwd>

stl/inc/semaphore

@@ -14,7 +14,7 @@
 #endif // _M_CEE_PURE
 
 #if !_HAS_CXX20
-#pragma message("The contents of <semaphore> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <semaphore> are available only with C++20 or later."))
 #else // ^^^ !_HAS_CXX20 / _HAS_CXX20 vvv
 
 #include <__msvc_chrono.hpp>

stl/inc/source_location

@@ -9,7 +9,8 @@
 #include <yvals_core.h>
 #if _STL_COMPILER_PREPROCESSOR
 #ifndef __cpp_consteval
-#pragma message("The contents of <source_location> are available only with C++20 consteval support.")
+#pragma message( \
+    _WARNING_MESSAGE("STL4038", "The contents of <source_location> are available only with C++20 consteval support."))
 #else // ^^^ !defined(__cpp_consteval) / defined(__cpp_consteval) vvv
 
 #include <cstdint>

stl/inc/span

@@ -10,7 +10,7 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX20
-#pragma message("The contents of <span> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <span> are available only with C++20 or later."))
 #else // ^^^ !_HAS_CXX20 / _HAS_CXX20 vvv
 #include <compare>
 #include <cstddef>

stl/inc/spanstream

@@ -9,7 +9,7 @@
 #include <yvals.h>
 #if _STL_COMPILER_PREPROCESSOR
 #if !_HAS_CXX23
-#pragma message("The contents of <spanstream> are available only with C++23 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <spanstream> are available only with C++23 or later."))
 #else // ^^^ !_HAS_CXX23 / _HAS_CXX23 vvv
 #ifdef __cpp_lib_concepts
 #include <concepts>

stl/inc/stacktrace

@@ -10,7 +10,7 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX23
-#pragma message("The contents of <stacktrace> are available only with C++23 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <stacktrace> are available only with C++23 or later."))
 #else // ^^^ !_HAS_CXX23 / _HAS_CXX23 vvv
 
 #include <cstdint>

stl/inc/stdatomic.h

@@ -22,7 +22,7 @@
 #endif // _M_CEE_PURE
 
 #if !_HAS_CXX23
-#pragma message("The contents of <stdatomic.h> are available only with C++23 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <stdatomic.h> are available only with C++23 or later."))
 #else // ^^^ !_HAS_CXX23 / _HAS_CXX23 vvv
 
 #include <atomic>

stl/inc/stop_token

@@ -10,7 +10,7 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX20
-#pragma message("The contents of <stop_token> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <stop_token> are available only with C++20 or later."))
 #else // ^^^ !_HAS_CXX20 / _HAS_CXX20 vvv
 
 #include <atomic>

stl/inc/string_view

@@ -10,7 +10,7 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX17
-#pragma message("The contents of <string_view> are available only with C++17 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <string_view> are available only with C++17 or later."))
 #else // ^^^ !_HAS_CXX17 / _HAS_CXX17 vvv
 #include <xstring>
 #endif // _HAS_CXX17

stl/inc/syncstream

@@ -9,7 +9,7 @@
 #include <yvals.h>
 #if _STL_COMPILER_PREPROCESSOR
 #if !_HAS_CXX20
-#pragma message("The contents of <syncstream> are available only with C++20 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <syncstream> are available only with C++20 or later."))
 #else // ^^^ !_HAS_CXX20 / _HAS_CXX20 vvv
 #include <memory>
 #include <ostream>

stl/inc/variant

@@ -10,7 +10,7 @@
 #if _STL_COMPILER_PREPROCESSOR
 
 #if !_HAS_CXX17
-#pragma message("The contents of <variant> are available only with C++17 or later.")
+#pragma message(_WARNING_MESSAGE("STL4038", "The contents of <variant> are available only with C++17 or later."))
 #else // ^^^ !_HAS_CXX17 / _HAS_CXX17 vvv
 #include <exception>
 #include <initializer_list>

stl/inc/yvals.h

@@ -230,8 +230,6 @@ _STL_DISABLE_CLANG_WARNINGS
 
 #include <use_ansi.h>
 
-#define _WARNING_MESSAGE(NUMBER, MESSAGE) __FILE__ "(" _CRT_STRINGIZE(__LINE__) "): warning " NUMBER ": " MESSAGE
-
 #ifdef _STATIC_CPPLIB
 #ifndef _DISABLE_DEPRECATE_STATIC_CPPLIB
 #ifdef _DLL

stl/inc/yvals_core.h

@@ -415,6 +415,8 @@
 #include <vcruntime.h>
 #include <xkeycheck.h> // The _HAS_CXX tags must be defined before including this.
 
+#define _WARNING_MESSAGE(NUMBER, MESSAGE) __FILE__ "(" _CRT_STRINGIZE(__LINE__) "): warning " NUMBER ": " MESSAGE
+
 #ifndef _STL_WARNING_LEVEL
 #if defined(_MSVC_WARNING_LEVEL) && _MSVC_WARNING_LEVEL >= 4
 #define _STL_WARNING_LEVEL 4
@@ -1187,7 +1189,11 @@
 #define _DEPRECATE_NONFLOATING_COMPLEX
 #endif // ^^^ warning disabled ^^^
 
-// next warning number: STL4038
+// STL4038 is used to warn that "The contents of <meow> are available only with C++NN or later."
+
+// STL4039 is used to warn that "The contents of <coroutine> are not available with /await."
+
+// next warning number: STL4040
 
 // P0619R4 Removing C++17-Deprecated Features
 #ifndef _HAS_FEATURES_REMOVED_IN_CXX20