Funções `<locale>`

Artigo
08/04/2024

has_facet
isalnum
isalpha
iscntrl
isdigit
isgraph
islower
isprint
ispunct
isspace
isupper
isxdigit
tolower
toupper
use_facet

has_facet

Testa se uma determinada faceta é armazenada em uma localidade especificada.

template <class Facet>
bool has_facet(const locale& Loc);

Parâmetros

Loc
A localidade a ser testada para a presença de uma faceta.

Valor de retorno

true se a localidade tiver a faceta testada; false se não tiver.

Comentários

A função de modelo é útil para verificar se as facetas não obrigatórias estão listadas em uma localidade antes de use_facet ser chamado para evitar a exceção que seria gerada se elas não estiverem presentes.

Exemplo

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

int main( )
{
   locale loc ( "German_Germany" );
   bool result = has_facet <ctype<char> > ( loc );
   cout << result << endl;
}

isalnum

Testa se um elemento em uma localidade é um caractere alfabético ou numérico.

template <class CharType>
bool isalnum(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento alfanumérico a ser testado.

Loc
A localidade que contém o elemento alfanumérico a ser testado.

Valor de retorno

true se o elemento testado for alfanumérico; false se não for.

Exemplo

// locale_isalnum.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isalnum ( 'L', loc);
   bool result2 = isalnum ( '@', loc);
   bool result3 = isalnum ( '3', loc);

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "alphanumeric." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not alphanumeric." << endl;

   if ( result2 )
      cout << "The character '@' in the locale is "
           << "alphanumeric." << endl;
   else
      cout << "The character '@' in the locale is "
           << " not alphanumeric." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "alphanumeric." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not alphanumeric." << endl;
}

The character 'L' in the locale is alphanumeric.
The character '@' in the locale is  not alphanumeric.
The character '3' in the locale is alphanumeric.

isalpha

Testa se um elemento em uma localidade é um caractere alfabético.

template <class CharType>
bool isalpha(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento a ser testado.

Loc
A localidade que contém o elemento alfabético a ser testado.

Valor de retorno

true se o elemento testado for alfanumérico; false se não for.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). é( ctype<CharType>:: alpha, Ch).

Exemplo

// locale_isalpha.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isalpha ( 'L', loc);
   bool result2 = isalpha ( '@', loc);
   bool result3 = isalpha ( '3', loc);

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "alphabetic." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not alphabetic." << endl;

   if ( result2 )
      cout << "The character '@' in the locale is "
           << "alphabetic." << endl;
   else
      cout << "The character '@' in the locale is "
           << " not alphabetic." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "alphabetic." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not alphabetic." << endl;
}

iscntrl

Testa se um elemento em uma localidade é um caractere de controle.

template <class CharType>
bool iscntrl(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento a ser testado.

Loc
A localidade que contém o elemento a ser testado.

Valor de retorno

true se o elemento testado fo um caractere de controle; false se não for.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). é( ctype<CharType>:: cntrl, Ch).

Exemplo

// locale_iscntrl.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = iscntrl ( 'L', loc );
   bool result2 = iscntrl ( '\n', loc );
   bool result3 = iscntrl ( '\t', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a control character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a control character." << endl;

   if ( result2 )
      cout << "The character-set 'backslash-n' in the locale\n is "
           << "a control character." << endl;
   else
      cout << "The character-set 'backslash-n' in the locale\n is "
           << " not a control character." << endl;

   if ( result3 )
      cout << "The character-set 'backslash-t' in the locale\n is "
           << "a control character." << endl;
   else
      cout << "The character-set 'backslash-n' in the locale \n is "
           << " not a control character." << endl;
}

isdigit

Testa se um elemento em uma localidade é um caractere numérico.

template <class CharType>
bool isdigit(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento a ser testado.

Loc
A localidade que contém o elemento a ser testado.

Valor de retorno

true se o elemento testado for um caractere numérico; false se não for.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). é( ctype<CharType>:: digit, Ch).

Exemplo

// locale_is_digit.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isdigit ( 'L', loc );
   bool result2 = isdigit ( '@', loc );
   bool result3 = isdigit ( '3', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a numeric character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a numeric character." << endl;

   if ( result2 )
      cout << "The character '@' in the locale is "
           << "a numeric character." << endl;
   else
      cout << "The character '@' in the locale is "
           << " not a numeric character." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "a numeric character." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not a numeric character." << endl;
}

isgraph

Testa se um elemento em uma localidade é um caractere alfanumérico ou de pontuação.

template <class CharType>
bool isgraph(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento a ser testado.

Loc
A localidade que contém o elemento a ser testado.

Valor de retorno

true se o elemento testado for um caractere alfanumérico ou de pontuação; false se não for.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). é( ctype<CharType>:: graph, Ch).

Exemplo

