Avi Kivity e27cc20bd9
Format enums annotated with fmt::as_identifiers (requires C++26 reflection) (#4885)
* Format enums annotated with fmt::as_identifiers (requires C++26 reflection)

Format an enum as the identifier of the matching enumerator if the enum is
annotated with fmt::as_identifiers:

  enum class [[=fmt::as_identifiers]] color { red, green, blue };
  fmt::format("{}", color::green);  // "green"

Values that don't match any enumerator are represented as their underlying
value in decimal before applying string formatting.

Identifiers are retrieved via C++26 reflection (P2996) and the annotation
via P3394. FMT_USE_REFLECTION is autodetected and can be overridden by the
user; without reflection the header is empty.

The header is also part of the fmt module, but, unlike with headers, whether
it provides anything is decided when the module is compiled, so the module
build detects reflection and enables it if the configured standard allows.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Look up enum identifiers by index when the values are dense

The formatter for enums annotated with fmt::as_identifiers did a linear
search over all enumerators. Build a table indexed by the distance from
the smallest enumerator value instead, with empty string views in the
holes, which reduces the lookup to a bounds check and one load.

The table is only used if at least 70% of its elements are identifiers,
limiting its size to 10/7 of the number of enumerators. Sparser enums
keep using the linear search. Distances are computed in uint64_t so that
enums with negative values and values spanning the whole range of the
underlying type are handled without overflow.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Suppress -Wsfinae-incomplete in format-test on GCC 16

GCC 16 warns when a type is completed after it failed to be complete in a
SFINAE context. format-test does this deliberately to check that formatting
of incomplete types works, so the warning is a false positive there and
breaks the build with -Werror.

* Test GCC 16 on CI

GCC 16 is the first compiler with C++26 reflection support, which is needed
by fmt/enum.h, so add a job that builds with it in C++26 mode. It comes from
the ubuntu-toolchain-r/test PPA since Ubuntu 24.04 only ships GCC 14.

Also report when reflection is not detected to make it visible that
enum-test was skipped.

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-23 09:31:28 -07:00
..
add-subdirectory-test Apply clang-format 2026-07-23 13:10:37 -07:00
compile-error-test Avoid dropping null byte in format string (#4732) 2026-04-23 09:34:27 -07:00
cuda-test Apply cmake-format 2026-03-03 15:49:40 -08:00
find-package-test Bump tested CMake version to 3.25 2022-11-30 08:09:32 -08:00
fuzzing Apply cmake-format 2026-03-03 15:49:40 -08:00
gtest Apply cmake-format 2026-03-03 15:49:40 -08:00
static-export-test Bump tested CMake version to 3.25 2022-11-30 08:09:32 -08:00
args-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
assert-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
base-test.cc Simplify test 2026-06-26 12:29:26 -07:00
c-test.c Add a test for fmt_print 2026-06-08 08:18:43 +02:00
chrono-test.cc fix out-of-range float to int conversion in to_nonnegative_int (#4802) 2026-06-16 23:14:58 -07:00
CMakeLists.txt Format enums annotated with fmt::as_identifiers (requires C++26 reflection) (#4885) 2026-08-23 09:31:28 -07:00
color-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
compile-test.cc Handle const-qualified named arguments 2026-07-29 09:20:23 -07:00
detect-stdfs.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
enforce-checks-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
enum-test.cc Format enums annotated with fmt::as_identifiers (requires C++26 reflection) (#4885) 2026-08-23 09:31:28 -07:00
format-impl-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
format-test.cc Format zero as 0x0p+0 in hexfloat (#4878) 2026-08-10 09:52:03 -07:00
gtest-extra-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
gtest-extra.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
gtest-extra.h Unify copyright notices 2026-05-31 08:54:06 -07:00
header-only-test.cc Add base.h 2024-01-09 19:36:12 -08:00
mock-allocator.h Unify copyright notices 2026-05-31 08:54:06 -07:00
module-test.cc Format enums annotated with fmt::as_identifiers (requires C++26 reflection) (#4885) 2026-08-23 09:31:28 -07:00
no-builtin-types-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
noexception-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
os-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
ostream-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
perf-sanity.cc Cleanup test 2024-07-17 06:59:24 -07:00
posix-mock-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
posix-mock.h Unify copyright notices 2026-05-31 08:54:06 -07:00
printf-test.cc fix out-of-bounds read in basic_format_args::get (#4800) 2026-06-09 22:18:35 -07:00
ranges-odr-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
ranges-test.cc Fix ambiguous formatter<std::optional<T>> between fmt/std.h and fmt/ranges.h on C++26 (P3168R2) (#4761) 2026-05-03 07:37:46 -07:00
scan-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
scan.h Unify copyright notices 2026-05-31 08:54:06 -07:00
std-test.cc Reject sign-aware zero padding in std::exception and error_code formatters 2026-08-16 10:00:41 -07:00
test-assert.h Unify copyright notices 2026-05-31 08:54:06 -07:00
test-main.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
unicode-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
util.cc Unify copyright notices 2026-05-31 08:54:06 -07:00
util.h Unify copyright notices 2026-05-31 08:54:06 -07:00
xchar-test.cc Unify copyright notices 2026-05-31 08:54:06 -07:00