.TH "std::ctype< _CharT >" 3cxx "libstdc++" \" -*- nroff -*-
.ad l
.nh
.SH NAME
std::ctype< _CharT > \- Primary class template ctype facet\&.  

.SH SYNOPSIS
.br
.PP
.PP
\fC#include <locale_facets\&.h>\fP
.PP
Inherits \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.PP
Inherited by \fBstd::ctype_byname< _CharT >\fP\&.
.SS "Public Types"

.in +1c
.ti -1c
.RI "\fBtypedef\fP \fBconst\fP int * \fB__to_type\fP"
.br
.ti -1c
.RI "\fBtypedef\fP _CharT \fBchar_type\fP"
.br
.ti -1c
.RI "\fBtypedef\fP \fB__ctype_abstract_base\fP< _CharT >::mask \fBmask\fP"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBctype\fP (size_t \fB__refs\fP=0)"
.br
.ti -1c
.RI "\fBconst\fP char_type * \fBis\fP (\fBconst\fP char_type *__lo, \fBconst\fP char_type *__hi, mask *\fB__vec\fP) \fBconst\fP"
.br
.RI "Return a mask array\&. "
.ti -1c
.RI "bool \fBis\fP (mask __m, char_type __c) \fBconst\fP"
.br
.RI "Test char_type classification\&. "
.ti -1c
.RI "char \fBnarrow\fP (char_type __c, char \fB__dfault\fP) \fBconst\fP"
.br
.RI "Narrow char_type to char\&. "
.ti -1c
.RI "\fBconst\fP char_type * \fBnarrow\fP (\fBconst\fP char_type *__lo, \fBconst\fP char_type *__hi, char \fB__dfault\fP, char *\fB__to\fP) \fBconst\fP"
.br
.RI "Narrow array to char array\&. "
.ti -1c
.RI "\fBconst\fP char_type * \fBscan_is\fP (mask __m, \fBconst\fP char_type *__lo, \fBconst\fP char_type *__hi) \fBconst\fP"
.br
.RI "Find char_type matching a mask\&. "
.ti -1c
.RI "\fBconst\fP char_type * \fBscan_not\fP (mask __m, \fBconst\fP char_type *__lo, \fBconst\fP char_type *__hi) \fBconst\fP"
.br
.RI "Find char_type not matching a mask\&. "
.ti -1c
.RI "\fBconst\fP char_type * \fBtolower\fP (char_type *__lo, \fBconst\fP char_type *__hi) \fBconst\fP"
.br
.RI "Convert array to lowercase\&. "
.ti -1c
.RI "char_type \fBtolower\fP (char_type __c) \fBconst\fP"
.br
.RI "Convert to lowercase\&. "
.ti -1c
.RI "\fBconst\fP char_type * \fBtoupper\fP (char_type *__lo, \fBconst\fP char_type *__hi) \fBconst\fP"
.br
.RI "Convert array to uppercase\&. "
.ti -1c
.RI "char_type \fBtoupper\fP (char_type __c) \fBconst\fP"
.br
.RI "Convert to uppercase\&. "
.ti -1c
.RI "char_type \fBwiden\fP (char __c) \fBconst\fP"
.br
.RI "Widen char to char_type\&. "
.ti -1c
.RI "\fBconst\fP char * \fBwiden\fP (\fBconst\fP char *__lo, \fBconst\fP char *__hi, char_type *\fB__to\fP) \fBconst\fP"
.br
.RI "Widen array to char_type\&. "
.in -1c
.SS "Static Public Attributes"

