messages (Clase)

La plantilla de clase describe un objeto que puede actuar como una faceta de configuración regional para recuperar mensajes traducidos y adaptados de un catálogo de mensajes internacionalizados para una configuración regional concreta.

Actualmente, mientras se implementa la clase messages, no hay mensajes.

Sintaxis

template <class CharType>
class messages : public messages_base;

Parámetros

CharType
Tipo usado dentro de un programa para codificar los caracteres de una configuración regional.

Comentarios

Como ocurre con cualquier faceta de configuración regional, el identificador de objeto estático tiene un valor almacenado inicial de cero. El primer intento de acceso a su valor almacenado almacena un valor positivo único en id.

Básicamente esta faceta abre un catálogo de mensajes definidos en la clase base messages_base, recupera la información necesaria y cierra el catálogo.

Constructores

Constructor	Descripción
messages	Función constructor de la faceta de mensajes.

Typedefs

Nombre de tipo	Descripción
char_type	Tipo de carácter usado para mostrar mensajes.
string_type	Un tipo que describe una cadena de tipo basic_string que contiene caracteres de tipo CharType.

Funciones miembro

Función de miembro	Descripción
close	Cierra el catálogo de mensajes.
do_close	Una función virtual llamada para perder el catálogo de mensajes.
do_get	Una función virtual llamada para recuperar el catálogo de mensajes.
do_open	Una función virtual llamada para abrir el catálogo de mensajes.
get	Recupera el catálogo de mensajes.
open	Abre el catálogo de mensajes.

Requisitos

Encabezado:<locale>

Espacio de nombres: std

messages::char_type

Tipo de carácter usado para mostrar mensajes.

typedef CharType char_type;

Comentarios

El tipo es un sinónimo del parámetro de plantilla CharType.

messages::close

Cierra el catálogo de mensajes.

void close(catalog _Catval) const;

Parámetros

_Catval
El catálogo que se va a cerrar.

Comentarios

La función miembro llama a do_close(_ Catval).

messages::d o_close

Una función virtual llamada para perder el catálogo de mensajes.

virtual void do_close(catalog _Catval) const;

Parámetros

_Catval
El catálogo que se va a cerrar.

Comentarios

La función miembro protegida cierra el catálogo de mensajes _Catval, que debe haberse abierto mediante una llamada anterior a do_open.

_Catval debe obtenerse de un catálogo abierto anteriormente que no esté cerrado.

Ejemplo

Vea el ejemplo de close, que llama a do_close.

messages::d o_get

Una función virtual llamada para recuperar el catálogo de mensajes.

virtual string_type do_get(
    catalog _Catval,
    int _Set,
    int _Message,
    const string_type& _Dfault) const;

Parámetros

_Catval
El valor de identificación que especifica el catálogo de mensajes que se va a buscar.

_Set
El primer identificado localizaba un mensaje en un catálogo de mensajes.

_Message
El segundo identificado localizaba un mensaje en un catálogo de mensajes.

_Dfault
La cadena que se va a devolver en caso de error.

Valor devuelto

Devuelve una copia de _Dfault en caso de error. De otro modo, devuelve una copia de la secuencia de mensajes especificada.

Comentarios

La función miembro protegida intenta obtener una secuencia de mensajes del catálogo de mensajes _Catval. Hace uso de _Set, _Message y _Dfault al hacerlo.

Ejemplo

Vea el ejemplo de get, que llama a do_get.

messages::d o_open

Una función virtual llamada para abrir el catálogo de mensajes.

virtual catalog do_open(
    const string& _Catname,
    const locale& _Loc) const;

Parámetros

_Catname
El nombre del catálogo que se va a buscar.

_Loc
La configuración regional que se está buscando en el catálogo.

Valor devuelto

Devuelve un valor que se compara con menos de cero en caso de error. De otro modo, el valor devuelto puede usarse como el primer argumento en una llamada posterior a get.

Comentarios

La función miembro protegida intenta abrir un catálogo de mensajes cuyo nombre es _Catname. Hace uso de la configuración regional _Loc al hacerlo

El valor devuelto debe usarse como el argumento en una llamada posterior a close.

Ejemplo

Vea el ejemplo de open, que llama a do_open.

messages::get

Recupera el catálogo de mensajes.

string_type get(
    catalog _CatVal,
    int _Set,
    int _Message,
    const string_type& _Dfault) const;

Parámetros

_Catval
El valor de identificación que especifica el catálogo de mensajes que se va a buscar.

_Set
El primer identificado localizaba un mensaje en un catálogo de mensajes.

_Message
El segundo identificado localizaba un mensaje en un catálogo de mensajes.

_Dfault
La cadena que se va a devolver en caso de error.

Valor devuelto

Devuelve una copia de _Dfault en caso de error. De otro modo, devuelve una copia de la secuencia de mensajes especificada.

Comentarios

La función miembro devuelve do_get( _Catval, _Set, _Message, _Dfault).

messages::messages

Función constructor de la faceta de mensajes.

explicit messages(
    size_t _Refs = 0);

protected: messages(
    const char* _Locname,
    size_t _Refs = 0);

Parámetros

_Refs
Valor entero que se usa para especificar el tipo de administración de memoria del objeto.

_Locname
El nombre de la configuración regional.

Comentarios

Los valores posibles del parámetro _Refs y su importancia son:

• 0: la vigencia del objeto se administra mediante las configuraciones regionales que lo contienen.

• 1: la vigencia del objeto se debe administrar de manera manual.

• > 1: estos valores no están definidos.

No es posible mostrar ejemplos directos, porque el destructor está protegido.

El constructor inicializa su objeto base con locale::facet( _Refs).

messages::open

Abre el catálogo de mensajes.

catalog open(
    const string& _Catname,
    const locale& _Loc) const;

Parámetros

_Catname
El nombre del catálogo que se va a buscar.

_Loc
La configuración regional que se está buscando en el catálogo.

Valor devuelto

Devuelve un valor que se compara con menos de cero en caso de error. De otro modo, el valor devuelto puede usarse como el primer argumento en una llamada posterior a get.

Comentarios

La función miembro devuelve do_open( _Catname, _Loc).

messages::string_type

Un tipo que describe una cadena de tipo basic_string que contiene caracteres de tipo CharType.

typedef basic_string<CharType, Traits, Allocator> string_type;

Comentarios

El tipo describe una especialización de plantilla de clase basic_string cuyos objetos pueden almacenar copias de las secuencias de mensajes.

Consulte también

<locale>
messages_base (Clase)
Seguridad para subprocesos en la biblioteca estándar de C++