// locale_is_graph.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isgraph ( 'L', loc );
   bool result2 = isgraph ( '\t', loc );
   bool result3 = isgraph ( '.', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is\n "
           << "an alphanumeric or punctuation character." << endl;
   else
      cout << "The character 'L' in the locale is\n "
           << " not an alphanumeric or punctuation character." << endl;

   if ( result2 )
      cout << "The character 'backslash-t' in the locale is\n "
           << "an alphanumeric or punctuation character." << endl;
   else
      cout << "The character 'backslash-t' in the locale is\n "
           << "not an alphanumeric or punctuation character." << endl;

   if ( result3 )
      cout << "The character '.' in the locale is\n "
           << "an alphanumeric or punctuation character." << endl;
   else
      cout << "The character '.' in the locale is\n "
           << " not an alphanumeric or punctuation character." << endl;
}

islower

Testa se um elemento em uma localidade está em letras minúsculas.

template <class CharType>
bool islower(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento a ser testado.

Loc
A localidade que contém o elemento a ser testado.

Valor de retorno

true se o elemento testado for um caractere em minúsculas; false se não for.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). é( ctype<CharType>:: lower, Ch).

Exemplo

// locale_islower.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = islower ( 'L', loc );
   bool result2 = islower ( 'n', loc );
   bool result3 = islower ( '3', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a lowercase character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a lowercase character." << endl;

   if ( result2 )
      cout << "The character 'n' in the locale is "
           << "a lowercase character." << endl;
   else
      cout << "The character 'n' in the locale is "
           << " not a lowercase character." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "a lowercase character." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not a lowercase character." << endl;
}

isprint

Testa se um elemento em uma localidade é um caractere imprimível.

template <class CharType>
bool isprint(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento a ser testado.

Loc
A localidade que contém o elemento a ser testado.

Valor de retorno

true se o elemento testado for um imprimível; false se não for.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). é( ctype<CharType>:: print, Ch).

Exemplo

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

int main( )
{
   locale loc ( "German_Germany" );

   bool result1 = isprint ( 'L', loc );
   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a printable character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a printable character." << endl;

   bool result2 = isprint( '\t', loc );
   if ( result2 )
      cout << "The character 'backslash-t' in the locale is "
           << "a printable character." << endl;
   else
      cout << "The character 'backslash-t' in the locale is "
           << " not a printable character." << endl;

   bool result3 = isprint( '\n', loc );
   if ( result3 )
      cout << "The character 'backslash-n' in the locale is "
           << "a printable character." << endl;
   else
      cout << "The character 'backslash-n' in the locale is "
           << " not a printable character." << endl;
}

ispunct

Testa se um elemento em uma localidade é um caractere de pontuação.

template <class CharType>
bool ispunct(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento a ser testado.

Loc
A localidade que contém o elemento a ser testado.

Valor de retorno

true se o elemento testado for um caractere de pontuação; false se não for.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). é( ctype<CharType>:: punct, Ch).

Exemplo

// locale_ispunct.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = ispunct ( 'L', loc );
   bool result2 = ispunct ( ';', loc );
   bool result3 = ispunct ( '*', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a punctuation character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a punctuation character." << endl;

   if ( result2 )
      cout << "The character ';' in the locale is "
           << "a punctuation character." << endl;
   else
      cout << "The character ';' in the locale is "
           << " not a punctuation character." << endl;

   if ( result3 )
      cout << "The character '*' in the locale is "
           << "a punctuation character." << endl;
   else
      cout << "The character '*' in the locale is "
           << " not a punctuation character." << endl;
}

isspace

Testa se um elemento em uma localidade é um caractere de espaço em branco.

template <class CharType>
bool isspace(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento a ser testado.

Loc
A localidade que contém o elemento a ser testado.

Valor de retorno

true se o elemento testado for um caractere de espaço em branco; false se não for.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). é( ctype<CharType>:: space, Ch).

Exemplo

// locale_isspace.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isspace ( 'L', loc );
   bool result2 = isspace ( '\n', loc );
   bool result3 = isspace ( ' ', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a whitespace character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a whitespace character." << endl;

   if ( result2 )
      cout << "The character 'backslash-n' in the locale is "
           << "a whitespace character." << endl;
   else
      cout << "The character 'backslash-n' in the locale is "
           << " not a whitespace character." << endl;

   if ( result3 )
      cout << "The character ' ' in the locale is "
           << "a whitespace character." << endl;
   else
      cout << "The character ' ' in the locale is "
           << " not a whitespace character." << endl;
}

isupper

Testa se um elemento em uma localidade está em letras maiúsculas.

template <class CharType>
bool isupper(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento a ser testado.

Loc
A localidade que contém o elemento a ser testado.

Valor de retorno

true se o elemento testado for um caractere em maiúsculas; false se não for.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). é( ctype<CharType>:: upper, Ch).

Exemplo

// locale_isupper.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isupper ( 'L', loc );
   bool result2 = isupper ( 'n', loc );
   bool result3 = isupper ( '3', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a uppercase character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a uppercase character." << endl;

   if ( result2 )
      cout << "The character 'n' in the locale is "
           << "a uppercase character." << endl;
   else
      cout << "The character 'n' in the locale is "
           << " not a uppercase character." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "a uppercase character." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not a uppercase character." << endl;
}