.in +1c
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBalnum\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBalpha\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBblank\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBcntrl\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBdigit\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBgraph\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBlocale::id\fP \fBid\fP"
.br
.RI "The facet id for ctype<char_type> "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBlower\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBprint\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBpunct\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBspace\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBupper\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP mask \fBxdigit\fP"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "\fBvirtual\fP \fBconst\fP char_type * \fBdo_is\fP (\fBconst\fP char_type *__lo, \fBconst\fP char_type *__hi, mask *\fB__vec\fP) \fBconst\fP"
.br
.RI "Return a mask array\&. "
.ti -1c
.RI "\fBvirtual\fP bool \fBdo_is\fP (mask __m, char_type __c) \fBconst\fP"
.br
.RI "Test char_type classification\&. "
.ti -1c
.RI "\fBvirtual\fP char \fBdo_narrow\fP (char_type, char \fB__dfault\fP) \fBconst\fP"
.br
.RI "Narrow char_type to char\&. "
.ti -1c
.RI "\fBvirtual\fP \fBconst\fP char_type * \fBdo_narrow\fP (\fBconst\fP char_type *__lo, \fBconst\fP char_type *__hi, char \fB__dfault\fP, char *\fB__to\fP) \fBconst\fP"
.br
.RI "Narrow char_type array to char\&. "
.ti -1c
.RI "\fBvirtual\fP \fBconst\fP char_type * \fBdo_scan_is\fP (mask __m, \fBconst\fP char_type *__lo, \fBconst\fP char_type *__hi) \fBconst\fP"
.br
.RI "Find char_type matching mask\&. "
.ti -1c
.RI "\fBvirtual\fP \fBconst\fP char_type * \fBdo_scan_not\fP (mask __m, \fBconst\fP char_type *__lo, \fBconst\fP char_type *__hi) \fBconst\fP"
.br
.RI "Find char_type not matching mask\&. "
.ti -1c
.RI "\fBvirtual\fP \fBconst\fP char_type * \fBdo_tolower\fP (char_type *__lo, \fBconst\fP char_type *__hi) \fBconst\fP"
.br
.RI "Convert array to lowercase\&. "
.ti -1c
.RI "\fBvirtual\fP char_type \fBdo_tolower\fP (char_type __c) \fBconst\fP"
.br
.RI "Convert to lowercase\&. "
.ti -1c
.RI "\fBvirtual\fP \fBconst\fP char_type * \fBdo_toupper\fP (char_type *__lo, \fBconst\fP char_type *__hi) \fBconst\fP"
.br
.RI "Convert array to uppercase\&. "
.ti -1c
.RI "\fBvirtual\fP char_type \fBdo_toupper\fP (char_type __c) \fBconst\fP"
.br
.RI "Convert to uppercase\&. "
.ti -1c
.RI "\fBvirtual\fP char_type \fBdo_widen\fP (char __c) \fBconst\fP"
.br
.RI "Widen char\&. "
.ti -1c
.RI "\fBvirtual\fP \fBconst\fP char * \fBdo_widen\fP (\fBconst\fP char *__lo, \fBconst\fP char *__hi, char_type *\fB__dest\fP) \fBconst\fP"
.br
.RI "Widen char array\&. "
.in -1c
.SS "Static Protected Member Functions"

.in +1c
.ti -1c
.RI "\fBstatic\fP __c_locale \fB_S_clone_c_locale\fP (__c_locale &\fB__cloc\fP)  throw ()"
.br
.ti -1c
.RI "\fBstatic\fP \fBvoid\fP \fB_S_create_c_locale\fP (__c_locale &\fB__cloc\fP, \fBconst\fP char *\fB__s\fP, __c_locale \fB__old\fP=0)"
.br
.ti -1c
.RI "\fBstatic\fP \fBvoid\fP \fB_S_destroy_c_locale\fP (__c_locale &\fB__cloc\fP)"
.br
.ti -1c
.RI "\fBstatic\fP __c_locale \fB_S_get_c_locale\fP ()"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP char * \fB_S_get_c_name\fP ()  throw ()"
.br
.ti -1c
.RI "\fBstatic\fP __c_locale \fB_S_lc_ctype_c_locale\fP (__c_locale \fB__cloc\fP, \fBconst\fP char *\fB__s\fP)"
.br
.in -1c
.SH "Detailed Description"
.PP 

.SS "template<\fBtypename\fP _CharT>
.br
class std::ctype< _CharT >"Primary class template ctype facet\&. 

This template class defines classification and conversion functions for character sets\&. It wraps cctype functionality\&. Ctype gets used by streams for many I/O operations\&.
.PP
This template provides the protected virtual functions the developer will have to replace in a derived class or specialization to make a working facet\&. The public functions that access them are defined in __ctype_abstract_base, to allow for implementation flexibility\&. See ctype<wchar_t> for an example\&. The functions are documented in __ctype_abstract_base\&.
.PP
Note: implementations are provided for all the protected virtual functions, but will likely not be useful\&. 
.PP
Definition at line \fB612\fP of file \fBlocale_facets\&.h\fP\&.
.SH "Member Typedef Documentation"
.PP 
.SS "\fBtypedef\fP \fBconst\fP int* std::ctype_base::__to_type\fC [inherited]\fP"

.PP
Definition at line \fB44\fP of file \fBctype_base\&.h\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBtypedef\fP _CharT \fBstd::ctype\fP< _CharT >::char_type"

