From bfa18a8ae8de00b7a63938c1883d96423a9093e8 Mon Sep 17 00:00:00 2001 From: Manjiro Sano Date: Thu, 20 Nov 2025 19:58:35 +0530 Subject: [PATCH] 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. --- docs/reference/assertions.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/reference/assertions.md b/docs/reference/assertions.md index eeec4a0c4..9381c1268 100644 --- a/docs/reference/assertions.md +++ b/docs/reference/assertions.md @@ -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)`.