Namespaces
Variants

std::ctype <char> :: scan_is

From cppreference.net
ヘッダーで定義 <locale>
const char * scan_is ( mask m, const char * beg, const char * end ) const ;
(1)

文字配列 [ beg , end ) 内で分類マスク m を満たす最初の文字を検索します。つまり、 c が最初の文字であり、 table ( ) [ ( unsigned char ) c ] & m true を返すような文字です。

( unsigned char ) c >= std:: ctype < char > :: table_size の場合、実装定義の値が table ( ) [ ( unsigned char ) c ] の代わりに使用されます。この値は c の値ごとに異なる可能性があります。

目次

パラメータ

m - 検索対象のマスク
beg - 検索対象の文字配列の先頭文字へのポインタ
end - 検索対象の文字配列の終端の次を指すポインタ

戻り値

マスクを満たす [ beg , end ) 範囲内の最初の文字へのポインタ。そのような文字が見つからない場合は end を返す。

注記

プライマリテンプレート std:: ctype とは異なり、この特殊化は文字の分類時に仮想関数呼び出しを実行しません。動作をカスタマイズするには、派生クラスが基底クラスのコンストラクタに非デフォルトの分類テーブルを提供することができます。

#include <iostream>
#include <iterator>
#include <locale>
int main()
{
    std::locale loc("");
    auto& f = std::use_facet<std::ctype<char>>(loc);
    // 最初の文字が見つかるまでスキップ
    char s1[] = "      \t\t\n  Test";
    const char* p1 = f.scan_is(std::ctype_base::alpha, std::begin(s1), std::end(s1));
    std::cout << '\'' << p1 << "'\n";
    // 最初の文字が見つかるまでスキップ
    char s2[] = "123456789abcd";
    const char* p2 = f.scan_is(std::ctype_base::alpha, std::begin(s2), std::end(s2));
    std::cout << '\'' << p2 << "'\n";
}

出力:

'Test'
'abcd'

関連項目

[virtual]
シーケンス内で指定された分類に適合する最初の文字を検索する
( std::ctype<CharT> の仮想保護メンバー関数)
分類テーブルを使用して、指定された分類に適合しない最初の文字を検索する
(公開メンバー関数)