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

Определён в заголовочном файле `<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) Открытая функция-член, вызывает защищённую виртуальную функцию-член do_scan_is наиболее производного класса.

2) Находит первый символ в массиве символов [beg, end), удовлетворяющий маске классификации m, то есть первый символ c, для которого is(m, c) возвращает true.

Параметры

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());

    // skip until the first letter
    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";

    // skip until the first letter
    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)`

См. также

scan_is	находит первый символ в последовательности, соответствующий заданной классификации, используя таблицу классификации (открытая функция-член `std::ctype<char>`)
do_scan_not [виртуальная]	находит первый символ в последовательности, не соответствующий заданной классификации (виртуальная защищённая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/locale/ctype/scan_is