isxdigit

Testa se um elemento em uma localidade é um caractere usado para representar um número hexadecimal.

template <class CharType>
bool isxdigit(CharType Ch, const locale& Loc)

Parâmetros

Ch
O elemento a ser testado.

Loc
A localidade que contém o elemento a ser testado.

Valor de retorno

true se o elemento testado for um caractere usado para representar um número hexadecimal; false se não for.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). é( ctype<CharType>:: xdigit, Ch).

Dígitos hexadecimais usam base 16 para representar números, usando os números de 0 a 9 e letras de A a F, sem diferenciar maiúsculas e minúsculas, para representar os números decimais de 0 a 15.

Exemplo

// locale_isxdigit.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isxdigit ( '5', loc );
   bool result2 = isxdigit ( 'd', loc );
   bool result3 = isxdigit ( 'q', loc );

   if ( result1 )
      cout << "The character '5' in the locale is "
           << "a hexidecimal digit-character." << endl;
   else
      cout << "The character '5' in the locale is "
           << " not a hexidecimal digit-character." << endl;

   if ( result2 )
      cout << "The character 'd' in the locale is "
           << "a hexidecimal digit-character." << endl;
   else
      cout << "The character 'd' in the locale is "
           << " not a hexidecimal digit-character." << endl;

   if ( result3 )
      cout << "The character 'q' in the locale is "
           << "a hexidecimal digit-character." << endl;
   else
      cout << "The character 'q' in the locale is "
           << " not a hexidecimal digit-character." << endl;
}

tolower

Converte um caractere em letra minúscula.

template <class CharType>
CharType tolower(CharType Ch, const locale& Loc)

Parâmetros

Ch
O caractere a ser convertido em letras minúsculas.

Loc
A localidade que contém o caractere a ser convertido.

Valor de retorno

O caractere convertido em letras minúsculas.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). tolower( Ch).

Exemplo

// 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;
}

toupper

Converte um caractere em letra maiúscula.

template <class CharType>
CharType toupper(CharType Ch, const locale& Loc)

Parâmetros

Ch
O caractere a ser convertido em maiúsculas.

Loc
A localidade que contém o caractere a ser convertido.

Valor de retorno

O caractere convertido em maiúsculas.

Comentários

A função de modelo retorna use_facet<ctype<CharType>>( Loc). toupper( Ch).

Exemplo

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

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

use_facet

Retorna uma referência para uma faceta de um tipo especificado armazenada em uma localidade.

template <class Facet>
const Facet& use_facet(const locale& Loc);

Parâmetros

Loc
A localidade const que contém o tipo de faceta que está sendo referenciado.

Valor de retorno

Uma referência à faceta da classe Facet contida na localidade do argumento.

Comentários

A referência à faceta retornada pela função de modelo permanece válida, desde que exista qualquer cópia da localidade que a contém. Se nenhum objeto de faceta da classe Facet estiver listado na localidade do argumento, a função gerará uma exceção bad_cast.

Exemplo

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

int main( )
{
   locale loc1 ( "German_Germany" ), loc2 ( "English_Australia" );
   bool result1 = use_facet<ctype<char> > ( loc1 ).is(
   ctype_base::alpha, 'a'
);
   bool result2 = use_facet<ctype<char> > ( loc2 ).is( ctype_base::alpha, '!'
   );

   if ( result1 )
      cout << "The character 'a' in locale loc1 is alphabetic."
           << endl;
   else
      cout << "The character 'a' in locale loc1 is not alphabetic."
           << endl;

   if ( result2 )
      cout << "The character '!' in locale loc2 is alphabetic."
           << endl;
   else
      cout << "The character '!' in locale loc2 is not alphabetic."
           << endl;
}

The character 'a' in locale loc1 is alphabetic.
The character '!' in locale loc2 is not alphabetic.

Confira também

Compartilhar via

Funções <locale>

has_facet

Parâmetros

Valor de retorno

Comentários

Exemplo

isalnum

Parâmetros

Valor de retorno

Exemplo

isalpha

Parâmetros

Valor de retorno

Comentários

Exemplo

iscntrl

Parâmetros

Valor de retorno

Comentários

Exemplo

isdigit

Parâmetros

Valor de retorno

Comentários

Exemplo

isgraph

Parâmetros

Valor de retorno

Comentários

Exemplo

islower

Parâmetros

Valor de retorno

Comentários

Exemplo

isprint

Parâmetros

Valor de retorno

Comentários

Exemplo

ispunct

Parâmetros

Valor de retorno

Comentários

Exemplo

isspace

Parâmetros

Valor de retorno

Comentários

Exemplo

isupper

Parâmetros

Valor de retorno

Comentários

Exemplo

isxdigit

Parâmetros

Valor de retorno

Comentários

Exemplo

tolower

Parâmetros

Valor de retorno

Comentários

Exemplo

toupper

Parâmetros

Valor de retorno

Comentários

Exemplo

use_facet

Parâmetros

Valor de retorno

Comentários

Exemplo

Confira também

Comentários

Recursos adicionais

Funções `<locale>`