String literal

语法

说明

在上表列出的类型中， N 表示已编码代码单元的数量，其确定方式详见 下文 。

普通 和 UTF-8 (since C++11) 字符串字面量统称为窄字符串字面量。

对字符串字面量的求值会产生一个具有静态 存储期 的字符串字面量对象。是否所有字符串字面量都存储在 互不重叠的对象 中，以及连续对同一字符串字面量的求值会得到相同对象还是不同对象，均未作规定。

尝试修改字符串字面量对象的效果是未定义的。

bool b = "bar" == 3 + "foobar"; // 结果可能为 true 或 false，未定义行为
const char* pc = "Hello";
char* p = const_cast<char*>(pc);
p[0] = 'M'; // 未定义行为

// OK: 包含一个反斜杠，
// 等价于 "\\"
R"(\)";
// OK: 包含四个 \n 对，
// 等价于 "\\n\\n\\n\\n"
R"(\n\n\n\n)";
// OK: 包含一个右括号、两个双引号和一个左括号，
// 等价于 ")\"\"("
R"-()""()-";
// OK: 等价于 "\n)\\\na\"\"\n"
R"a(
)\
a""
)a";
// OK: 等价于 "x = \"\"\\y\"\""
R"(x = ""\y"")";
// R"<<(-_-)>>"; // 错误：起始和结束定界符不匹配
// R"-()-"-()-"; // 错误：)-" 出现在中间并终止了字面量

初始化

字符串字面量对象按照以下顺序，使用对应字符串字面量中 s-char 序列 和 r-char 序列 (C++11 起) 的代码单元值序列进行初始化，并附加终止空字符 (U+0000)：

连接

相邻的字符串字面量会在 翻译阶段6 （预处理之后）进行连接：

• 如果两个字符串字面量属于同一 类别 ，则拼接后的字符串字面量也属于该类别。

"Hello, " "world!" // 在第6阶段，两个字符串字面量组成 "Hello, world!"
L"Δx = %" PRId16   // 在第4阶段，PRId16 扩展为 "d"
                   // 在第6阶段，L"Δx = %" 和 "d" 组成 L"Δx = %d"

1. ↑ 目前没有已知的实现支持此类连接。

未求值字符串

以下上下文期望字符串字面量，但不进行求值：

• 语言链接 规范

注释

字符串字面量可用于 初始化字符数组 。若数组以 char str [ ] = "foo" ; 形式初始化，则 str 将包含字符串 "foo" 的副本。

字符串字面量不一定是空终止字符序列：如果字符串字面量包含嵌入的空字符，它表示包含多个字符串的数组。

const char* p = "abc\0def"; // std::strlen(p) == 3，但该数组的大小为8

如果在字符串字面值中，十六进制转义序列后紧跟一个有效的十六进制数字，会导致编译失败，因为会被视为无效的转义序列。可以使用字符串连接作为解决方案：

//const char* p = "\xfff"; // 错误：十六进制转义序列超出范围
const char* p = "\xff""f"; // 正确：该字面量为 const char[3] 类型，包含 {'\xff','f','\0'}

示例

#include <iostream>
// array1 和 array2 包含相同的值：
char array1[] = "Foo" "bar";
char array2[] = {'F', 'o', 'o', 'b', 'a', 'r', '\0'};
const char* s1 = R"foo(
Hello
  World
)foo";
// 等同于
const char* s2 = "\nHello\n  World\n";
// 等同于
const char* s3 = "\n"
                 "Hello\n"
                 "  World\n";
const wchar_t* s4 = L"ABC" L"DEF"; // 正确，等同于
const wchar_t* s5 = L"ABCDEF";
const char32_t* s6 = U"GHI" "JKL"; // 正确，等同于
const char32_t* s7 = U"GHIJKL";
const char16_t* s9 = "MN" u"OP" "QR"; // 正确，等同于
const char16_t* sA = u"MNOPQR";
// const auto* sB = u"Mixed" U"Types";
        // C++23 之前可能由实现支持也可能不支持；
        // 自 C++23 起格式错误
const wchar_t* sC = LR"--(STUV)--"; // 正确，原始字符串字面量
int main()
{
    std::cout << array1 << ' ' << array2 << '\n'
              << s1 << s2 << s3 << std::endl;
    std::wcout << s4 << ' ' << s5 << ' ' << sC
               << std::endl;
}

Foobar Foobar
Hello
  World
Hello
  World
Hello
  World
ABCDEF ABCDEF STUV

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

1. ↑ P1854R4 后来被接受为缺陷报告，推翻了此项决议。

参考文献

参阅