String literal

構文

説明

上記の表にリストされている型において、 N はエンコードされたコード単位の数であり、これは 以下 で決定されます。

通常の およびUTF-8 (C++11以降) 文字列リテラルは、まとめてナロー文字列リテラルと呼ばれます。

文字列リテラルを評価すると、静的 ストレージ期間 を持つ文字列リテラルオブジェクトが生成されます。すべての文字列リテラルが 非重複オブジェクト に格納されるかどうか、および連続する文字列リテラルの評価が同じオブジェクトを返すか異なるオブジェクトを返すかは未規定です。

文字列リテラルオブジェクトを変更しようとする効果は未定義です。

bool b = "bar" == 3 + "foobar"; // true または false の可能性あり、未規定
const char* pc = "Hello";
char* p = const_cast<char*>(pc);
p[0] = 'M'; // 未定義動作

// OK: contains one backslash,
// equivalent to "\\"
R"(\)";
// OK: contains four \n pairs,
// equivalent to "\\n\\n\\n\\n"
R"(\n\n\n\n)";
// OK: contains one close-parenthesis, two double-quotes and one open-parenthesis,
// equivalent to ")\"\"("
R"-()""()-";
// OK: equivalent to "\n)\\\na\"\"\n"
R"a(
)\
a""
)a";
// OK: equivalent to "x = \"\"\\y\"\""
R"(x = ""\y"")";
// R"<<(-_-)>>"; // Error: begin and end delimiters do not match
// R"-()-"-()-"; // Error: )-" appears in the middle and terminates the literal

初期化

文字列リテラルオブジェクトは、文字列リテラルのシーケンスに対応するコード単位値のシーケンスで初期化されます： s-char s および r-char s (C++11以降) 、さらに終端のヌル文字 (U+0000) が順に付加されます：

連結 (Concatenation)

隣接する文字列リテラルは、 translation phase 6 （プリプロセス後）で連結されます：

• 二つの文字列リテラルが同じ 種類 である場合、連結された文字列リテラルもその種類になります。

"Hello, " "world!" // フェーズ6で、2つの文字列リテラルが "Hello, world!" を形成
L"Δx = %" PRId16   // フェーズ4で、PRId16は "d" に展開される
                   // フェーズ6で、L"Δx = %" と "d" が L"Δx = %d" を形成

1. ↑ そのような連結をサポートする既知の実装はありません。

未評価文字列

以下のコンテキストでは文字列リテラルが期待されますが、評価は行われません:

• language linkage 仕様

注記

文字列リテラルは 文字配列の初期化 に使用できます。配列が char str [ ] = "foo" ; のように初期化された場合、 str は文字列 "foo" のコピーを含むことになります。

文字列リテラルは必ずしもnull終端文字シーケンスではありません：文字列リテラルに埋め込まれたnull文字がある場合、それは複数の文字列を含む配列を表します。

const char* p = "abc\0def"; // std::strlen(p) == 3、ただし配列のサイズは8

文字列リテラル内で16進数エスケープシーケンスの後に有効な16進数桁が続く場合、無効なエスケープシーケンスとしてコンパイルに失敗します。文字列連結を回避策として使用できます：

//const char* p = "\xfff"; // エラー: 16進数エスケープシーケンスが範囲外
const char* p = "\xff""f"; // OK: リテラルは {'\xff','f','\0'} を保持する const char[3]

例

#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"; // OK, 以下と同じ
const wchar_t* s5 = L"ABCDEF";
const char32_t* s6 = U"GHI" "JKL"; // OK, 以下と同じ
const char32_t* s7 = U"GHIJKL";
const char16_t* s9 = "MN" u"OP" "QR"; // OK, 以下と同じ
const char16_t* sA = u"MNOPQR";
// const auto* sB = u"Mixed" U"Types";
        // C++23 以前は実装によってサポートされる場合とされない場合がある;
        // C++23 以降は不適格
const wchar_t* sC = LR"--(STUV)--"; // OK, raw string literal
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は後にDRとして採択され、この解決策を上書きしました。

参考文献

関連項目