.PP
Definition at line \fB616\fP of file \fBlocale_facets\&.h\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBtypedef\fP \fB__ctype_abstract_base\fP<_CharT>::mask \fBstd::ctype\fP< _CharT >::mask"

.PP
Definition at line \fB617\fP of file \fBlocale_facets\&.h\fP\&.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "template<\fBtypename\fP _CharT > \fBstd::ctype\fP< _CharT >::ctype (size_t __refs = \fC0\fP)\fC [inline]\fP, \fC [explicit]\fP"

.PP
Definition at line \fB623\fP of file \fBlocale_facets\&.h\fP\&.
.SH "Member Function Documentation"
.PP 
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP \fBconst\fP char_type * \fBstd::ctype\fP< _CharT >::do_is (\fBconst\fP char_type * __lo, \fBconst\fP char_type * __hi, mask * __vec) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Return a mask array\&. This function finds the mask for each char_type in the range [lo,hi) and successively writes it to vec\&. vec must have as many elements as the input\&.
.PP
do_is() is a hook for a derived facet to change the behavior of classifying\&. do_is() must always return the same result for the same input\&.
.PP
\fBParameters\fP
.RS 4
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.br
\fI__vec\fP Pointer to an array of mask storage\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fI__hi\fP\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP bool \fBstd::ctype\fP< _CharT >::do_is (mask __m, char_type __c) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Test char_type classification\&. This function finds a mask M for \fIc\fP and compares it to mask \fIm\fP\&.
.PP
do_is() is a hook for a derived facet to change the behavior of classifying\&. do_is() must always return the same result for the same input\&.
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The char_type to find the mask of\&. 
.br
\fI__m\fP The mask to compare against\&. 
.RE
.PP
\fBReturns\fP
.RS 4
(M & __m) != 0\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP char \fBstd::ctype\fP< _CharT >::do_narrow (char_type __c, char __dfault) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Narrow char_type to char\&. This virtual function converts the argument to char using the simplest reasonable transformation\&. If the conversion fails, dfault is returned instead\&.
.PP
do_narrow() is a hook for a derived facet to change the behavior of narrowing\&. do_narrow() must always return the same result for the same input\&.
.PP
Note: this is not what you want for codepage conversions\&. See codecvt for that\&.
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The char_type to convert\&. 
.br
\fI__dfault\fP Char to return if conversion fails\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The converted char\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.PP
Referenced by \fBstd::ctype< char >::narrow()\fP, and \fBstd::ctype< char >::narrow()\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP \fBconst\fP char_type * \fBstd::ctype\fP< _CharT >::do_narrow (\fBconst\fP char_type * __lo, \fBconst\fP char_type * __hi, char __dfault, char * __to) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Narrow char_type array to char\&. This virtual function converts each char_type in the range [__lo,__hi) to char using the simplest reasonable transformation and writes the results to the destination array\&. For any element in the input that cannot be converted, \fI__dfault\fP is used instead\&.
.PP
do_narrow() is a hook for a derived facet to change the behavior of narrowing\&. do_narrow() must always return the same result for the same input\&.
.PP
Note: this is not what you want for codepage conversions\&. See codecvt for that\&.
.PP
\fBParameters\fP
.RS 4
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.br
\fI__dfault\fP Char to use if conversion fails\&. 
.br
\fI__to\fP Pointer to the destination array\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fI__hi\fP\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP \fBconst\fP char_type * \fBstd::ctype\fP< _CharT >::do_scan_is (mask __m, \fBconst\fP char_type * __lo, \fBconst\fP char_type * __hi) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Find char_type matching mask\&. This function searches for and returns the first char_type c in [__lo,__hi) for which is(__m,c) is true\&.
.PP
do_scan_is() is a hook for a derived facet to change the behavior of match searching\&. do_is() must always return the same result for the same input\&.
.PP
\fBParameters\fP
.RS 4
\fI__m\fP The mask to compare against\&. 
.br
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.RE
.PP
\fBReturns\fP
.RS 4
Pointer to a matching char_type if found, else \fI__hi\fP\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP \fBconst\fP char_type * \fBstd::ctype\fP< _CharT >::do_scan_not (mask __m, \fBconst\fP char_type * __lo, \fBconst\fP char_type * __hi) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Find char_type not matching mask\&. This function searches for and returns a pointer to the first char_type c of [lo,hi) for which is(m,c) is false\&.
.PP
do_scan_is() is a hook for a derived facet to change the behavior of match searching\&. do_is() must always return the same result for the same input\&.
.PP
\fBParameters\fP
.RS 4
\fI__m\fP The mask to compare against\&. 
.br
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.RE
.PP
\fBReturns\fP
.RS 4
Pointer to a non-matching char_type if found, else \fI__hi\fP\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP \fBconst\fP char_type * \fBstd::ctype\fP< _CharT >::do_tolower (char_type * __lo, \fBconst\fP char_type * __hi) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Convert array to lowercase\&. This virtual function converts each char_type in the range [__lo,__hi) to lowercase if possible\&. Other elements remain untouched\&.
.PP
do_tolower() is a hook for a derived facet to change the behavior of lowercasing\&. do_tolower() must always return the same result for the same input\&.
.PP
\fBParameters\fP
.RS 4
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fI__hi\fP\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP char_type \fBstd::ctype\fP< _CharT >::do_tolower (char_type __c) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Convert to lowercase\&. This virtual function converts the argument to lowercase if possible\&. If not possible (for example, '2'), returns the argument\&.
.PP
do_tolower() is a hook for a derived facet to change the behavior of lowercasing\&. do_tolower() must always return the same result for the same input\&.
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The char_type to convert\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The lowercase char_type if convertible, else \fI__c\fP\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.PP
Referenced by \fBstd::ctype< char >::tolower()\fP, and \fBstd::ctype< char >::tolower()\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP \fBconst\fP char_type * \fBstd::ctype\fP< _CharT >::do_toupper (char_type * __lo, \fBconst\fP char_type * __hi) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Convert array to uppercase\&. This virtual function converts each char_type in the range [__lo,__hi) to uppercase if possible\&. Other elements remain untouched\&.
.PP
do_toupper() is a hook for a derived facet to change the behavior of uppercasing\&. do_toupper() must always return the same result for the same input\&.
.PP
\fBParameters\fP
.RS 4
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fI__hi\fP\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP char_type \fBstd::ctype\fP< _CharT >::do_toupper (char_type __c) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Convert to uppercase\&. This virtual function converts the char_type argument to uppercase if possible\&. If not possible (for example, '2'), returns the argument\&.
.PP
do_toupper() is a hook for a derived facet to change the behavior of uppercasing\&. do_toupper() must always return the same result for the same input\&.
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The char_type to convert\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The uppercase char_type if convertible, else \fI__c\fP\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.PP
Referenced by \fBstd::ctype< char >::toupper()\fP, and \fBstd::ctype< char >::toupper()\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP char_type \fBstd::ctype\fP< _CharT >::do_widen (char __c) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Widen char\&. This virtual function converts the char to char_type using the simplest reasonable transformation\&.
.PP
do_widen() is a hook for a derived facet to change the behavior of widening\&. do_widen() must always return the same result for the same input\&.
.PP
Note: this is not what you want for codepage conversions\&. See codecvt for that\&.
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The char to convert\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The converted char_type 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.PP
Referenced by \fBstd::ctype< char >::widen()\fP, and \fBstd::ctype< char >::widen()\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBvirtual\fP \fBconst\fP char * \fBstd::ctype\fP< _CharT >::do_widen (\fBconst\fP char * __lo, \fBconst\fP char * __hi, char_type * __to) const\fC [protected]\fP, \fC [virtual]\fP"

