ctype::scan_is

Locates the first character in a range that matches a specified mask.

const CharType *scan_is(
    mask maskVal, 
    const CharType* first, 
    const CharType* last,
) const;

Parameters

• maskVal
  The mask value to be matched by a character.

• first
  A pointer to the first character in the range to be scanned.

• last
  A pointer to the character immediately following the last character in the range to be scanned.

Return Value

A pointer to the first character in a range that does match a specified mask. If no such value exists, the function returns last.

Remarks

The member function returns do_scan_is(maskVal, first, last).

Example

// ctype_scan_is.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
using namespace std;

int main( )   
{
   locale loc1 ( "German_Germany" );
   
   char *string = "Hello, my name is John!";

   const char* i = use_facet<ctype<char> > ( loc1 ).scan_is
      ( ctype_base::punct, string, string + strlen(string) );
   cout << "The first punctuation is \"" << *i << "\" at position: " 
      << i - string << endl;
}

The first punctuation is "," at position: 5

Requirements

Header: <locale>

Namespace: std

See Also

Reference

ctype Class