std::num_put::put, std::num_put::do_put

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de configuración regional

Configuraciones regionales y facetas
locale
use_facet	has_facet
Clasificación de caracteres
isspace isblank (C++11) iscntrl isupper islower isalpha	isdigit ispunct isxdigit isalnum isprint isgraph
Conversiones
toupper tolower	wstring_convert (C++11) wbuffer_convert (C++11)
Clases base de categorías de facetas
ctype_base codecvt_base messages_base	time_base money_base
Categorías de facetas
ctype ctype<char> codecvt collate messages time_get time_put	num_get num_put numpunct money_get money_put moneypunct
Facetas específicas de la configuración regional
ctype_byname codecvt_byname messages_byname collate_byname	time_get_byname time_put_byname numpunct_byname moneypunct_byname
Facetas de conversión de código
codecvt_utf8 (C++11) codecvt_utf16 (C++11)	codecvt_utf8_utf16 (C++11) codecvt_mode (C++11)
Configuración regional de C
setlocale localeconv lconv	LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME

 

std::num_put

Las funciones miembro Original: Member functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

num_put::num_put

num_put::~num_put

num_put::putnum_put::do_put

 

Definido en el archivo de encabezado <locale>
public: iter_type put( iter_type out, std::ios_base& str, char_type fill, bool v) const; iter_type put( iter_type out, std::ios_base& str, char_type fill, long v) const; iter_type put( iter_type out, std::ios_base& str, char_type fill, long long v) const; iter_type put( iter_type out, std::ios_base& str, char_type fill, unsigned long v) const; iter_type put( iter_type out, std::ios_base& str, char_type fill, unsigned long long v) const; iter_type put( iter_type out, std::ios_base& str, char_type fill, double v) const; iter_type put( iter_type out, std::ios_base& str, char_type fill, long double v) const; iter_type put( iter_type out, std::ios_base& str, char_type fill, const void* v) const;	(1)
protected: iter_type do_put( iter_type out, std::ios_base& str, char_type fill, bool v) const; iter_type do_put( iter_type out, std::ios_base& str, char_type fill, long v) const; iter_type do_put( iter_type out, std::ios_base& str, char_type fill, long long v) const; iter_type do_put( iter_type out, std::ios_base& str, char_type fill, unsigned long) const; iter_type do_put( iter_type out, std::ios_base& str, char_type fill, unsigned long long) const; iter_type do_put( iter_type out, std::ios_base& str, char_type fill, double v) const; iter_type do_put( iter_type out, std::ios_base& str, char_type fill, long double v) const; iter_type do_put( iter_type out, std::ios_base& str, char_type fill, const void* v) const;	(2)

1)

función miembro pública, llama a la función virtual protegido do_put miembro de la clase más derivada .

Original:

public member function, calls the protected virtual member function do_put of the most derived class.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

2)

escribe los caracteres a la out secuencia de salida que representan el valor de v, con el formato requerido por las banderas de formato str.flags() y las facetas std::numpunct y std::ctype de la configuración regional imbuida en la str corriente. Esta función es llamada por todos los operadores de flujo con formato de salida, como std::cout << n; .

Original:

writes characters to the output sequence out which represent the value of v, formatted as requested by the formatting flags str.flags() and the std::numpunct and std::ctype facets of the locale imbued in the stream str. This function is called by all formatted output stream operators, such as std::cout << n;.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

La conversión ocurre en cuatro etapas

Original:

Conversion occurs in four stages

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Etapa 1: Conversión de selección especificador

• I / O banderas de formato se obtienen, como por

  Original:

  I/O format flags are obtained, as if by

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

fmtflags basefield = (str.flags() & std::ios_base::basefield);

fmtflags uppercase = (str.flags() & std::ios_base::uppercase);

fmtflags floatfield = (str.flags() & std::ios_base::floatfield);

fmtflags showpos = (str.flags() & std::ios_base::showpos);

fmtflags showbase = (str.flags() & std::ios_base::showbase);

