std::c16rtomb

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (C++11)

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

ヌル終端マルチバイト文字列

関数 ワイド/マルチバイト文字の検査 mblen mbrlen mbsinit マルチバイト/ワイド文字変換 mbtowc mbstowcs btowc mbrtowc mbsrtowcs    wctomb wcstombs wctob wcrtomb wcsrtombs mbrtoc8 (C++20) mbrtoc16 (C++11) mbrtoc32 (C++11) c8rtomb (C++20) c16rtomb (C++11) c32rtomb (C++11)

型

mbstate_t

マクロ

MB_LEN_MAX MB_CUR_MAX __STDC_UTF_16__ __STDC_UTF_32__ (C++11)(C++11)

 

ヘッダー <cuchar> で定義
std::size_t c16rtomb( char* s, char16_t c16, std::mbstate_t* ps );		(C++11以降)

単一のコードポイントを、可変長16ビット文字表現（通常はUTF-16）から、ナローマルチバイト文字表現に変換します。

もしsがヌルポインタではなく、c16が有効な可変長エンコーディングのコードポイントの最後の16ビットコードユニットである場合、関数は、そのコードポイントのマルチバイト文字表現を格納するために必要なバイト数（シフトシーケンスを含み、現在のマルチバイト変換状態*psを考慮する）を決定し、sが指す文字配列にマルチバイト文字表現を格納し、必要に応じて*psを更新します。この関数によって最大MB_CUR_MAXバイトが書き込まれる可能性があります。

もしsがヌルポインタである場合、その呼び出しは、ある内部バッファbufに対するstd::c16rtomb(buf, u'\0', ps)と同等です。

もしc16がワイド文字の16ビット表現の最終コードユニットでない場合、sが指す配列には何も書き込まず、*psのみが更新されます。

もしc16がヌルワイド文字u'\0'である場合、初期シフト状態を復元するために必要なシフトシーケンスに先行するヌルバイトが格納され、変換状態パラメータ*psは初期シフト状態を表すように更新されます。

この関数が使用するマルチバイトエンコーディングは、現在アクティブなCロケールによって指定されます。

パラメータ

s	-	マルチバイト文字が格納される狭い文字配列へのポインタ
c16	-	変換する16ビット文字
ps	-	マルチバイト文字列を解釈する際に使用される変換状態オブジェクトへのポインタ

戻り値

成功した場合、sが指す文字配列に書き込まれたバイト数（シフトシーケンスを含む）を返します。この値は​0​になることもあります。例えば、サロゲートペアの最初のchar16_tを処理している場合などです。

失敗した場合（c16が無効な16ビット文字である場合）、-1を返し、EILSEQをerrnoに格納し、*psを未指定の状態のままにします。

注記

C++標準では、この関数のセマンティクスについてC標準を参照します。発行されたC11では、可変幅マルチバイト（UTF-8など）を可変幅16ビット（UTF-16など）エンコーディングに変換するstd::mbrtoc16とは異なり、この関数は単一ユニットの16ビットエンコーディングのみを変換でき、この関数の本来の意図にもかかわらずUTF-16からUTF-8への変換はできません。これは、C11以降の不具合報告DR488によって修正されました。

例

この例では、不具合報告488の修正が適用されていることを前提としています。

このコードを実行

#include <climits>
#include <clocale>
#include <cuchar>
#include <iomanip>
#include <iostream>
#include <string_view>
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::u16string_view strv = u"zß水🍌"; // or z\u00df\u6c34\U0001F34C
    std::cout << "Processing " << strv.size() << " UTF-16 code units: [ ";
    for (char16_t c : strv)
        std::cout << std::showbase << std::hex << static_cast<int>(c) << ' ';
    std::cout << "]\n";
 
    std::mbstate_t state{};
    char out[MB_LEN_MAX]{};
    for (char16_t c : strv)
    {
        std::size_t rc = std::c16rtomb(out, c, &state);
        std::cout << static_cast<int>(c) << " converted to [ ";
        if (rc != (std::size_t) - 1)
            for (unsigned char c8 : std::string_view{out, rc})
                std::cout << +c8 << ' ';
        std::cout << "]\n";
    }
}

出力

Processing 5 UTF-16 code units: [ 0x7a 0xdf 0x6c34 0xd83c 0xdf4c ]
0x7a converted to [ 0x7a ]
0xdf converted to [ 0xc3 0x9f ]
0x6c34 converted to [ 0xe6 0xb0 0xb4 ]
0xd83c converted to [ ]
0xdf4c converted to [ 0xf0 0x9f 0x8d 0x8c ]

関連項目

mbrtoc16 (C++11)	ナローマルチバイト文字をUTF-16エンコーディングに変換する (関数)
c8rtomb (C++20)	UTF-8文字列をナローマルチバイトエンコーディングに変換する (関数)
do_out [virtual]	ファイルへの書き込み時など、InternT から ExternT への文字列を変換します。 (std::codecvt<InternT,ExternT,StateT> の virtual protected メンバ関数)
Cドキュメント c16rtomb