`<locale>` funzioni

Articolo
10/12/2023

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

has_facet

Verifica se un facet specifico viene archiviato nelle impostazioni locali specificate.

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

Parametri

Loc
Impostazioni locali in cui verificare l'eventuale presenza di un facet.

Valore restituito

true se le impostazioni locali hanno il facet testato per; false se non lo fa.

Osservazioni:

La funzione modello è utile per verificare, prima della chiamata a use_facet, se i facet non obbligatori sono elencati nelle impostazioni locali, in modo da evitare l'eccezione che verrebbe generata se non fossero presenti.

Esempio

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

Verifica se un elemento delle impostazioni locali è un carattere alfabetico o numerico.

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

Parametri

Ch
Elemento alfanumerico da verificare.

Loc
Impostazioni locali contenenti l'elemento alfanumerico da verificare.

Valore restituito

true se l'elemento testato è alfanumerico; false se non lo è.

Esempio

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

Verifica se un elemento delle impostazioni locali è un carattere alfabetico.

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

Parametri

Ch
Elemento da verificare.

Loc
Impostazioni locali contenenti l'elemento alfabetico da verificare.

Valore restituito

true se l'elemento testato è alfabetico; false se non lo è.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: alpha, Ch).

Esempio

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

Verifica se un elemento delle impostazioni locali è un carattere di controllo.

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

Parametri

Ch
Elemento da verificare.

Loc
Impostazioni locali contenenti l'elemento da verificare.

Valore restituito

true se l'elemento testato è un carattere di controllo; false se non lo è.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: cntrl, Ch).

Esempio

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

Verifica se un elemento delle impostazioni locali è un carattere numerico.

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

Parametri

Ch
Elemento da verificare.

Loc
Impostazioni locali contenenti l'elemento da verificare.

Valore restituito

true se l'elemento testato è un carattere numerico; false se non lo è.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: digit, Ch).

Esempio

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

Verifica se un elemento delle impostazioni locali è un carattere alfanumerico o di punteggiatura.

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

Parametri

Ch
Elemento da verificare.

Loc
Impostazioni locali contenenti l'elemento da verificare.

Valore restituito

true se l'elemento testato è un carattere alfanumerico o di punteggiatura; false se non lo è.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: graph, Ch).

Esempio

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

Verifica se un elemento delle impostazioni locali è un carattere minuscolo.

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

Parametri

Ch
Elemento da verificare.

Loc
Impostazioni locali contenenti l'elemento da verificare.

Valore restituito

true se l'elemento testato è un carattere minuscolo; false se non lo è.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: lower, Ch).

Esempio

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

Verifica se un elemento delle impostazioni locali è un carattere stampabile.

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

Parametri

Ch
Elemento da verificare.

Loc
Impostazioni locali contenenti l'elemento da verificare.

Valore restituito

true se l'elemento testato è stampabile; false se non lo è.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: print, Ch).

Esempio

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

Verifica se un elemento delle impostazioni locali è un carattere di punteggiatura.

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

Parametri

Ch
Elemento da verificare.

Loc
Impostazioni locali contenenti l'elemento da verificare.

Valore restituito

true se l'elemento testato è un carattere di punteggiatura; false se non lo è.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: punct, Ch).

Esempio

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

Verifica se un elemento delle impostazioni locali è uno spazio vuoto.

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

Parametri

Ch
Elemento da verificare.

Loc
Impostazioni locali contenenti l'elemento da verificare.

Valore restituito

true se l'elemento testato è un carattere di spazio vuoto; false se non lo è.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: space, Ch).

Esempio

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

Verifica se un elemento delle impostazioni locali è un carattere maiuscolo.

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

Parametri

Ch
Elemento da verificare.

Loc
Impostazioni locali contenenti l'elemento da verificare.

Valore restituito

true se l'elemento testato è un carattere maiuscolo; false se non lo è.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: upper, Ch).

Esempio

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

Verifica se un elemento delle impostazioni locali è un carattere utilizzato per rappresentare un numero esadecimale.

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

Parametri

Ch
Elemento da verificare.

Loc
Impostazioni locali contenenti l'elemento da verificare.

Valore restituito

true se l'elemento testato è un carattere utilizzato per rappresentare un numero esadecimale; false se non lo è.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: xdigit, Ch).

Le cifre esadecimali usano la base 16, con numeri da 0 a 9 e lettere da A a F senza distinzione tra maiuscole e minuscole, per rappresentare i numeri decimali da 0 a 15.

Esempio

// 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 un carattere in minuscolo.

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

Parametri

Ch
Carattere da convertire in minuscolo.

Loc
Impostazioni locali contenenti il carattere da convertire.

Valore restituito

Carattere convertito in minuscolo.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc tolower( Ch).

Esempio

// 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 un carattere in maiuscolo.

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

Parametri

Ch
Carattere da convertire in maiuscolo.

Loc
Impostazioni locali contenenti il carattere da convertire.

Valore restituito

Carattere convertito in maiuscolo.

Osservazioni:

La funzione modello restituisce use_facet<ctype<CharType>>( ). Loc toupper( Ch).

Esempio

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

Restituisce un riferimento a un facet di un tipo specificato archiviato nelle impostazioni locali.

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

Parametri

Loc
Impostazioni locali const contenenti il tipo di facet a cui viene fatto riferimento.

Valore restituito

Riferimento al facet della classe Facet contenuto nelle impostazioni locali dell'argomento.

Osservazioni:

Il riferimento al facet restituito dalla funzione modello rimane valido a condizione che esista una copia delle impostazioni locali che contengono il facet. Se nelle impostazioni locali dell'argomento non è elencato alcun oggetto facet delle classe Facet, la funzione genera un'eccezione bad_cast.

Esempio

// 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.

Vedi anche

Condividi tramite

<locale> funzioni

has_facet

Parametri

Valore restituito

Osservazioni:

Esempio

isalnum

Parametri

Valore restituito

Esempio

isalpha

Parametri

Valore restituito

Osservazioni:

Esempio

iscntrl

Parametri

Valore restituito

Osservazioni:

Esempio

isdigit

Parametri

Valore restituito

Osservazioni:

Esempio

isgraph

Parametri

Valore restituito

Osservazioni:

Esempio

islower

Parametri

Valore restituito

Osservazioni:

Esempio

isprint

Parametri

Valore restituito

Osservazioni:

Esempio

ispunct

Parametri

Valore restituito

Osservazioni:

Esempio

isspace

Parametri

Valore restituito

Osservazioni:

Esempio

isupper

Parametri

Valore restituito

Osservazioni:

Esempio

isxdigit

Parametri

Valore restituito

Osservazioni:

Esempio

tolower

Parametri

Valore restituito

Osservazioni:

Esempio

toupper

Parametri

Valore restituito

Osservazioni:

Esempio

use_facet

Parametri

Valore restituito

Osservazioni:

Esempio

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive

`<locale>` funzioni