• Si el tipo de v es bool

  Original:

  If the type of v is bool

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• * Si boolalpha == 0, a continuación, convierte al tipo v int y lleva a cabo la producción entero .

  Original:

  * If boolalpha == 0, then converts v to type int and performs integer output.

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• * Si obtiene boolalpha != 0 std::use_facet<std::numpunct<charT>>(str.getloc()).truename() si v == true o std::use_facet<std::numpunct<charT>>(str.getloc()).falsename() si v == false, y envía cada c carácter sucesivo de esa cadena a out con *out++ = c. Sin ulterior elaboración se hace en este caso, la función devuelve out .

  Original:

  * If boolalpha != 0 obtains std::use_facet<std::numpunct<charT>>(str.getloc()).truename() if v == true or std::use_facet<std::numpunct<charT>>(str.getloc()).falsename() if v == false, and outputs each successive character c of that string to out with *out++ = c. No further processing is done in this case, the function returns out.

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Si el tipo de v es un tipo entero, la elección de la primera aplicable de las cinco siguientes se selecciona:

  Original:

  If the type of v is an integer type, the the first applicable choice of the following five is selected:

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Si basefield == oct, utilizará especificador de conversión %o

Original:

If basefield == oct, will use conversion specifier %o

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si basefield == hex && !uppercase, utilizará especificador de conversión %x

Original:

If basefield == hex && !uppercase, will use conversion specifier %x

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si basefield == hex, utilizará especificador de conversión %X

Original:

If basefield == hex, will use conversion specifier %X

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si el tipo de v está firmado, usaremos la conversión especificador %d

Original:

If the type of v is signed, will use conversion specifier %d

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si el tipo de v no está firmado, usaremos la conversión especificador %u

Original:

If the type of v is unsigned, will use conversion specifier %u

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

• Para tipos de enteros, modificador de longitud se añade a la especificación de la conversión si es necesario: l para long y unsigned long, ll para long long y unsigned long long .

  Original:

  For integer types, length modifier is added to the conversion specification if necessary: l for long and unsigned long, ll for long long and unsigned long long.

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Si el tipo de v es un tipo de punto flotante, la elección de la primera aplicable de las cinco siguientes se selecciona:

  Original:

  If the type of v is a floating-point type, the the first applicable choice of the following five is selected:

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Si floatfield == std::ios_base::fixed, utilizará especificador de conversión %f

Original:

If floatfield == std::ios_base::fixed, will use conversion specifier %f

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si floatfield == std::ios_base::scientific && !uppercase, utilizará especificador de conversión %e

Original:

If floatfield == std::ios_base::scientific && !uppercase, will use conversion specifier %e

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si floatfield == std::ios_base::scientific, utilizará especificador de conversión %E

Original:

If floatfield == std::ios_base::scientific, will use conversion specifier %E

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si floatfield == (std::ios_base::fixed | std::ios_base::scientific) && !uppercase, utilizará especificador de conversión %a (desde C++11)

Original:

If floatfield == (std::ios_base::fixed | std::ios_base::scientific) && !uppercase, will use conversion specifier %a (desde C++11)

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si floatfield == std::ios_base::fixed | std::ios_base::scientific, utilizará especificador de conversión %A (desde C++11)

Original:

If floatfield == std::ios_base::fixed | std::ios_base::scientific, will use conversion specifier %A (desde C++11)

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si !uppercase, utilizará especificador de conversión %g

Original:

If !uppercase, will use conversion specifier %g

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

de lo contrario, va a utilizar la conversión especificador %G

Original:

otherwise, will use conversion specifier %G

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

• * Si el tipo de v es long double, la L modificador de longitud se añade al indicador de conversión .

  Original:

  * If the type of v is long double, the length modifier L is added to the conversion specifier.

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• * Además, si floatfield != (ios_base::fixed | ios_base::scientific), entonces modificador se añade precisión, ajuste a str.precision()

  Original:

  * Additionally, if floatfield != (ios_base::fixed | ios_base::scientific), then precision modifier is added, set to str.precision()

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Para ambos tipos de enteros y de punto flotante, si showbase se establece, el # modificador se antepone. Si showpos se establece, el + modificador se antepone .

  Original:

  For both integer and floating-point types, if showbase is set, the modifier # is prepended. If showpos is set, the modifier + is prepended.

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Si el tipo de v es void*, se utilizan la conversión especificador %p

  Original:

  If the type of v is void*, will use conversion specifier %p

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Una cadena de caracteres estrecho se crea como si de una llamada a std::printf(spec, v) en la localización "C", donde spec es el especificador de conversión elegido .

  Original:

  A narrow character string is created as if by a call to std::printf(spec, v) in the "C" locale, where spec is the chosen conversion specifier.

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Etapa 2: configuración regional específica conversión

