Partilhar via


<ios> funções

Boolalpha

Especifica que as variáveis do tipo bool aparecem como true ou false no fluxo.

ios_base& boolalpha(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Por padrão, as variáveis do tipo bool são exibidas como 1 ou 0.

boolalpha efetivamente chama str.setf(ios_base::boolalpha) e, em seguida, retorna str.

Noboolalpha reverte o efeito de boolalpha.

Exemplo

// ios_boolalpha.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   bool b = true;
   cout << b << endl;
   boolalpha( cout );
   cout << b << endl;
   noboolalpha( cout );
   cout << b << endl;
   cout << boolalpha << b << endl;
}
1
true
1
true

Dez

Especifica que as variáveis inteiras aparecem na notação de base 10.

ios_base& dec(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Por padrão, as variáveis inteiras são exibidas na base 10.

dec efetivamente chama str.setf(ios_base::dec, ios_base::basefield), e retorna str.

Exemplo

// ios_dec.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   int i = 100;

   cout << i << endl;   // Default is base 10
   cout << hex << i << endl;
   dec( cout );
   cout << i << endl;
   oct( cout );
   cout << i << endl;
   cout << dec << i << endl;
}
100
64
100
144
100

defaultfloat

Configura os sinalizadores de um ios_base objeto para usar um formato de exibição padrão para valores flutuantes.

ios_base& defaultfloat(ios_base& iosbase);

Parâmetros

_Iosbase
Um ios_base objeto.

Observações

O manipulador efetivamente chama iosbase.ios_base::unsetf(ios_base::floatfield) e, em seguida, retorna iosbase.

fixo

Especifica que um número de vírgula flutuante é exibido em notação decimal fixa.

ios_base& fixed(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

fixed é a notação de exibição padrão para números de vírgula flutuante. científica faz com que números de vírgula flutuante sejam exibidos usando notação científica.

O manipulador efetivamente chama str. setf(ios_base::fixed, ios_base::floatfield), e retorna str.

Exemplo

// ios_fixed.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   float i = 1.1F;

   cout << i << endl;   // fixed is the default
   cout << scientific << i << endl;
   cout.precision( 1 );
   cout << fixed << i << endl;
}
1.1
1.100000e+000
1.1

hexadecimal

Especifica que as variáveis inteiras devem aparecer na notação de base 16.

