std::ctype<char>::scan_is

来自cppreference.com
< cpp‎ | locale‎ | ctype char
 
 
本地化库
本地环境与平面
本地环境
平面类别基类
ctype(字符类别)平面
numeric(数值)平面
collate(对照比较)平面
time(时间)平面
monetary(货币)平面
messages(消息)平面
字符分类与转换
字符分类
转换
编码转换平面
(C++11)    
C 本地环境
 
 
在标头 <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> 的虚受保护成员函数)
用分类表定位序列中首个不符合给定分类的字符
(公开成员函数)