funciones<iomanip>

  • Artículo

get_money
get_time
put_money
put_time
quoted
resetiosflags
setbase
setfill
setiosflags
setprecision
setw

get_money

Extrae un valor monetario de un flujo con el formato especificado y devuelve el valor en un parámetro.

template <class Money>
T7 get_money(Money& amount, bool use_intl);

Parámetros

amount
Valor monetario extraído.

use_intl
Si es true, use el formato internacional. El valor predeterminado es false.

Comentarios

El manipulador devuelve un objeto que, cuando se extrae del flujo str, se comporta como una formatted input function que llama a la función miembro get para la faceta de configuración regional money_get asociada a str, con use_intl para indicar el formato internacional. Si es correcto, la llamada almacena en amount el valor monetario extraído. Después, el manipulador devuelve str.

Money debe ser de tipo long double o una instancia de basic_string con los mismos parámetros de elemento y rasgos que str.

get_time

Extrae un valor de tiempo de un flujo con el formato especificado. Devuelve el valor en un parámetro como una estructura de tiempo.

template <class Elem>
T10 get_time(struct tm *time_ptr, const Elem *time_format);

Parámetros

time_ptr
Tiempo en forma de estructura de tiempo.

time_format
Formato que se va a usar para obtener el valor de tiempo.

Comentarios

El manipulador devuelve un objeto que, cuando se extrae del flujo str, se comporta como una formatted input function que llama a la función miembro get para la faceta de configuración regional time_get asociada a str, con tptr para indicar la estructura de tiempo y fmt para indicar el comienzo de una cadena de formato terminada en null. Si es correcto, la llamada almacena en la estructura de tiempo los valores asociados a todos los campos de tiempo extraídos. Después, el manipulador devuelve str.

Ejemplo

#include <ctime>
#include <iomanip>
#include <iostream>

int main()
{
    std::cout << "Enter a time, for example 15:24 for 3:24pm: ";
    struct std::tm when;
    std::cin >> std::get_time(&when, "%R");
    if (!std::cin.fail())
    {
        std::cout << "Entered: " << when.tm_hour << " hours, " << when.tm_min << " minutes\n";
    }

    return (int)std::cin.fail();
}

put_money

Inserta en un flujo un importe monetario con el formato especificado.

template <class Money>
T8 put_money(const Money& amount, bool use_intl);

Parámetros

amount
Importe monetario que se va a insertar en el flujo.

use_intl
true si manipulador debe usar el formato internacional, false si no debe hacerlo.

Valor devuelto

Devuelve str.

Comentarios

El manipulador devuelve un objeto que, cuando se inserta en el flujo str, se comporta como una función de salida con formato que llama a la función miembro put para la faceta de configuración regional money_put asociada a str. Si es correcto, la llamada inserta amount con el formato adecuado, con use_intl para indicar el formato internacional y str.fill() como el elemento de relleno. Después, el manipulador devuelve str.

Money debe ser de tipo long double o una instancia de basic_string con los mismos parámetros de elemento y rasgos que str.

put_time

Escribe un valor de tiempo de una estructura de tiempo en un flujo con el formato especificado.

template <class Elem>
T10 put_time(struct tm* time_ptr, const Elem* time_format);

Parámetros

time_ptr
Valor de tiempo que se va a escribir en el flujo, proporcionado en una estructura de tiempo.

time_format
Formato en el que se va a escribir el valor de tiempo.

Comentarios

El manipulador devuelve un objeto que, cuando se inserta en el flujo str, se comporta como una formatted output function. La función de salida llama a la función miembro put para la faceta de configuración regional time_put asociada a str. La función de salida usa time_ptr para indicar la estructura de tiempo y time_format para indicar el comienzo de una cadena de formato terminada en null. Si es correcto, la llamada inserta texto literal de la cadena de formato y valores convertidos de la estructura de tiempo. Después, el manipulador devuelve str.

quoted

(Nuevo en C++14) Manipulador iostream que permite realizar un práctico recorrido de ida y vuelta de cadenas dentro y fuera de flujos mediante los operadores >> y <<.

quoted(std::string str) // or wstring
quoted(const char* str) //or wchar_t*
quoted(std::string str, char delimiter, char escape) // or wide versions
quoted(const char* str, char delimiter, char escape) // or wide versions

Parámetros

