Funções <iomanip>

  • Artigo

get_money
get_time
put_money
put_time
quoted
resetiosflags
setbase
setfill
setiosflags
setprecision
setw

get_money

Extrai um valor monetário de um fluxo usando o formato especificado e retorna o valor em um parâmetro.

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

Parâmetros

amount
O valor monetário extraído.

use_intl
Se true, use o formato internacional. O valor padrão é false.

Comentários

O manipulador retorna um objeto que, quando extraído do fluxo str, se comporta como um formatted input function que chama a função membro get para a faceta de localidade money_get associada a str, usando use_intl para indicar o formato internacional. Se for bem-sucedida, a chamada armazena em amount o valor monetário extraído. O manipulador, então, retorna str.

Money deve ser do tipo long double ou uma instanciação de basic_string com os mesmos parâmetros de elemento e características que str.

get_time

Extrai um valor temporal de um fluxo usando um formato especificado. Retorna o valor em um parâmetro como uma estrutura de tempo.

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

Parâmetros

time_ptr
O tempo na forma de uma estrutura de tempo.

time_format
O formato a ser usado para obter o valor temporal.

Comentários

O manipulador retorna um objeto que, quando extraído do fluxo str, se comporta como um formatted input function que chama a função membro get para a faceta de localidade time_get associada a str, usando tptr para indicar a estrutura de tempo e fmt para indicar o início de uma cadeia de caracteres de formato terminada em nulo. Se for bem-sucedida, a chamada armazena na estrutura de tempo os valores associados aos campos de tempo extraídos. O manipulador, então, retorna str.

Exemplo

#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

Insere um valor monetário usando o formato especificado em um fluxo.

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

Parâmetros

amount
O valor monetário a ser inserido no fluxo.

use_intl
Defina como true se o manipulador precisar usar o formato internacional. Caso contrário, defina como false.

Valor de Devolução

Retorna str.

Comentários

O manipulador retorna um objeto que, quando inserido no fluxo str, se comporta como uma função de saída formatada que chama a função membro put para a faceta de localidade money_put associada a str. Se bem-sucedida, a chamada insere amount formatado adequadamente, usando use_intl para indicar o formato internacional e str.fill() como o elemento de preenchimento. O manipulador, então, retorna str.

Money deve ser do tipo long double ou uma instanciação de basic_string com os mesmos parâmetros de elemento e características que str.

put_time

Grava um valor temporal de uma estrutura de tempo em um fluxo usando um formato especificado.

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

Parâmetros

time_ptr
O valor temporal a ser gravado no fluxo, fornecido em uma estrutura de tempo.

time_format
O formato para gravar o valor temporal.

Comentários

O manipulador retorna um objeto que, quando inserido no fluxo str, se comporta como formatted output function. A função de saída chama a função membro put para a faceta de localidade time_put associada a str. A função de saída usa time_ptr para indicar a estrutura de tempo e time_format para indicar o início de uma cadeia de caracteres de formato terminada em nulo. Se for bem-sucedida, a chamada insere texto literal da cadeia de caracteres de formato e valores convertidos da estrutura de hora. O manipulador, então, retorna str.

quoted

(Novo no C++14) Um manipulador iostream que permite o ciclo conveniente de cadeias de caracteres, entrando e saindo de fluxos, usando os operadores >> e <<.

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
Um std::string, char*, literal de cadeia de caracteres ou literal de cadeia de caracteres bruta, ou uma versão larga de um deles (por exemplo, std::wstring, wchar_t*).

delimiter
Um caractere especificado pelo usuário, ou caractere largo, a ser usado como delimitador para o início e o fim da cadeia de caracteres.

escape
Um caractere especificado pelo usuário, ou caractere largo, a ser usado como caractere de escape para sequências de escape na cadeia de caracteres.

Comentários

Consulte Usando operadores de inserção e controlando o formato.

Exemplos

Este exemplo mostra como usar quoted com o delimitador padrão e o caractere de escape usando cadeias de caracteres estreitas. Cadeias de caracteres largas também têm suporte.

#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
*/

O seguinte exemplo mostra como fornecer um caractere delimitador ou 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

Limpa os sinalizadores especificados.

T1 resetiosflags(ios_base::fmtflags mask);

Parâmetros

mask
Os sinalizadores a limpar.

Valor de Devolução

O manipulador retorna um objeto que, quando extraído ou inserido no fluxo str, chama str.setf(ios_base::fmtflags, mask) e, em seguida, retorna str. Confira setf e fmtflags.

Exemplo

Confira setw para ver um exemplo de como usar resetiosflags.

setbase

Define a base para inteiros.

T3 setbase(int base);

Parâmetros

base
A base numérica.

Valor de Devolução

O manipulador retorna um objeto que, quando extraído ou inserido no fluxo str, chama str.setf(mask, ios_base::basefield) e, em seguida, retorna str. Confira ios_base::basefield. Aqui, mask é determinado da seguinte forma:

Exemplo

Confira setw para ver um exemplo de como usar setbase.

setfill

Define o caractere que será usado para preencher espaços em uma exibição justificada à direita.

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

Parâmetros

Ch
O caractere que será usado para preencher espaços em uma exibição justificada à direita.

Valor de Devolução

O manipulador de modelo retorna um objeto que, quando extraído ou inserido no fluxo str, chama str.fill(Ch) e, em seguida, retorna str. O tipo Elem deve ser o mesmo que o tipo de elemento do fluxo str.

Exemplo

Confira setw para ver um exemplo de como usar setfill.

setiosflags

Define os sinalizadores especificados.

T2 setiosflags(ios_base::fmtflags mask);

Parâmetros

mask
Os sinalizadores a serem definidos.

Valor de Devolução

O manipulador retorna um objeto que, quando extraído ou inserido no fluxo str, chama str.setf(mask) e, em seguida, retorna str. Confira setf.

Exemplo

Confira setw para ver um exemplo de como usar setiosflags.

setprecision

Define a precisão dos valores de ponto flutuante.

T5 setprecision(streamsize Prec);

Parâmetros

Prec
A precisão dos valores de ponto flutuante.

Valor de Devolução

O manipulador retorna um objeto que, quando extraído ou inserido no fluxo str, chama str.precision(Prec) e, em seguida, retorna str. Confira precision.

Exemplo

Confira setw para ver um exemplo de como usar setprecision.

setw

Especifica a largura do campo de exibição para o elemento seguinte no fluxo.

T6 setw(streamsize Wide);

Parâmetros

Wide
A largura do campo de exibição.

Valor de Devolução

O manipulador retorna um objeto que, quando extraído ou inserido no fluxo str, chama str.width(Wide) e, em seguida, retorna str. Para obter mais informações, consulte width.

Comentários

setw define a largura somente para o elemento seguinte no fluxo e deve ser inserido antes de cada elemento cuja largura você deseja especificar.

Exemplo

// 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

Confira também

<iomanip>