std::ctype<CharT>::widen, do_widen

 

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)

 

ローカライズライブラリ

ロケールとファセット   ロケール has_facet use_facet locale ファセットカテゴリ 基底クラス ctype_base codecvt_base messages_base time_base money_base ctypeファセット ctype ctype<char> ctype_byname codecvt codecvt_byname 数値ファセット num_get num_put numpunct numpunct_byname 文字比較ファセット collate collate_byname 時間ファセット time_get time_put time_get_byname time_put_byname

通貨ファセット money_get money_put moneypunct moneypunct_byname メッセージファセット messages messages_byname 文字の分類と変換 文字の分類 isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph 文字変換 toupper    tolower 文字列とストリームの変換 wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/26*) Unicode変換ファセット codecvt_utf8 (C++11/17/26*) codecvt_utf16 (C++11/17/26*) codecvt_utf8_utf16 (C++11/17/26*) codecvt_mode (C++11/17/26*) Cライブラリのロケール LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME    setlocale localeconv lconv

 

std::ctype

メンバ関数

ctype::ctype

ctype::~ctype

ctype::isctype::do_is

ctype::scan_isctype::do_scan_is

ctype::scan_notctype::do_scan_not

ctype::toupperctype::do_toupper

ctype::tolowerctype::do_tolower

ctype::widenctype::do_widen

ctype::narrowctype::do_narrow

ctype<char> のメンバ関数

ctype<char>::ctype

ctype<char>::~ctype

ctype<char>::table

ctype<char>::classic_table

ctype<char>::is

ctype<char>::scan_is

ctype<char>::scan_not

 

ヘッダー <locale> で定義
public: CharT widen( char c ) const;	(1)
public: const char* widen( const char* beg, const char* end, CharT* dst ) const;	(2)
protected: virtual CharT do_widen( char c ) const;	(3)
protected: virtual const char* do_widen( const char* beg, const char* end, CharT* dst ) const;	(4)

1,2) 公開メンバ関数。最も派生したクラスの対応する保護仮想メンバ関数do_widenオーバーロードを呼び出します。オーバーロード(1)はdo_widen(c)を呼び出し、オーバーロード(2)はdo_widen(beg, end, dst)を呼び出します。

3) 単一バイト文字cを、最も単純で合理的な変換を使用して、対応するワイド文字表現に変換します。通常、これはマルチバイトエンコーディングが単一バイトである文字（例: UTF-8のU+0000-U+007F）にのみ適用されます。

4) 文字配列[beg, end)内の各文字について、対応するワイド化された文字を、dstが指す文字配列の連続した場所に書き込みます。

ワイド化は常にワイド文字を返しますが、基本的なソース文字セット(C++23まで)基本的な文字セット(C++23以降)からの文字のみが一意で明確に定義されたワイド化変換を持つことが保証されており、それはまたnarrow()による逆変換も保証されています。実際には、マルチバイト表現が単一バイトであるすべての文字は通常、対応するワイド文字にワイド化され、可能な単一バイト値の残りは通常、同じプレースホルダ値、通常はCharT(-1)にマッピングされます。

ワイド化は、成功した場合、is()に知られているすべての文字分類カテゴリを保持します。

パラメータ

c	-	変換する文字
dflt	-	変換が失敗した場合に生成されるデフォルト値
beg	-	変換する文字配列の最初の文字へのポインタ
end	-	変換する文字配列の終端の次を指すポインタ
dst	-	埋め込む文字配列の最初の要素へのポインタ

戻り値

1,3) ワイド化された文字。

2,4) end

例

このコードを実行

#include <iostream>
#include <locale>
 
void try_widen(const std::ctype<wchar_t>& f, char c)
{
    wchar_t w = f.widen(c);
    std::cout << "The single-byte character " << +(unsigned char)c
              << " widens to " << +w << '\n';
}
 
int main()
{
    std::locale::global(std::locale("cs_CZ.iso88592"));
    auto& f = std::use_facet<std::ctype<wchar_t>>(std::locale());
    std::cout << std::hex << std::showbase << "In Czech ISO-8859-2 locale:\n";
    try_widen(f, 'a');
    try_widen(f, '\xdf'); // German letter ß (U+00df) in ISO-8859-2
    try_widen(f, '\xec'); // Czech letter ě (U+011b) in ISO-8859-2
 
    std::locale::global(std::locale("cs_CZ.utf8"));
    auto& f2 = std::use_facet<std::ctype<wchar_t>>(std::locale());
    std::cout << "In Czech UTF-8 locale:\n";
    try_widen(f2, 'a');
    try_widen(f2, '\xdf'); 
    try_widen(f2, '\xec'); 
}

実行結果の例

In Czech ISO-8859-2 locale:
The single-byte character 0x61 widens to 0x61
The single-byte character 0xdf widens to 0xdf
The single-byte character 0xec widens to 0x11b
In Czech UTF-8 locale:
The single-byte character 0x61 widens to 0x61
The single-byte character 0xdf widens to 0xffffffff
The single-byte character 0xec widens to 0xffffffff

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 153	C++98	widenは常にオーバーロード(4)を呼び出す	対応するオーバーロードを呼び出す

関連項目

narrow	do_narrowを呼び出します。 (公開メンバ関数)
widen	文字をワイド化する (std::basic_ios<CharT,Traits> の public メンバ関数)
btowc	可能であれば、1バイトのナロー文字をワイド文字にワイド化する (関数)