.TH "std::ctype_byname< _CharT >" 3cxx "libstdc++" \" -*- nroff -*-
.ad l
.nh
.SH NAME
std::ctype_byname< _CharT > \- class ctype_byname [22\&.2\&.1\&.2]\&.  

.SH SYNOPSIS
.br
.PP
.PP
\fC#include <locale_facets\&.h>\fP
.PP
Inherits \fBstd::ctype< _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 \fBctype\fP< _CharT >::mask \fBmask\fP"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBctype_byname\fP (\fBconst\fP char *\fB__s\fP, size_t \fB__refs\fP=0)"
.br
.ti -1c
.RI "\fBctype_byname\fP (\fBconst\fP \fBstring\fP &\fB__s\fP, size_t \fB__refs\fP=0)"
.br
.ti -1c
.RI "\fBconst\fP char_type * \fBis\fP (\fBconst\fP char_type *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP, \fBmask\fP *\fB__vec\fP) \fBconst\fP"
.br
.RI "Return a mask array\&. "
.ti -1c
.RI "bool \fBis\fP (\fBmask\fP \fB__m\fP, 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 *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP, 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 (\fBmask\fP \fB__m\fP, \fBconst\fP char_type *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP) \fBconst\fP"
.br
.RI "Find char_type matching a mask\&. "
.ti -1c
.RI "\fBconst\fP char_type * \fBscan_not\fP (\fBmask\fP \fB__m\fP, \fBconst\fP char_type *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP) \fBconst\fP"
.br
.RI "Find char_type not matching a mask\&. "
.ti -1c
.RI "\fBconst\fP char_type * \fBtolower\fP (char_type *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP) \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 *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP) \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 *\fB__lo\fP, \fBconst\fP char *\fB__hi\fP, 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 \fBmask\fP \fBalnum\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBmask\fP \fBalpha\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBmask\fP \fBblank\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBmask\fP \fBcntrl\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBmask\fP \fBdigit\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBmask\fP \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 \fBmask\fP \fBlower\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBmask\fP \fBprint\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBmask\fP \fBpunct\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBmask\fP \fBspace\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBmask\fP \fBupper\fP"
.br
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBmask\fP \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 *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP, \fBmask\fP *\fB__vec\fP) \fBconst\fP"
.br
.RI "Return a mask array\&. "
.ti -1c
.RI "\fBvirtual\fP bool \fBdo_is\fP (\fBmask\fP \fB__m\fP, 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 *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP, 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 (\fBmask\fP \fB__m\fP, \fBconst\fP char_type *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP) \fBconst\fP"
.br
.RI "Find char_type matching mask\&. "
.ti -1c
.RI "\fBvirtual\fP \fBconst\fP char_type * \fBdo_scan_not\fP (\fBmask\fP \fB__m\fP, \fBconst\fP char_type *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP) \fBconst\fP"
.br
.RI "Find char_type not matching mask\&. "
.ti -1c
.RI "\fBvirtual\fP \fBconst\fP char_type * \fBdo_tolower\fP (char_type *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP) \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 *\fB__lo\fP, \fBconst\fP char_type *\fB__hi\fP) \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 *\fB__lo\fP, \fBconst\fP char *\fB__hi\fP, 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)  \fBthrow\fP ()"
.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 ()  \fBthrow\fP ()"
.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_byname< _CharT >"class ctype_byname [22\&.2\&.1\&.2]\&. 
.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, \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 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, \fC [inherited]\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, \fC [inherited]\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, \fC [inherited]\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, \fC [inherited]\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, \fC [inherited]\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, \fC [inherited]\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, \fC [inherited]\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, \fC [inherited]\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, \fC [inherited]\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, \fC [inherited]\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, \fC [inherited]\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
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
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
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
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
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
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
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
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
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
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
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
References \fBstd::__ctype_abstract_base< _CharT >::do_widen()\fP\&.
.SH "Member Data Documentation"
.PP 
.SS "template<\fBtypename\fP _CharT > \fBlocale::id\fP \fBstd::ctype\fP< _CharT >::id\fC [static]\fP, \fC [inherited]\fP"

.PP
The facet id for ctype<char_type> 

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