money_get (Clase)
La clase de plantilla describe un objeto que puede actuar como una faceta de configuración regional para controlar las conversiones de secuencias de tipo CharType en valores monetarios.
Sintaxis
template <class CharType, class InputIterator = istreambuf_iterator<CharType>>
class money_get : public locale::facet;
Parámetros
CharType
Tipo usado dentro de un programa para codificar los caracteres de una configuración regional.
InputIterator
Tipo de iterador del que las funciones get leen su entrada.
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.
Constructores
| Constructor | Descripción |
|---|---|
| money_get | Constructor de objetos de tipo money_get que se usan para extraer valores numéricos de secuencias que representan valores monetarios. |
Typedefs
| Nombre de tipo | Descripción |
|---|---|
| char_type | Tipo que se usa para describir un carácter empleado por una configuración regional. |
| iter_type | Tipo que describe un iterador de entrada. |
| string_type | Tipo que describe una cadena que contiene caracteres de tipo CharType. |
Funciones miembro
| Función de miembro | Descripción |
|---|---|
| do_get | Función virtual a la que se llama para extraer un valor numérico de una secuencia de caracteres que representa un valor monetario. |
| get | Extrae un valor numérico de una secuencia de caracteres que representa un valor monetario. |
Requisitos
Encabezado:<locale>
Espacio de nombres: std
money_get::char_type
Tipo que se usa para describir un carácter empleado por una configuración regional.
typedef CharType char_type;
Comentarios
El tipo es un sinónimo del parámetro de plantilla CharType.
money_get::d o_get
Función virtual a la que se llama para extraer un valor numérico de una secuencia de caracteres que representa un valor monetario.
virtual iter_type do_get(iter_type first,
iter_type last,
bool Intl,
ios_base& Iosbase,
ios_base::iostate& State,
long double& val) const virtual iter_type do_get(iter_type first,
iter_type last,
bool Intl,
ios_base& Iosbase,
ios_base::iostate& State,
string_type& val) const
Parámetros
first
Iterador de entrada que se dirige al principio de la secuencia que se va a convertir.
last
Iterador de entrada que se dirige al final de la secuencia que se va a convertir.
Intl
Un valor booleano que indica el tipo de símbolo de moneda que se espera en la secuencia: true si es internacional, false si es nacional.
Iosbase
Un formato de marca que cuando está establecido indica que el símbolo de moneda es opcional. De lo contrario, es obligatorio.
State
Establece los elementos de máscara de bits apropiados para el estado de la secuencia en función de si las operaciones se realizaron correctamente o no.
val
Una cadena que almacena la secuencia convertida.
Valor devuelto
Un iterador de entrada que se dirige al primer elemento más allá del campo de entrada monetario.
Comentarios
La primera función miembro virtual protegida intenta hacer coincidir los elementos secuenciales, empezando al principio de la secuencia [ first, last) hasta que reconoce un campo de entrada monetario completo y que no esté vacío. Si se realiza correctamente, convierte este campo en una secuencia de uno o más dígitos decimales, opcionalmente precedido por un signo menos (-), para representar la cantidad y almacena el resultado en el objeto string_typeval. Devuelve un iterador que designa el primer elemento más allá del campo de entrada monetario. De otro modo, la función almacena una secuencia vacía en val y establece ios_base::failbit en State. Devuelve un iterador que designa el primer elemento más allá de cualquier prefijo de campo de entrada monetario válido. En cualquier caso, si el valor devuelto es igual a last, la función establece ios_base::eofbit en State.
La segunda función miembro virtual protegida se comporta de la misma manera que la primera, a excepción de que, si se realiza correctamente, convierte la secuencia de dígitos con signo opcional en un valor de tipo long double y almacena ese valor en val.
El formato de un campo de entrada monetario se determina por la faceta de configuración regionalfac devuelta mediante la llamada eficaz a use_facet<moneypunct<CharType, intl>> (iosbase. getloc).
Específicamente:
fac. neg_format determina el orden en el que aparecen los componentes del campo.
fac. curr_symbol determina la secuencia de elementos que constituye un símbolo de moneda.
fac. positive_sign determina la secuencia de elementos que constituye un signo positivo.
fac. negative_sign determina la secuencia de elementos que constituye un signo negativo.
fac. grouping determina cómo se agrupan los dígitos a la izquierda de cualquier separador decimal.
fac. thousands_sep determina el elemento que separa grupos de dígitos a la izquierda de cualquier separador decimal.
fac. decimal_point determina el elemento que separa los dígitos enteros de los dígitos de fracción.
fac. frac_digits determina el número de dígitos de fracción significativos a la derecha de cualquier separador decimal. Al analizar una cantidad monetaria con más dígitos de fracción que a los que se llama mediante
frac_digits,do_getdetiene el análisis después de consumirfrac_digitscaracteres como máximo.
Si el símbolo cadena (fac. negative_sign o fac. positive_sign) tiene más de un elemento, solo coincide con el primer elemento donde el elemento igual a money_base::sign aparece en el patrón de formato ( fac. neg_format). Coincide con cualquier elemento restante al final del campo de entrada monetario. Si ninguna cadena tiene un primer elemento que coincide con el siguiente elemento del campo de entrada monetario, la cadena de signo se toma como vacía y el signo es positivo.
Si iosbase. flags & showbase es distinto de cero, la cadena fac. curr_symbol debe coincidir donde el elemento igual a money_base::symbol aparece en el patrón de formato. De otro modo, si money_base::symbol se produce al final del patrón de formato y, si ningún elemento de la cadena de signo debe coincidir, no coincide con el símbolo de moneda. De otro modo, coincide con el símbolo de moneda de manera opcional.
Si ninguna instancia de fac. thousands_sep se produce en la parte de valor del campo de entrada monetario (donde el elemento igual a money_base::value aparece en el patrón de formato), no se impone ninguna restricción de agrupación. De otro modo, cualquier restricción de agrupación impuesta por fac. grouping se aplica. Tenga en cuenta que la secuencia de dígitos resultante representa un entero cuyos dígitos decimales fac. frac_digits de nivel bajo se colocan a la derecha del separador decimal.
Coincide con el espacio en blanco arbitrario donde el elemento igual a money_base::space aparece en el patrón de formato, si aparece en otro lugar diferente que al final del patrón de formato. De otro modo, no coincide con ningún espacio en blanco interno. Un elemento ch se considera un espacio en blanco si use_facet<ctype<CharType>> (iosbase. getloc). is( ctype_base::space, ch) es true.
Ejemplo
Vea el ejemplo de get, que llama a do_get.
money_get::get
Extrae un valor numérico de una secuencia de caracteres que representa un valor monetario.
iter_type get(iter_type first,
iter_type last,
bool Intl,
ios_base& Iosbase,
ios_base::iostate& State,
long double& val) const;
iter_type get(iter_type first,
iter_type last,
bool Intl,
ios_base& Iosbase,
ios_base::iostate& State,
string_type& val) const;
Parámetros
first
Iterador de entrada que se dirige al principio de la secuencia que se va a convertir.
last
Iterador de entrada que se dirige al final de la secuencia que se va a convertir.
Intl
Un valor booleano que indica el tipo de símbolo de moneda que se espera en la secuencia: true si es internacional, false si es nacional.
Iosbase
Un formato de marca que cuando está establecido indica que el símbolo de moneda es opcional. De lo contrario, es obligatorio.
State
Establece los elementos de máscara de bits apropiados para el estado de la secuencia en función de si las operaciones se realizaron correctamente.
val
Una cadena que almacena la secuencia convertida.
Valor devuelto
Un iterador de entrada que se dirige al primer elemento más allá del campo de entrada monetario.
Comentarios
Ambas funciones miembro devuelven do_get(first, last, Intl, Iosbase, State, val).
Ejemplo
// money_get_get.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
#include <sstream>
using namespace std;
int main( )
{
locale loc( "german_germany" );
basic_stringstream< char > psz;
psz << use_facet<moneypunct<char, 1> >(loc).curr_symbol() << "-1.000,56";
basic_stringstream< char > psz2;
psz2 << "-100056" << use_facet<moneypunct<char, 1> >(loc).curr_symbol();
ios_base::iostate st = 0;
long double fVal;
psz.flags( psz.flags( )|ios_base::showbase );
// Which forced the READING the currency symbol
psz.imbue(loc);
use_facet < money_get < char > >( loc ).
get( basic_istream<char>::_Iter( psz.rdbuf( ) ),
basic_istream<char>::_Iter( 0 ), true, psz, st, fVal );
if ( st & ios_base::failbit )
cout << "money_get(" << psz.str( ) << ", intl = 1) FAILED"
<< endl;
else
cout << "money_get(" << psz.str( ) << ", intl = 1) = "
<< fVal/100.0 << endl;
use_facet < money_get < char > >( loc ).
get(basic_istream<char>::_Iter(psz2.rdbuf( )),
basic_istream<char>::_Iter(0), false, psz2, st, fVal);
if ( st & ios_base::failbit )
cout << "money_get(" << psz2.str( ) << ", intl = 0) FAILED"
<< endl;
else
cout << "money_get(" << psz2.str( ) << ", intl = 0) = "
<< fVal/100.0 << endl;
};
money_get::iter_type
Tipo que describe un iterador de entrada.
typedef InputIterator iter_type;
Comentarios
El tipo es un sinónimo del parámetro de plantilla InputIterator.
money_get::money_get
Constructor de objetos de tipo money_get que se usan para extraer valores numéricos de secuencias que representan valores monetarios.
explicit money_get(size_t _Refs = 0);
Parámetros
_Refs
Valor entero que se usa para especificar el tipo de administración de memoria del objeto.
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).
money_get::string_type
Un tipo que describe una cadena que contiene caracteres de tipo CharType.
typedef basic_string<CharType, Traits, Allocator> string_type;
Comentarios
El tipo describe una especialización de la plantilla clase basic_string.
Consulte también
<locale>
facet (Clase)
Seguridad para subprocesos en la biblioteca estándar de C++
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de