use_facet

Retorna uma referência a uma faceta de um tipo especificado armazenado em uma localidade.

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

Parâmetros

• _Loc
  A localidade de const que contém o tipo de faceta que está sendo referenciada.

Valor de retorno

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

Comentários

A referência à faceta retornado pela função do modelo permaneça válida como qualquer cópia da localidade de que contém existe. Se tal objeto da faceta da classe Facet é listado na localidade do argumento, a função gerará uma exceção de 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;
}

Requisitos

localidade <deCabeçalho: >

Namespace: std