std::ctype<char>::scan_is

Определён в заголовочном файле `<locale>`
const char* scan_is( mask m, const char* beg, const char* end ) const;	(1)

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

Если (unsigned char)c >= std::ctype<char>::table_size, вместо table()[(unsigned char)c] подставляется значение, определяемое реализацией; оно может различаться для разных значений c.

Параметры

m	-	маска для поиска
beg	-	указатель на первый символ в массиве символов, в котором выполняется поиск
end	-	указатель на позицию за последним символом массива символов, в котором выполняется поиск

Возвращаемое значение

Указатель на первый символ в [beg, end), удовлетворяющий маске, или end, если такой символ не найден.

Примечания

В отличие от основного шаблона std::ctype, эта специализация не вызывает виртуальную функцию при классификации символов. Чтобы настроить поведение, производный класс может передать базовому классу при конструировании нестандартную таблицу классификации.

Пример

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

int main()
{
    std::locale loc("");
    auto& f = std::use_facet<std::ctype<char>>(loc);

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

    // skip until the first letter
    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	находит первый символ в последовательности, не соответствующий заданной классификации, используя таблицу классификации (открытая функция-член)

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