std::ctype<char>::scan_is

< cpp‎ | locale‎ | ctype char
 
C++
 
本地化库
 
std::ctype
 
定义于头文件 <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'

参阅

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