str
std::string, char*, literal de cadena o literal de cadena sin formato, o una versión ancha de cualquiera de estos (por ejemplo, std::wstring, wchar_t*).

delimiter
Un carácter especificado por el usuario o carácter ancho, que se utilizará como delimitador para el principio y el final de la cadena.

escape
Un carácter especificado por el usuario o carácter ancho, que se utilizará como carácter de escape para las secuencias de escape dentro de la cadena.

Comentarios

Vea Usar operadores de inserción y controlar el formato.

Ejemplos

Este ejemplo muestra cómo utilizar quoted con el carácter de delimitador y de escape predeterminados mediante cadenas estrechas. También se admiten las cadenas anchas.

#include <iostream>
#include <iomanip>
#include <sstream>

using namespace std;

void show_quoted_v_nonquoted()
{
    // Results are identical regardless of input string type:
    // string inserted { R"(This is a "sentence".)" }; // raw string literal
    // string inserted { "This is a \"sentence\"." };  // regular string literal
    const char* inserted = "This is a \"sentence\".";  // const char*
    stringstream ss, ss_quoted;
    string extracted, extracted_quoted;

    ss << inserted;
    ss_quoted << quoted(inserted);

    cout << "ss.str() is storing       : " << ss.str() << endl;
    cout << "ss_quoted.str() is storing: " << ss_quoted.str() << endl << endl;

    // Round-trip the strings
    ss >> extracted;
    ss_quoted >> quoted(extracted_quoted);

    cout << "After round trip: " << endl;
    cout << "Non-quoted      : " << extracted << endl;
    cout << "Quoted          : " << extracted_quoted << endl;
}

int main(int argc, char* argv[])
{
    show_quoted_v_nonquoted();

    // Keep console window open in debug mode.
    cout << endl << "Press Enter to exit" << endl;
    string input{};
    getline(cin, input);
}

/* Output:
ss.str() is storing       : This is a "sentence".
ss_quoted.str() is storing: "This is a \"sentence\"."

After round trip:
Non-quoted      : This
Quoted          : This is a "sentence".

Press Enter to exit
*/

En el ejemplo siguiente se muestra cómo proporcionar un carácter de delimitador o de escape personalizado:

#include <iostream>
#include <iomanip>
#include <sstream>

using namespace std;

void show_custom_delimiter()
{
    string inserted{ R"("This" "is" "a" "heavily-quoted" "sentence".)" };
    // string inserted{ "\"This\" \"is\" \"a\" \"heavily-quoted\" \"sentence\"" };
    // const char* inserted{ "\"This\" \"is\" \"a\" \"heavily-quoted\" \"sentence\"" };
    stringstream ss, ss_quoted;
    string extracted;

    ss_quoted << quoted(inserted, '*');
    ss << inserted;
    cout << "ss_quoted.str() is storing: " << ss_quoted.str() << endl;
    cout << "ss.str() is storing       : " << ss.str() << endl << endl;

    // Use the same quoted arguments as on insertion.
    ss_quoted >> quoted(extracted, '*');

    cout << "After round trip: " << endl;
    cout << "Quoted          : " << extracted << endl;

    extracted = {};
    ss >> extracted;
    cout << "Non-quoted      : " << extracted << endl << endl;
}

void show_custom_escape()
{
    string inserted{ R"(\\root\trunk\branch\nest\egg\yolk)" };
    // string inserted{ "\\\\root\\trunk\\branch\\nest\\egg\\yolk" };
    stringstream ss, ss_quoted, ss_quoted_custom;
    string extracted;

    // Use '"' as delimiter and '~' as escape character.
    ss_quoted_custom << quoted(inserted, '"', '~');
    ss_quoted << quoted(inserted);
    ss << inserted;
    cout << "ss_quoted_custom.str(): " << ss_quoted_custom.str() << endl;
    cout << "ss_quoted.str()       : " << ss_quoted.str() << endl;
    cout << "ss.str()              : " << ss.str() << endl << endl;

    // No spaces in this string, so non-quoted behaves same as quoted
    // after round-tripping.
}