.PP
Widen char array\&. This function converts each char in the input to char_type using the simplest reasonable transformation\&.
.PP
do_widen() is a hook for a derived facet to change the behavior of widening\&. do_widen() must always return the same result for the same input\&.
.PP
Note: this is not what you want for codepage conversions\&. See codecvt for that\&.
.PP
\fBParameters\fP
.RS 4
\fI__lo\fP Pointer to start range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.br
\fI__to\fP Pointer to the destination array\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fI__hi\fP\&. 
.RE
.PP

.PP
Implements \fBstd::__ctype_abstract_base< _CharT >\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBconst\fP char_type * \fBstd::__ctype_abstract_base\fP< _CharT >::is (\fBconst\fP \fBchar_type\fP * __lo, \fBconst\fP \fBchar_type\fP * __hi, mask * __vec) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Return a mask array\&. This function finds the mask for each char_type in the range [lo,hi) and successively writes it to vec\&. vec must have as many elements as the char array\&. It does so by returning the value of ctype<char_type>::do_is()\&.
.PP
\fBParameters\fP
.RS 4
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.br
\fI__vec\fP Pointer to an array of mask storage\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fI__hi\fP\&. 
.RE
.PP

.PP
Definition at line \fB186\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_is()\fP\&.
.SS "template<\fBtypename\fP _CharT > bool \fBstd::__ctype_abstract_base\fP< _CharT >::is (mask __m, \fBchar_type\fP __c) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Test char_type classification\&. This function finds a mask M for \fI__c\fP and compares it to mask \fI__m\fP\&. It does so by returning the value of ctype<char_type>::do_is()\&.
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The char_type to compare the mask of\&. 
.br
\fI__m\fP The mask to compare against\&. 
.RE
.PP
\fBReturns\fP
.RS 4
(M & __m) != 0\&. 
.RE
.PP

