std::ctype<CharT>::scan_is, std::ctype<CharT>::do_scan_is

来自cppreference.com
 
C++
 
文本处理库
 
本地化库
 
std::ctype
 
在标头 <locale> 定义 
public:
const CharT* scan_is( mask m, const CharT* beg, const CharT* end ) const;
(1) 
protected:
virtual const CharT* do_scan_is( mask m, const CharT* beg, const CharT* end) const;
(2)
1) 公开成员函数，调用最终派生类的受保护虚成员函数 {{tt|do_scan_is}。
2) 定位字符数组 [beg, end) 中满足分类掩码 m 的首个字符，即首个使得 is(m, c) 会返回 true 的字符 c。

参数

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

返回值

指向 [beg, end) 中首个满足掩码的字符的指针，如果找不到这种字符就返回 end。

示例

运行此代码
#include <clocale>
#include <iostream>
#include <iterator>
#include <locale>

int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    auto& f = std::use_facet<std::ctype<wchar_t>>(std::wcout.getloc());
    
    // 跳过首个字母之前
    wchar_t s1[] = L"      \t\t\n  Кошка";
    const wchar_t* p1 = f.scan_is(std::ctype_base::alpha, std::begin(s1), std::end(s1));
    std::wcout << "'" << p1 << "'\n";
    
    // 跳过首个字母之前
    wchar_t s2[] = L"123456789ネプネプ";
    const wchar_t* p2 = f.scan_is(std::ctype_base::alpha, std::begin(s2), std::end(s2));
    std::wcout << "'" << p2 << "'\n";
}

输出： 

'Кошка'
'ネプネプ'

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
LWG 152 C++98 do_scan_is 的效果提到了 is(m)，但 is 没有这样的重载 改成 is(m, c)

参阅

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