std::ctype<char>::scan_not

Header: <locale>

Locates the first character in the character array [beg,end) that does not satisfy the classification mask m, that is, the first character c such that table()[(unsigned char)c] & m would return false.

# Declarations

const char* scan_not( mask m, const char* beg, const char* end ) const;

# Parameters

m: mask to search for
beg: pointer to the first character in an array of characters to search
end: one past the end pointer for the array of characters to search

# Return value

Pointer to the first character in [beg,end) that does not satisfy the mask, or end if no such character was found.

# Notes

Unlike the primary template std::ctype, this specialization does not perform a virtual function call when classifying characters. To customize the behavior, a derived class may provide a non-default classification table to the base class constructor.

# Example

#include <iostream>
#include <iterator>
#include <locale>
 
int main()
{
    auto& f = std::use_facet<std::ctype<char>>(std::locale());
 
    // skip leading whitespace
    char s1[] = "      \t\t\n  Test";
    const char* p1 = f.scan_not(std::ctype_base::space, std::begin(s1), std::end(s1));
    std::cout << '\'' << p1 << "'\n";
 
    // skip leading digits
    char s2[] = "123456789abcd";
    const char* p2 = f.scan_not(std::ctype_base::digit, std::begin(s2), std::end(s2));
    std::cout << '\'' << p2 << "'\n";
}