• Cada carácter c obtenido en la etapa 1, con excepción de la '.' punto decimal, se convierte a CharT llamando std::use_facet<std::ctype<CharT>>(str.getloc()).widen(c) .

  Original:

  Every character c obtained in Stage 1, other than the decimal point '.', is converted to CharT by calling std::use_facet<std::ctype<CharT>>(str.getloc()).widen(c).

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Para los tipos aritméticos, el carácter separador de miles, obtenido a partir de std::use_facet<std::numpunct<CharT>>(str.getloc()).thousands_sep(), se inserta en la secuencia de acuerdo con las reglas de agrupamiento proporcionados por std::use_facet<std::numpunct<CharT>>(str.getloc()).grouping()

  Original:

  For arithmetic types, the thousands separator character, obtained from std::use_facet<std::numpunct<CharT>>(str.getloc()).thousands_sep(), is inserted into the sequence according to the grouping rules provided by std::use_facet<std::numpunct<CharT>>(str.getloc()).grouping()

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Carácter de punto decimal ('.') se sustituyen por std::use_facet<std::numpunct<CharT>>(str.getloc()).decimal_point()

  Original:

  Decimal point characters ('.') are replaced by std::use_facet<std::numpunct<CharT>>(str.getloc()).decimal_point()

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Etapa 3: relleno

• La bandera de ajuste se obtiene como por std::fmtflags adjustfield = (flags & (std::ios_base::adjustfield)) y se examinaron para identificar la ubicación relleno, como sigue

  Original:

  The adjustment flag is obtained as if by std::fmtflags adjustfield = (flags & (std::ios_base::adjustfield)) and examined to identify padding location, as follows

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Si adjustfield == std::ios_base::left, se rellenará después

Original:

If adjustfield == std::ios_base::left, will pad after

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si adjustfield == std::ios_base::right, se rellenará antes

Original:

If adjustfield == std::ios_base::right, will pad before

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si adjustfield == std::ios_base::internal y un carácter de signo se produce en la representación, se rellenará después de la señal

Original:

If adjustfield == std::ios_base::internal and a sign character occurs in the representation, will pad after the sign

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Si adjustfield == std::ios_base::internal y representación de la Etapa 1 se inició con 0x o 0X, se rellenará después de la X o X

Original:

If adjustfield == std::ios_base::internal and Stage 1 representation began with 0x or 0X, will pad after the x or X

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

de lo contrario, se rellenará antes

Original:

otherwise, will pad before

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

• Si str.width() no es cero (std::setw por ejemplo, se utilizó sólo) y el número de la gráfica, después de la etapa 2 es menor que str.width(), entonces copias del carácter fill se insertan en la posición indicada por el relleno para que la duración de la secuencia de str.width().

  Original:

  If str.width() is non-zero (e.g. std::setw was just used) and the number of CharT's after Stage 2 is less than str.width(), then copies of the fill character are inserted at the position indicated by padding to bring the length of the sequence to str.width().

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Etapa 4: salida

Cada c carácter sucesivo a partir de la secuencia de la gráfica de la Etapa 3 se emite como por *out++ = c .

Original:

Every successive character c from the sequence of CharT's from Stage 3 is output as if by *out++ = c.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Parámetros

out	-	iterador que apunta al primer carácter que se sobrescriba Original: iterator pointing to the first character to be overwritten The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
str	-	transmitir a recuperar la información de formato de Original: stream to retrieve the formatting information from The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
fill	-	carácter de relleno utilizado cuando los resultados debe ser acolchado para el ancho de campo Original: padding character used when the results needs to be padded to the field width The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
v	-	valor para convertir en una cadena y la producción Original: value to convert to string and output The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

Valor de retorno

out

Notas

El cero inicial generado por la especificación de conversión #o (resultante de la combinación de std::showbase y std::oct por ejemplo) no se cuenta como un carácter de relleno .

Original:

The leading zero generated by the conversion specification #o (resulting from the combination of std::showbase and std::oct for example) is not counted as a padding character.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Ejemplo

Genere un número usando la configuración regional global

Original:

Output a number using global locale

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Ejecuta este código

#include <iostream>
#include <locale>

int main()
{
    auto &facet = std::use_facet<std::num_put<char>>(std::locale());
    facet.put(std::cout, std::cout, '0', 2.71);
    std::cout << '\n';
}

Salida:

2,71

Ver también

operator<<

Inserta datos con formato. (función miembro pública de std::basic_ostream<CharT,Traits>)