std::ctype<char>

 

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

 

ヘッダー <locale> で定義
template<> class ctype<char>;

このstd::ctypeの特殊化は、型charの文字分類機能をカプセル化します。仮想関数を使用する汎用std::ctypeとは異なり、この特殊化はテーブルルックアップを使用して文字を分類します（一般的に高速です）。

基底クラスstd::ctype<char>は、最小限の「C」ロケールに相当する文字分類を実装します。非デフォルトの分類テーブル引数で構築された場合、またはstd::ctype_byname<char>として、またはユーザー定義の派生ファセットとして構築された場合、分類ルールは拡張または変更される可能性があります。すべてのstd::istreamの書式付き入力関数は、入力解析中の文字分類にstd::ctype<char>を使用する必要があります。

継承図

ネストされた型

型	定義
char_type	char

データメンバー

メンバ	説明
std::locale::id id [static]	ファセットの識別子
const std::size_t table_size [static]	分類テーブルのサイズ、少なくとも256

メンバー関数

(コンストラクタ)	新しいctype<char>ファセットを構築します。 (public member function)
(デストラクタ)	ctype<char>ファセットを破棄します。 (protected member function)
テーブル	文字分類テーブルを取得します。 (public member function)
classic_table [static]	「C」ロケールの文字分類テーブルを取得します。 (public static member function)
is	分類テーブルを使用して、文字または文字シーケンスを分類します。 (public member function)
scan_is	分類テーブルを使用して、指定された分類に適合するシーケンス内の最初の文字を検索します。 (public member function)
scan_not	分類テーブルを使用して、指定された分類に失敗するシーケンス内の最初の文字を検索します。 (public member function)
toupper	do_toupperを呼び出します。 (public member function of std::ctype<CharT>)
tolower	do_tolowerを呼び出します。 (public member function of std::ctype<CharT>)
widen	do_widenを呼び出します。 (public member function of std::ctype<CharT>)
narrow	do_narrowを呼び出します。 (public member function of std::ctype<CharT>)

protectedメンバー関数

do_toupper [virtual]	文字または文字を大文字に変換します。 (virtual protected member function of std::ctype<CharT>)
do_tolower [virtual]	文字または文字を小文字に変換します。 (virtual protected member function of std::ctype<CharT>)
do_widen [virtual]	charからCharTへ文字または文字を変換します。 (virtual protected member function of std::ctype<CharT>)
do_narrow [virtual]	CharTからcharへ文字または文字を変換します。 (virtual protected member function of std::ctype<CharT>)

std::ctype_baseから継承

ネストされた型

型	定義
mask	未指定のBitmaskType型（列挙型、整数型、またはビットセット）

メンバ定数

スペース [static]	空白文字の分類を識別するmaskの値 (公開静的メンバ定数)
print [static]	印刷可能文字の分類を識別するmaskの値 (公開静的メンバ定数)
cntrl [static]	制御文字の分類を識別するmaskの値 (公開静的メンバ定数)
upper [static]	大文字の分類を識別するmaskの値 (公開静的メンバ定数)
lower [static]	小文字の分類を識別するmaskの値 (公開静的メンバ定数)
alpha [static]	アルファベット文字の分類を識別するmaskの値 (公開静的メンバ定数)
digit [static]	数字文字の分類を識別するmaskの値 (公開静的メンバ定数)
punct [static]	句読点文字の分類を識別するmaskの値 (公開静的メンバ定数)
xdigit [static]	16進数数字の分類を識別するmaskの値 (公開静的メンバ定数)
blank [static] (C++11)	空白文字の分類を識別するmaskの値 (公開静的メンバ定数)
alnum [static]	alpha | digit (公開静的メンバ定数)
graph [static]	alnum | punct (公開静的メンバ定数)

例

次の例は、コンマ区切り値をトークン化するためにctype<char>を変更する方法を示しています。

このコードを実行

#include <cstddef>
#include <iostream>
#include <locale>
#include <sstream>
#include <vector>
 
// This ctype facet classifies commas and endlines as whitespace
struct csv_whitespace : std::ctype<char>
{
    static const mask* make_table()
    {
        // make a copy of the "C" locale table
        static std::vector<mask> v(classic_table(), classic_table() + table_size);
        v[','] |=  space; // comma will be classified as whitespace
        v[' '] &= ~space; // space will not be classified as whitespace
        return &v[0];
    }
 
    csv_whitespace(std::size_t refs = 0) : ctype(make_table(), false, refs) {}
};
 
int main()
{
    std::string in = "Column 1,Column 2,Column 3\n123,456,789";
    std::string token;
 
    std::cout << "Default locale:\n";
    std::istringstream s1(in);
    while (s1 >> token)
        std::cout << "  " << token << '\n';
 
    std::cout << "Locale with modified ctype:\n";
    std::istringstream s2(in);
    s2.imbue(std::locale(s2.getloc(), new csv_whitespace));
    while (s2 >> token)
        std::cout << "  " << token << '\n';
}

出力

Default locale:
  Column
  1,Column
  2,Column
  3
  123,456,789
Locale with modified ctype:
  Column 1
  Column 2
  Column 3
  123
  456
  789

不具合報告

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

DR	適用対象	公開された動作	正しい動作
LWG 695	C++98	table()とclassic_table()はprotectedメンバー関数でした。	それらをpublicにしました。

関連項目

ctype	文字分類テーブルを定義する (クラステンプレート)
ctype_base	文字分類カテゴリを定義する (クラス)
ctype_byname	名前付きロケールに対してシステムが提供する std::ctype を表す (クラステンプレート)