ctype::scan_not

Locates the first character in a range that does not match a specified mask.

const CharType *scan_not(
     mask _MaskVal, 
      const CharType* _First, 
      const CharType* _Last,
) const;

Parameters

  • _MaskVal
    The mask value not to be matched by a character.

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

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

Return Value

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

Remarks

The member function returns do_scan_not(_MaskVal, _First, _Last).

Example

// ctype_scan_not.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_not
      ( ctype_base::alpha, &string[0], &string[strlen(&string[0])-1] );
   cout << "First nonalpha character is \"" << *i << "\" at position: " 
      << i - string << endl;
}

First nonalpha character is "," at position: 5

Requirements

Header: <locale>

Namespace: std

See Also

Concepts

ctype Class

ctype Members