int main(int argc, char* argv[])
{
    cout << "Custom delimiter:" << endl;
    show_custom_delimiter();
    cout << "Custom escape character:" << endl;
    show_custom_escape();

    // Keep console window open in debug mode.
    cout << endl << "Press Enter to exit" << endl;
    string input{};
    getline(cin, input);
}
/* Output:
Custom delimiter:
ss_quoted.str() is storing: *"This" "is" "a" "heavily-quoted" "sentence".*
ss.str() is storing       : "This" "is" "a" "heavily-quoted" "sentence".

After round trip:
Quoted          : "This" "is" "a" "heavily-quoted" "sentence".
Non-quoted      : "This"

Custom escape character:
ss_quoted_custom.str(): "\\root\trunk\branch\nest\egg\yolk"
ss_quoted.str()       : "\\\\root\\trunk\\branch\\nest\\egg\\yolk"
ss.str()              : \\root\trunk\branch\nest\egg\yolk

Press Enter to exit
*/

resetiosflags

Borra las marcas especificadas.

T1 resetiosflags(ios_base::fmtflags mask);

Parámetros

mask
Marcas que se van a borrar.

Valor devuelto

El manipulador devuelve un objeto que, cuando se extrae del flujo str o se inserta en este, llama a str.setf(ios_base::fmtflags, mask) y luego devuelve str. Vea setf y fmtflags.

Ejemplo

Vea setw para obtener un ejemplo en el que se usa resetiosflags.

setbase

Establece la base de los enteros.

T3 setbase(int base);

Parámetros

base
Base numérica.

Valor devuelto

El manipulador devuelve un objeto que, cuando se extrae del flujo str o se inserta en este, llama a str.setf(mask, ios_base::basefield) y luego devuelve str. Vea ios_base::basefield. Aquí, mask se determina de la siguiente forma:

Ejemplo

Vea setw para obtener un ejemplo en el que se usa setbase.

setfill

Establece el carácter que se usará para rellenar los espacios en una presentación justificada a la derecha.

template <class Elem>
T4 setfill(Elem Ch);

Parámetros

Ch
Carácter que se usará para rellenar los espacios en una presentación justificada a la derecha.

Valor devuelto

El manipulador de plantilla devuelve un objeto que, cuando se extrae del flujo str o se inserta en este, llama a str.fill(Ch) y luego devuelve str. El tipo Elem debe ser el mismo que el tipo de elemento del flujo str.

Ejemplo

Vea setw para obtener un ejemplo en el que se usa setfill.

setiosflags

Establece las marcas especificadas.

T2 setiosflags(ios_base::fmtflags mask);

Parámetros

mask
Marcas que se van a establecer.

Valor devuelto

El manipulador devuelve un objeto que, cuando se extrae del flujo str o se inserta en este, llama a str.setf(mask) y luego devuelve str. Vea setf.

Ejemplo

Vea setw para obtener un ejemplo en el que se usa setiosflags.

setprecision

Establece la precisión de los valores de punto flotante.

T5 setprecision(streamsize Prec);

Parámetros

Prec
Precisión de los valores de punto flotante.

Valor devuelto

El manipulador devuelve un objeto que, cuando se extrae del flujo str o se inserta en este, llama a str.precision(Prec) y luego devuelve str. Vea precision.

Ejemplo

Vea setw para obtener un ejemplo en el que se usa setprecision.

setw

Especifica el ancho del campo de presentación para el siguiente elemento del flujo.

T6 setw(streamsize Wide);

Parámetros

Wide
Ancho del campo de presentación.

Valor devuelto

El manipulador devuelve un objeto que, cuando se extrae del flujo str o se inserta en este, llama a str.width(Wide) y luego devuelve str. Para obtener más información, vea width.

Comentarios

setw establece el ancho únicamente del siguiente elemento del flujo, y se debe insertar delante de cada elemento cuyo ancho se quiera especificar.

Ejemplo

// iomanip_setw.cpp
// compile with: /EHsc
// Defines the entry point for the console application.
//
// Sample use of the following manipulators:
//   resetiosflags
//   setiosflags
//   setbase
//   setfill
//   setprecision
//   setw

#include <iostream>
#include <iomanip>

using namespace std;

const double   d1 = 1.23456789;
const double   d2 = 12.3456789;
const double   d3 = 123.456789;
const double   d4 = 1234.56789;
const double   d5 = 12345.6789;
const long      l1 = 16;
const long      l2 = 256;
const long      l3 = 1024;
const long      l4 = 4096;
const long      l5 = 65536;
int         base = 10;

