最終更新日時: 2025年07月10日 10時26分30秒 (JST)
Koichi Murase が更新

履歴 編集

# UTF-8文字列リテラル [N2442](C++11)

このページはC++11に採用された言語機能の変更を解説しています。

のちのC++規格でさらに変更される場合があるため関連項目を参照してください。

## 概要

`char`の文字列リテラルに`u8`プレフィックスを付けることで、その文字列リテラルはUCS/Unicode文字コードのUTF-8符号化形式にエンコードされる。

    // 変数sには、UTF-8エンコーディングされた「あいうえお」という文字列が代入される
    char s[] = u8"あいうえお";

    // 文字列中にユニバーサルキャラクタ名を直接入力できる。
    // \uからはじめて4桁、もしくは\Uからはじめて8桁がユニバーサルキャラクタ名として扱われる。
    char t[] = u8"\U00020BB7野家"; // 𠮷野家

`u8`プレフィックスを指定しない場合は、実装定義のマルチバイト文字コードにエンコードされる。その実装定義の文字コードは、ASCII文字コードと互換があることは保証されない。そのため、UTF-8のASCII互換部分が、実装定義の文字コードと互換があることも、保証されない。

C++20ではUTF-8文字リテラルの型が`const char[N]`ではなく`const char8_t[N]`になる

## 仕様

- 文字列リテラルに`u8`プレフィックスを付けることで、UTF-8にエンコードされた`char`型の配列に初期化される。

- UTF-8の文字列リテラルとワイド文字列リテラルが隣接していた場合、文字列は連結されずに、プログラムは不適格となる。

      wchar_t ws[] = "hello" L" world";     // OK : L"hello world"
      //wchar_t ws[] = u8"hello" L" world"; // コンパイルエラー！

- 文字列リテラルのなかには、UCS／Unicodeのユニバーサルキャラクタ名を直接記述できる。たとえば、UTF-8文字列リテラル`u8"\u215A"`はU+215Aコードポイントを含む文字列である`"⅚"` (VULGAR FRACTION FIVE SIXTHS) を表す。`\u`の場合は16進数で4桁固定のユニバーサルキャラクタ名を、`\U`の場合は16進数で8桁固定のユニバーサルキャラクタ名を記述する。

- 文字リテラルに`u8`プレフィックスは使用できない。

### 参照するUCSの規格

C++11時点の規格では、UCS (Universal Coded Character Set) の規格としてISO/IEC 10646-1:1993を参照する。

## 備考

C++11時点での標準ライブラリでは、文字列と整数の変換を行う関数、および入出力の機能は、UTF-8に対応していない。そのため、システムのマルチバイト文字コードに変換する必要がある。たとえば、コンソール、ターミナル、コマンドプロンプトといった標準出力の出力先にUTF-8で直接出力できない場合には、出力可能な文字コードに変換する必要がある。そのシステムのマルチバイト文字コードがUTF-8であれば、変換の必要はない。

## 例

    #include <iostream>
    #include <string>

    int main()
    {
      std::string s = u8"あいうえお";

      // バイト数を取得
      // UTF-8のため、ひとつのコードポイント(≒文字)のバイト数は固定ではない
      std::size_t byte_size = s.size();

      std::cout << byte_size << std::endl;
    }

### 出力

    15

## 関連項目

- C++11 `char16_t`と`char32_t`
- C++17 UTF-8文字リテラル
- C++20 UTF-8エンコーディングされた文字の型として`char8_t`を追加
- C++20 `char16_t`と`char32_t`の文字・文字列リテラルを、文字コードUTF-16/32に規定
- ostream `operator<<`

## 参照

- N2146 Raw String Literals (Revision 1)
- N2159 UTF-8 String Literals
- N2209 UTF-8 String Literals
- N2295 Raw and Unicode String Literals; Unified Proposal
- N2384 Raw and Unicode String Literals; Unified Proposal (Rev. 1)
- N2442 Raw and Unicode String Literals; Unified Proposal (Rev. 2)