docs: Clarify which string comparison macros support wide strings

Fixes #4843

Clarifies that only EXPECT_STREQ and EXPECT_STRNE support wide C strings (wchar_t*). The case-insensitive variants EXPECT_STRCASEEQ and EXPECT_STRCASENE do not support wide strings.
This commit is contained in:
Manjiro Sano 2025-11-20 19:58:35 +05:30 committed by GitHub
parent 1b96fa13f5
commit bfa18a8ae8
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -222,8 +222,10 @@ Verifies that *`val1`*`>=`*`val2`*.
The following assertions compare two **C strings**. To compare two `string`
objects, use [`EXPECT_EQ`](#EXPECT_EQ) or [`EXPECT_NE`](#EXPECT_NE) instead.
These assertions also accept wide C strings (`wchar_t*`). If a comparison of two
wide strings fails, their values will be printed as UTF-8 narrow strings.
`EXPECT_STREQ` and `EXPECT_STRNE` also accept wide C strings (`wchar_t*`).
Case-insensitive variants (`EXPECT_STRCASEEQ` and `EXPECT_STRCASENE`) currently do not
support wide C strings. If a comparison of two wide strings fails, their values will be
printed as UTF-8 narrow strings.
To compare a C string with `NULL`, use `EXPECT_EQ(`*`c_string`*`, nullptr)` or
`EXPECT_NE(`*`c_string`*`, nullptr)`.