GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing cpprefjp.github.io — std::text_encoding - cpprefjp C++日本語リファレンス

最終更新日時: 2026年03月26日 11時50分04秒 (JST)
Akira Takahashi が更新

class

<text_encoding>

std::text_encoding(C++26)

namespace std {
  struct text_encoding;
}

概要

std::text_encodingクラスは、IANA文字集合レジストリに基づいてテキストエンコーディングを識別するクラスである。エンコーディング名、MIB番号（Management Information Base enumeration）、およびエイリアスによるエンコーディングの識別・比較機能を提供する。

このクラスは、ロケールに依存せずにエンコーディングを取得・比較する手段を提供する。従来のC++ではエンコーディング情報はロケール経由でしか取得できなかったが、std::text_encodingはロケールとは独立して動作する。

literal()はconsteval関数であり、コンパイル時にリテラルエンコーディングを取得できる
environment()はsetlocale()の影響を受けず、プログラム起動時の環境エンコーディングを返す
environment_is()により、特定のエンコーディングかどうかを効率的に判定できる

std::text_encodingはトリビアルコピー可能な型であり、例外を送出しない。CHAR_BIT == 8が要求される。

IANAに登録されていないエンコーディングも、id::otherとして名前で管理できる。

メンバ関数

構築

名前	説明	対応バージョン
`(constructor)`	コンストラクタ	C++26

観測

名前	説明	対応バージョン
`mib`	MIB列挙値の取得	C++26
`name`	エンコーディング名の取得	C++26
`aliases`	エイリアス一覧の取得	C++26

静的メンバ関数

名前	説明	対応バージョン
`literal`	リテラルエンコーディングの取得	C++26
`environment`	環境エンコーディングの取得	C++26
`environment_is`	環境エンコーディングが指定したエンコーディングかを判定	C++26

メンバ型

名前	説明	対応バージョン
`id`	MIB列挙型 (enum class)	C++26
`aliases_view`	エイリアスのビュー (class)	C++26

メンバ定数

名前	説明	対応バージョン
`static constexpr size_t max_name_length = 63;`	エンコーディング名の最大長	C++26

非メンバ関数

名前	説明	対応バージョン
`operator==`	等値比較	C++26
`operator!=`	非等値比較 (`==`により使用可能)	C++26

ハッシュサポート

名前	説明	対応バージョン
`template<> struct hash<text_encoding>`	`hash`の特殊化	C++26

説明専用メンバ

名前	説明
`id mib_ = id::unknown;`	MIB値を保持する
`char name_[max_name_length + 1] = {0};`	エンコーディング名を保持する
`comp-name`	エンコーディング名の比較（Unicode Technical Standard #22準拠）

例

エンコーディング情報の表示

#include <text_encoding>
#include <print>

void print(const std::text_encoding& enc) {
  std::println("{} (IANA MIB: {})", enc.name(), static_cast<int>(enc.mib()));
  std::println("Aliases:");
  for (auto&& alias : enc.aliases()) {
    std::println("  {}", alias);
  }
}

int main() {
  std::println("Literal encoding: ");
  ::print(std::text_encoding::literal());

  std::println("Environment encoding: ");
  ::print(std::text_encoding::environment());
}

出力例

Literal encoding: UTF-8 (IANA MIB: 106)
Aliases:
  UTF-8
  csUTF8
Environment encoding: UTF-8 (IANA MIB: 106)
Aliases:
  UTF-8
  csUTF8

エンコーディング名の指定

#include <text_encoding>
#include <cassert>
#include <string_view>

int main() {
  using namespace std::string_view_literals;

  // エンコーディング名から構築
  std::text_encoding my_utf8{"utf8"};
  assert(my_utf8.name() == "utf8"sv);
  assert(my_utf8.mib() == std::text_encoding::id::UTF8);

  // MIB値から構築
  std::text_encoding my_utf8_2{std::text_encoding::id::UTF8};
  assert(my_utf8_2.mib() == std::text_encoding::id::UTF8);

  // 異なる名前でも同じエンコーディングなら等値
  assert(my_utf8 == my_utf8_2);

  // 未登録のエンコーディングもサポート
  std::text_encoding wtf8{"WTF-8"};
  assert(wtf8.name() == "WTF-8"sv);
  assert(wtf8.mib() == std::text_encoding::id::other);
  // otherのMIBを持つエンコーディングは名前で比較される
  assert(wtf8 == std::text_encoding{"___wtf8__"});
}

出力

バージョン

言語

C++26

処理系

Clang: ??
GCC: 15 ✅
Visual C++: ??

参照

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.