void DisplayDefault( )
{
   cout << endl << "default display" << endl;
   cout << "d1 = " << d1 << endl;
   cout << "d2 = " << d2 << endl;
   cout << "d3 = " << d3 << endl;
   cout << "d4 = " << d4 << endl;
   cout << "d5 = " << d5 << endl;
}

void DisplayWidth( int n )
{
   cout << endl << "fixed width display set to " << n << ".\n";
   cout << "d1 = " << setw(n) << d1 << endl;
   cout << "d2 = " << setw(n) << d2 << endl;
   cout << "d3 = " << setw(n) << d3 << endl;
   cout << "d4 = " << setw(n) << d4 << endl;
   cout << "d5 = " << setw(n) << d5 << endl;
}

void DisplayLongs( )
{
   cout << setbase(10);
   cout << endl << "setbase(" << base << ")" << endl;
   cout << setbase(base);
   cout << "l1 = " << l1 << endl;
   cout << "l2 = " << l2 << endl;
   cout << "l3 = " << l3 << endl;
   cout << "l4 = " << l4 << endl;
   cout << "l5 = " << l5 << endl;
}

int main( int argc, char* argv[] )
{
   DisplayDefault( );

   cout << endl << "setprecision(" << 3 << ")" << setprecision(3);
   DisplayDefault( );

   cout << endl << "setprecision(" << 12 << ")" << setprecision(12);
   DisplayDefault( );

   cout << setiosflags(ios_base::scientific);
   cout << endl << "setiosflags(" << ios_base::scientific << ")";
   DisplayDefault( );

   cout << resetiosflags(ios_base::scientific);
   cout << endl << "resetiosflags(" << ios_base::scientific << ")";
   DisplayDefault( );

   cout << endl << "setfill('" << 'S' << "')" << setfill('S');
   DisplayWidth(15);
   DisplayDefault( );

   cout << endl << "setfill('" << ' ' << "')" << setfill(' ');
   DisplayWidth(15);
   DisplayDefault( );

   cout << endl << "setprecision(" << 8 << ")" << setprecision(8);
   DisplayWidth(10);
   DisplayDefault( );

   base = 16;
   DisplayLongs( );

   base = 8;
   DisplayLongs( );

   base = 10;
   DisplayLongs( );

   return   0;
}

default display
d1 = 1.23457
d2 = 12.3457
d3 = 123.457
d4 = 1234.57
d5 = 12345.7

setprecision(3)
default display
d1 = 1.23
d2 = 12.3
d3 = 123
d4 = 1.23e+003
d5 = 1.23e+004

setprecision(12)
default display
d1 = 1.23456789
d2 = 12.3456789
d3 = 123.456789
d4 = 1234.56789
d5 = 12345.6789

setiosflags(4096)
default display
d1 = 1.234567890000e+000
d2 = 1.234567890000e+001
d3 = 1.234567890000e+002
d4 = 1.234567890000e+003
d5 = 1.234567890000e+004

resetiosflags(4096)
default display
d1 = 1.23456789
d2 = 12.3456789
d3 = 123.456789
d4 = 1234.56789
d5 = 12345.6789

setfill('S')
fixed width display set to 15.
d1 = SSSSS1.23456789
d2 = SSSSS12.3456789
d3 = SSSSS123.456789
d4 = SSSSS1234.56789
d5 = SSSSS12345.6789

default display
d1 = 1.23456789
d2 = 12.3456789
d3 = 123.456789
d4 = 1234.56789
d5 = 12345.6789

setfill(' ')
fixed width display set to 15.
d1 =      1.23456789
d2 =      12.3456789
d3 =      123.456789
d4 =      1234.56789
d5 =      12345.6789

default display
d1 = 1.23456789
d2 = 12.3456789
d3 = 123.456789
d4 = 1234.56789
d5 = 12345.6789

setprecision(8)
fixed width display set to 10.
d1 =  1.2345679
d2 =  12.345679
d3 =  123.45679
d4 =  1234.5679
d5 =  12345.679

default display
d1 = 1.2345679
d2 = 12.345679
d3 = 123.45679
d4 = 1234.5679
d5 = 12345.679

setbase(16)
l1 = 10
l2 = 100
l3 = 400
l4 = 1000
l5 = 10000

setbase(8)
l1 = 20
l2 = 400
l3 = 2000
l4 = 10000
l5 = 200000

setbase(10)
l1 = 16
l2 = 256
l3 = 1024
l4 = 4096
l5 = 65536

Consulte también

<iomanip>