.PP
Definition at line \fB169\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_is()\fP\&.
.SS "template<\fBtypename\fP _CharT > char \fBstd::__ctype_abstract_base\fP< _CharT >::narrow (\fBchar_type\fP __c, char __dfault) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Narrow char_type to char\&. This function converts the char_type to char using the simplest reasonable transformation\&. If the conversion fails, dfault is returned instead\&. It does so by returning ctype<char_type>::do_narrow(__c)\&.
.PP
Note: this is not what you want for codepage conversions\&. See codecvt for that\&.
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The char_type to convert\&. 
.br
\fI__dfault\fP Char to return if conversion fails\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The converted char\&. 
.RE
.PP

.PP
Definition at line \fB331\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_narrow()\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBconst\fP char_type * \fBstd::__ctype_abstract_base\fP< _CharT >::narrow (\fBconst\fP \fBchar_type\fP * __lo, \fBconst\fP \fBchar_type\fP * __hi, char __dfault, char * __to) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Narrow array to char array\&. This function converts each char_type in the input to char using the simplest reasonable transformation and writes the results to the destination array\&. For any char_type in the input that cannot be converted, \fIdfault\fP is used instead\&. It does so by returning ctype<char_type>::do_narrow(__lo, __hi, __dfault, __to)\&.
.PP
Note: this is not what you want for codepage conversions\&. See codecvt for that\&.
.PP
\fBParameters\fP
.RS 4
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.br
\fI__dfault\fP Char to use if conversion fails\&. 
.br
\fI__to\fP Pointer to the destination array\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fI__hi\fP\&. 
.RE
.PP

.PP
Definition at line \fB353\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_narrow()\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBconst\fP char_type * \fBstd::__ctype_abstract_base\fP< _CharT >::scan_is (mask __m, \fBconst\fP \fBchar_type\fP * __lo, \fBconst\fP \fBchar_type\fP * __hi) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Find char_type matching a mask\&. This function searches for and returns the first char_type c in [lo,hi) for which is(m,c) is true\&. It does so by returning ctype<char_type>::do_scan_is()\&.
.PP
\fBParameters\fP
.RS 4
\fI__m\fP The mask to compare against\&. 
.br
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.RE
.PP
\fBReturns\fP
.RS 4
Pointer to matching char_type if found, else \fI__hi\fP\&. 
.RE
.PP

.PP
Definition at line \fB202\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_scan_is()\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBconst\fP char_type * \fBstd::__ctype_abstract_base\fP< _CharT >::scan_not (mask __m, \fBconst\fP \fBchar_type\fP * __lo, \fBconst\fP \fBchar_type\fP * __hi) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Find char_type not matching a mask\&. This function searches for and returns the first char_type c in [lo,hi) for which is(m,c) is false\&. It does so by returning ctype<char_type>::do_scan_not()\&.
.PP
\fBParameters\fP
.RS 4
\fI__m\fP The mask to compare against\&. 
.br
\fI__lo\fP Pointer to first char in range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.RE
.PP
\fBReturns\fP
.RS 4
Pointer to non-matching char if found, else \fI__hi\fP\&. 
.RE
.PP

.PP
Definition at line \fB218\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_scan_not()\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBconst\fP char_type * \fBstd::__ctype_abstract_base\fP< _CharT >::tolower (\fBchar_type\fP * __lo, \fBconst\fP \fBchar_type\fP * __hi) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Convert array to lowercase\&. This function converts each char_type in the range [__lo,__hi) to lowercase if possible\&. Other elements remain untouched\&. It does so by returning ctype<char_type>:: do_tolower(__lo, __hi)\&.
.PP
\fBParameters\fP
.RS 4
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fI__hi\fP\&. 
.RE
.PP

