C++ Locale Library - scan_is

---

Description

It returns first character in category.

Declaration

Following is the declaration for std::ctype::scan_is.

C++98

	
const char_type* scan_is (mask m, const char_type* low, const char_type* high) const;

C++11

const char_type* scan_is (mask m, const char_type* low, const char_type* high) const;

Parameters

• m − It is a bitmask of member type mask.

• low,high − It is a pointer to the beginning and end of the sequence of characters.

Return Value

It returns a pointer to the first element in the range that classifies, or high if none is found.

Exceptions

Strong guarantee − if an exception is thrown, there are no effects.

Data races

The object, and the elements in the range [low,high), are accessed.

Example

In below example explains about std::ctype::scan_is.

#include <iostream>
#include <locale>

int main () {
   std::locale loc;

   const char quote[] = "tutorialspoint. sairamkrishna, He had developed this tutorial.";

   const char * p = std::use_facet< std::ctype<char> >(loc).scan_is 
      ( std::ctype<char>::punct, quote, quote+76 );

   std::cout << "The second sentence is: " << p << '\n';

   return 0;
}

Let us compile and run the above program, this will produce the following result −

The second sentence is: . sairamkrishna, He had developed this tutorial.