Namespaces
Variants
Views
Actions

std::ctype::scan_is, std::ctype::do_scan_is

From cppreference.com
< cpp‎ | locale‎ | ctype
Revision as of 12:04, 21 January 2013 by Cubbi (Talk | contribs)

 
 
 
 

Template:ddcl list begin <tr class="t-dsc-header">

<td>
Defined in header <locale>
</td>

<td></td> <td></td> <tr class="t-dcl ">

<td >
public:
const CharT* scan_is( mask m, const CharT* beg, const CharT* end ) const;
</td>

<td > (1) </td> <td class="t-dcl-nopad"> </td> </tr> <tr class="t-dcl ">

<td >
protected:
virtual const CharT* do_scan_is( mask m, const CharT* beg, const CharT* end) const;
</td>

<td > (2) </td> <td class="t-dcl-nopad"> </td> </tr> Template:ddcl list end

1) public member function, calls the protected virtual member function do_scan_is of the most derived class.
2) Locates the first character in the character array [beg, end) that satisfies the classification mask m, that is, the first character c such that is(m, c) would return true.

Contents

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 satisfies the mask, or end if no such character was found.

Example

#include <locale>
#include <iostream>
#include <iterator>
 
int main()
{
    auto& f = std::use_facet<std::ctype<char>>(std::locale(""));
 
    // 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";
}

Output:

'Test'
'abcd'

See also

Template:cpp/locale/ctype/dcl list do scan not