# std::ctype<char>::scan_is

< cpp‎ | locale‎ | ctype char

定义于头文件 `<locale>` |  |
const char* scan_is (mask m, const char* beg, const char* end) const; | (1) |

在字符数组 `[beg, end)` 中定位满足分类掩码 `m` 的首个字符，即满足 table()[(unsigned char) c] & m 会返回 true 的首个 `c` 。

若 (unsigned char)c >= std::ctype<char>::table_size ，则以实现定义值取代 table()[(unsigned char)c] ，可能对于 c 的不同值不同。

### 参数

m | - | 要搜索的掩码
beg | - | 指向要搜索的字符数组中首字符的指针
end | - | 要搜索的字符数组的尾后一位置指针

### 返回值

指向 `[beg, end)` 中首个满足掩码的字符的指针，或若找不到这种字符则为 `end` 。

### 注意

不同于初等模板 std::ctype ，此特化在分类字符时不进行虚函数调用。为定制行为，导出类可提供非默认分类表给基类构造函数。

### 示例

    #include <locale>
    #include <iostream>
    #include <iterator>

    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'

### 参阅

do_scan_is [虚] | 定位序列中首个符合给定分类的字符 (`std::ctype<CharT>` 的虚受保护成员函数)
scan_not | 用分类表定位序列中首个不符合给定分类的字符 (公开成员函数)