std::ctype<CharT>::narrow, do_narrow

 

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: char narrow( CharT c, char dflt ) const;	(1)
public: const CharT* narrow( const CharT* beg, const CharT* end,                      char dflt, char* dst ) const;	(2)
protected: virtual char do_narrow( CharT c, char dflt ) const;	(3)
protected: virtual const CharT* do_narrow( const CharT* beg, const CharT* end,                                 char dflt, char* dst ) const;	(4)

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

3) (おそらくワイドな)文字cを、その文字が単一バイトで表現できる場合（例：UTF-8エンコーディングにおけるASCII文字は単一バイト）、マルチバイト表現に変換します。そのような変換が存在しない場合はdfltを返します。

4) 文字配列[beg, end)内の各文字について、ナローされた文字（またはナローリングに失敗した場合はdflt）を、dstが指す文字配列の連続する位置に書き込みます。

ナローリングは常に成功し、基本的なソース文字セット(C++23まで)基本的な文字セット(C++23以降) のすべての文字に対して、常に可逆的です（widen()を呼び出すことによって）。

• すなわち、基本的なソース文字セット(C++23まで)基本的な文字セット(C++23以降) の任意の文字cに対して、常に do_widen(do_narrow(c, 0)) == c が成り立ちます。

ナローリングは、成功した場合、is()によって知られているすべての文字分類カテゴリを保持します。

• すなわち、ctype<char>ファセットctcとctype_base::mask値mを持つ任意の名前付きctypeカテゴリについて、式 is(m, c) || !ctc.is(m, do_narrow(c, dflt)) は（do_narrowがdfltを返す場合を除き）常に true です。

任意の数字文字のナローリングは、結果を文字リテラル '0' から減算した場合、その差が元の文字の数字値に等しいことを保証します。

• すなわち、任意の数字文字cについて、式 (do_narrow(c, dflt) - '0') は、その文字の数字値に評価されます。

パラメータ

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

戻り値

1,3) ナローされた文字、またはナローリングが失敗した場合はdflt。

2,4) end

例

このコードを実行

#include <iostream>
#include <locale>
 
void try_narrow(const std::ctype<wchar_t>& f, wchar_t c)
{
    char n = f.narrow(c, 0);
    if (n)
        std::wcout << '\'' << c << "' narrowed to " << +(unsigned char)n << '\n';
    else
        std::wcout << '\'' << c << "' could not be narrowed\n";
}
 
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    std::wcout.imbue(std::locale());
    std::wcout << std::hex << std::showbase << "In US English UTF-8 locale:\n";
    auto& f = std::use_facet<std::ctype<wchar_t>>(std::locale());
    try_narrow(f, L'A');
    try_narrow(f, L'Ａ');
    try_narrow(f, L'ě');
 
    std::locale::global(std::locale("cs_CZ.iso88592"));
    auto& f2 = std::use_facet<std::ctype<wchar_t>>(std::locale());
    std::wcout << "In Czech ISO-8859-2 locale:\n";
    try_narrow(f2, L'A');
    try_narrow(f2, L'Ａ');
    try_narrow(f2, L'ě');
}

実行結果の例

In US English UTF-8 locale:
'A' narrowed to 0x41
'Ａ' could not be narrowed
'ě' could not be narrowed
In Czech ISO-8859-2 locale:
'A' narrowed to 0x41
'Ａ' could not be narrowed
'ě' narrowed to 0xec

不具合報告

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

DR	適用対象	公開された動作	正しい動作
LWG 126	C++98	1. 可逆性を示すコードは do_widen(do_narrow(c), 0) == c 2. カテゴリ保持性を示すコードは is(m, c) || !ctc.is(m, do_narrow(c), dflt)	両方とも修正されました。
LWG 153	C++98	narrowは常にオーバーロード(4)を呼び出していました。	対応するオーバーロードを呼び出します。

関連項目

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