ios_base& hex(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Por padrão, as variáveis inteiras são exibidas na notação base 10. Dec e Oct também alteram a forma como as variáveis inteiras aparecem.

O manipulador efetivamente chama str.setf(ios_base::hex, ios_base::basefield), e retorna str.

Exemplo

Consulte dec para obter um exemplo de como usar hexo .

Hexfloat

ios_base& hexfloat (ios_base& str);

io_errc

enum class io_errc {
    stream = 1
};

interno

Faz com que o sinal de um número seja justificado à esquerda e o número justificado à direita.

ios_base& internal(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

showpos faz com que o sinal seja exibido para números positivos.

O manipulador efetivamente chama str.setf(ios_base::internal,ios_base::adjustfield) e, em seguida, retorna str.

Exemplo

// ios_internal.cpp
// compile with: /EHsc
#include <iostream>
#include <iomanip>

int main( void )
{
   using namespace std;
   float i = -123.456F;
   cout.fill( '.' );
   cout << setw( 10 ) << i << endl;
   cout << setw( 10 ) << internal << i << endl;
}
..-123.456
-..123.456

is_error_code_enum

template <> struct is_error_code_enum<io_errc> : public true_type { };

iostream_category

const error_category& iostream_category() noexcept;

esquerda

Faz com que o texto que não é tão grande quanto a largura de saída apareça no fluxo nivelado com a margem esquerda.

ios_base& left(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

O manipulador efetivamente chama str.setf(ios_base::left, ios_base::adjustfield) e, em seguida, retorna str.

Exemplo

// ios_left.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   double f1= 5.00;
   cout.width( 20 );
   cout << f1 << endl;
   cout << left << f1 << endl;
}
5
        5

make_error_code

error_code make_error_code(io_errc e) noexcept;

make_error_condition

error_condition make_error_condition(io_errc e) noexcept;

Noboolalpha

Especifica que as variáveis do tipo bool aparecem como 1 ou 0 no fluxo.

ios_base& noboolalpha(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Por padrão, noboolalpha está em vigor.

noboolalpha efetivamente chama str.unsetf(ios_base::boolalpha) e, em seguida, retorna str.

Boolalpha reverte o efeito de noboolalpha.

Exemplo

Veja boolalpha para um exemplo de uso noboolalphade .

noshowbase

Desativa a indicação da base notacional na qual um número é exibido.

ios_base& noshowbase(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

noshowbase está ativado por padrão. Use showbase para indicar a base notacional de números.

O manipulador efetivamente chama str.unsetf(ios_base::showbase) e, em seguida, retorna str.

Exemplo

Consulte showbase para obter um exemplo de como usar noshowbaseo .

noshowpoint

Exibe apenas a parte de número inteiro de números de vírgula flutuante cuja parte fracionária é zero.

ios_base& noshowpoint(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

noshowpoint está ativado por defeito; Use Showpoint e Precision para exibir zeros após a vírgula decimal.

O manipulador efetivamente chama str.unsetf(ios_base::showpoint) e, em seguida, retorna str.

Exemplo

// ios_noshowpoint.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   double f1= 5.000;
   cout << f1 << endl;   // noshowpoint is default
   cout.precision( 4 );
   cout << showpoint << f1 << endl;
   cout << noshowpoint << f1 << endl;
}
5
5.000
5

Noshowpos

Faz com que números positivos não sejam explicitamente assinados.

ios_base& noshowpos(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

noshowpos está ativado por padrão.

O manipulador efetivamente chama str.unsetf(ios_base::showpos) e, em seguida, retorna str.

Exemplo

Consulte showpos para obter um exemplo de utilização noshowposdo .

Noskipws

Fazer com que os espaços sejam lidos pelo fluxo de entrada.

ios_base& noskipws(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Por padrão, skipws está em vigor. Quando um espaço é lido no fluxo de entrada, ele sinaliza o fim do buffer.

O manipulador efetivamente chama str.unsetf(ios_base::skipws) e, em seguida, retorna str.

Exemplo

// ios_noskipws.cpp
// compile with: /EHsc
#include <iostream>
#include <string>

int main() {
   using namespace std;
   string s1, s2, s3;
   cout << "Enter three strings: ";
   cin >> noskipws >> s1 >> s2 >> s3;
   cout << "." << s1  << "." << endl;
   cout << "." << s2 << "." << endl;
   cout << "." << s3 << "." << endl;
}

Nounitbuf

Faz com que a saída seja armazenada em buffer e processada quando o buffer estiver cheio.

ios_base& nounitbuf(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

unitbuf faz com que o buffer seja processado quando não está vazio.

O manipulador efetivamente chama str.unsetf(ios_base::unitbuf) e, em seguida, retorna str.

Nãomaiúsculas

Especifica que os dígitos hexadecimais e o expoente na notação científica aparecem em minúsculas.

ios_base& nouppercase(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

O manipulador efetivamente chama str.unsetf(ios_base::uppercase) e, em seguida, retorna str.

Exemplo

Consulte maiúsculas para obter um exemplo de utilização nouppercasedo .

Out

Especifica que as variáveis inteiras aparecem na notação base 8.

ios_base& oct(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Por padrão, as variáveis inteiras são exibidas na notação base 10. dec e hex também alteram a forma como as variáveis inteiras aparecem.

O manipulador efetivamente chama str.setf(ios_base::oct, ios_base::basefield) e, em seguida, retorna str.

Exemplo

Consulte dec para obter um exemplo de como usar octo .

Faz com que o texto que não é tão grande quanto a largura de saída apareça no fluxo nivelado com a margem direita.

ios_base& right(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

esquerda também modifica a justificação do texto.

O manipulador efetivamente chama str.setf(ios_base::right, ios_base::adjustfield) e, em seguida, retorna str.

Exemplo

// ios_right.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   double f1= 5.00;
   cout << f1 << endl;
   cout.width( 20 );
   cout << f1 << endl;
   cout.width( 20 );
   cout << left << f1 << endl;
   cout.width( 20 );
   cout << f1 << endl;
   cout.width( 20 );
   cout << right << f1 << endl;
   cout.width( 20 );
   cout << f1 << endl;
}
5
                   5
5
5
                   5
                   5

Científico

Faz com que números de vírgula flutuante sejam exibidos usando notação científica.

ios_base& scientific(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Por padrão, a notação fixa está em vigor para números de vírgula flutuante.

O manipulador efetivamente chama str.setf(ios_base::scientific, ios_base::floatfield) e, em seguida, retorna str.

Exemplo

// ios_scientific.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   float i = 100.23F;

   cout << i << endl;
   cout << scientific << i << endl;
}
100.23
1.002300e+002

Showbase

Indica a base notacional na qual um número é exibido.

ios_base& showbase(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

A base notacional de um número pode ser alterada com dec, oct ou hex.

O manipulador efetivamente chama str.setf(ios_base::showbase) e, em seguida, retorna str.

Exemplo

// ios_showbase.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   int j = 100;

   cout << showbase << j << endl;   // dec is default
   cout << hex << j << showbase << endl;
   cout << oct << j << showbase << endl;

   cout << dec << j << noshowbase << endl;
   cout << hex << j << noshowbase << endl;
   cout << oct << j << noshowbase << endl;
}
100
0x64
0144
100
64
144

Ponto de Exposição

Exibe a parte de número inteiro de um número de vírgula flutuante e dígitos à direita da vírgula decimal, mesmo quando a parte fracionária é zero.

ios_base& showpoint(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Por padrão, noshowpoint está em vigor.

O manipulador efetivamente chama str.setf(ios_base::showpoint) e, em seguida, retorna str.

Exemplo

Consulte noshowpoint para obter um exemplo de utilização showpointdo .

showpos

Faz com que números positivos sejam explicitamente assinados.

ios_base& showpos(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

noshowpos é o padrão.

O manipulador efetivamente chama str.setf(ios_base::showpos) e, em seguida, retorna str.

Exemplo

// ios_showpos.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   int i = 1;

   cout << noshowpos << i << endl;   // noshowpos is default
   cout << showpos << i << endl;
}
1
+1

skipws

Faça com que os espaços não sejam lidos pelo fluxo de entrada.

ios_base& skipws(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Por padrão, skipws está em vigor. noskipws fará com que os espaços sejam lidos a partir do fluxo de entrada.

O manipulador efetivamente chama str.setf(ios_base::skipws) e, em seguida, retorna str.

Exemplo

#include <iostream>
#include <string>

int main( )
{
   using namespace std;
   char s1, s2, s3;
   cout << "Enter three characters: ";
   cin >> skipws >> s1 >> s2 >> s3;
   cout << "." << s1  << "." << endl;
   cout << "." << s2 << "." << endl;
   cout << "." << s3 << "." << endl;
}
1 2 3
Enter three characters: 1 2 3
.1.
.2.
.3.

UNITBUF

Faz com que a saída seja processada quando o buffer não está vazio.

ios_base& unitbuf(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Observe que endl também libera o buffer.

nounitbuf está em vigor por defeito.

O manipulador efetivamente chama str.setf(ios_base::unitbuf) e, em seguida, retorna str.

maiúsculas

Especifica que os dígitos hexadecimais e o expoente na notação científica aparecem em maiúsculas.

ios_base& uppercase(ios_base& str);

Parâmetros

STR
Uma referência a um objeto do tipo ios_base ou a um tipo que herda de ios_base.

Valor de retorno

Uma referência ao objeto do qual str é derivado.

Observações

Por padrão, nouppercase está em vigor.

O manipulador efetivamente chama str.setf(ios_base::maiúsculas) e, em seguida, retorna str.

Exemplo

// ios_uppercase.cpp
// compile with: /EHsc
#include <iostream>

int main( void )
{
   using namespace std;

   double i = 1.23e100;
   cout << i << endl;
   cout << uppercase << i << endl;

   int j = 10;
   cout << hex << nouppercase << j << endl;
   cout << hex << uppercase << j << endl;
}
1.23e+100
1.23E+100
a
A