.PP
Definition at line \fB276\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_tolower()\fP\&.
.SS "template<\fBtypename\fP _CharT > char_type \fBstd::__ctype_abstract_base\fP< _CharT >::tolower (\fBchar_type\fP __c) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Convert to lowercase\&. This function converts the argument to lowercase if possible\&. If not possible (for example, '2'), returns the argument\&. It does so by returning ctype<char_type>::do_tolower(c)\&.
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The char_type to convert\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The lowercase char_type if convertible, else \fI__c\fP\&. 
.RE
.PP

.PP
Definition at line \fB261\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_tolower()\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBconst\fP char_type * \fBstd::__ctype_abstract_base\fP< _CharT >::toupper (\fBchar_type\fP * __lo, \fBconst\fP \fBchar_type\fP * __hi) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Convert array to uppercase\&. This function converts each char_type in the range [lo,hi) to uppercase if possible\&. Other elements remain untouched\&. It does so by returning ctype<char_type>:: do_toupper(lo, hi)\&.
.PP
\fBParameters\fP
.RS 4
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fI__hi\fP\&. 
.RE
.PP

.PP
Definition at line \fB247\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_toupper()\fP\&.
.SS "template<\fBtypename\fP _CharT > char_type \fBstd::__ctype_abstract_base\fP< _CharT >::toupper (\fBchar_type\fP __c) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Convert to uppercase\&. This function converts the argument to uppercase if possible\&. If not possible (for example, '2'), returns the argument\&. It does so by returning ctype<char_type>::do_toupper()\&.
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The char_type to convert\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The uppercase char_type if convertible, else \fI__c\fP\&. 
.RE
.PP

.PP
Definition at line \fB232\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_toupper()\fP\&.
.SS "template<\fBtypename\fP _CharT > char_type \fBstd::__ctype_abstract_base\fP< _CharT >::widen (char __c) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Widen char to char_type\&. This function converts the char argument to char_type using the simplest reasonable transformation\&. It does so by returning ctype<char_type>::do_widen(c)\&.
.PP
Note: this is not what you want for codepage conversions\&. See codecvt for that\&.
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The char to convert\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The converted char_type\&. 
.RE
.PP

.PP
Definition at line \fB293\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_widen()\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBconst\fP char * \fBstd::__ctype_abstract_base\fP< _CharT >::widen (\fBconst\fP char * __lo, \fBconst\fP char * __hi, \fBchar_type\fP * __to) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Widen array to char_type\&. This function converts each char in the input to char_type using the simplest reasonable transformation\&. It does so by returning ctype<char_type>::do_widen(c)\&.
.PP
Note: this is not what you want for codepage conversions\&. See codecvt for that\&.
.PP
\fBParameters\fP
.RS 4
\fI__lo\fP Pointer to start of range\&. 
.br
\fI__hi\fP Pointer to end of range\&. 
.br
\fI__to\fP Pointer to the destination array\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fI__hi\fP\&. 
.RE
.PP

.PP
Definition at line \fB312\fP of file \fBlocale_facets\&.h\fP\&.
.PP
References \fBstd::__ctype_abstract_base< _CharT >::do_widen()\fP\&.
.SH "Member Data Documentation"
.PP 
.SS "\fBconst\fP mask std::ctype_base::alnum\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB59\fP of file \fBctype_base\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::alpha\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB51\fP of file \fBctype_base\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::blank\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB61\fP of file \fBctype_base\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::cntrl\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB57\fP of file \fBctype_base\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::digit\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB52\fP of file \fBctype_base\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::graph\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB56\fP of file \fBctype_base\&.h\fP\&.
.SS "template<\fBtypename\fP _CharT > \fBlocale::id\fP \fBstd::ctype\fP< _CharT >::id\fC [static]\fP"

.PP
The facet id for ctype<char_type> 
.PP
Definition at line \fB620\fP of file \fBlocale_facets\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::lower\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB50\fP of file \fBctype_base\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::print\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB55\fP of file \fBctype_base\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::punct\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB58\fP of file \fBctype_base\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::space\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB54\fP of file \fBctype_base\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::upper\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB49\fP of file \fBctype_base\&.h\fP\&.
.SS "\fBconst\fP mask std::ctype_base::xdigit\fC [static]\fP, \fC [inherited]\fP"

.PP
Definition at line \fB53\fP of file \fBctype_base\&.h\fP\&.

.SH "Author"
.PP 
Generated automatically by Doxygen for libstdc++ from the source code\&.