tolower

  • Article

Converts a character to lower case.

template<Class CharType> 
   CharType tolower( 
      CharType _Ch,  
      const locale& _Loc 
   )

Parameters

  • _Ch
    The character to be converted to lower case.

  • _Loc
    The locale containing the character to be converted.

Return Value

The character converted to lower case.

Remarks

The template function returns use_facet<ctype<CharType> >(_Loc).tolower(_Ch).

Example

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

int main( )   
{
   locale loc ( "German_Germany" );
   char result1 = tolower ( 'H', loc );
   cout << "The lower case of 'H' in the locale is: "
        << result1 << "." << endl;
   char result2 = tolower ( 'h', loc );
   cout << "The lower case of 'h' in the locale is: "
        << result2 << "." << endl;
   char result3 = tolower ( '$', loc );
   cout << "The lower case of '$' in the locale is: "
        << result3 << "." << endl;
}

Output

The lower case of 'H' in the locale is: h.
The lower case of 'h' in the locale is: h.
The lower case of '$' in the locale is: $.

Requirements

Header: <locale>

Namespace: std