Partilhar via


Funções <ios>

boolalpha

Especifica que variáveis do tipo bool apareçam 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 um tipo que herda de ios_base.

Valor de retorno

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

Comentários

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

boolalpha efetivamente chama str.setf( ios_base::boolalpha) e depois retorna str.

noboolalpha inverte 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

dec

Especifica que variáveis inteiras aparecem em 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 um tipo que herda de ios_base.

Valor de retorno

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

Comentários

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

dec efetivamente chama str.setf( ios_base::dec, ios_base::basefield) e depois 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 objeto ios_base para usar um formato de exibição padrão para valores do tipo float.

ios_base& defaultfloat(ios_base& iosbase);

Parâmetros

_Iosbase
Um objeto ios_base.

Comentários

O manipulador efetivamente chama iosbase.ios_base::unsetf(ios_base::floatfield) e depois retorna iosbase.

fixed

Especifica que um número de ponto flutuante é exibido em notação de decimal fixo.

ios_base& fixed(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

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

O manipulador efetivamente chama str.setf( ios_base::fixed, ios_base::floatfield ) e depois 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

hex

Especifica que variáveis inteiras devem aparecer em 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 um tipo que herda de ios_base.

Valor de retorno

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

Comentários

Por padrão, variáveis inteiras são exibidas em notação de 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 depois retorna str.

Exemplo

Consulte dec para ver um exemplo de como usar hex.

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 seja justificado à direita.

ios_base& internal(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

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

O manipulador chama str.efetivamente 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;

left

Faz com que um texto que não é tão largo quanto a largura de saída apareça no fluxo alinhado à margem esquerda.

ios_base& left(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

O manipulador efetivamente chama str.setf(ios_base::left, ios_base::adjustfield) e depois 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 variáveis do tipo bool apareçam 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 um tipo que herda de ios_base.

Valor de retorno

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

Comentários

Por padrão, noboolalpha está em vigor.

noboolalpha efetivamente chama str.unsetf(ios_base::boolalpha) e depois retorna str.

boolalpha inverte o efeito de noboolalpha.

Exemplo

Consulte boolalpha para ver um exemplo de como usar noboolalpha.

noshowbase

Desativa a indicação da base da notação em que um número é exibido.

ios_base& noshowbase(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

noshowbase está ativado por padrão. Use showbase para indicar a base da notação dos números.

O manipulador efetivamente chama str.unsetf(ios_base::showbase) e depois retorna str.

Exemplo

Consulte showbase para ver um exemplo de como usar noshowbase.

noshowpoint

Exibe somente a parte de número inteiro de números de ponto 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 um tipo que herda de ios_base.

Valor de retorno

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

Comentários

noshowpoint é ativado por padrão; use showpoint e precision para exibir os zeros após o ponto decimal.

O manipulador efetivamente chama str.unsetf(ios_base::showpoint) e depois 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 recebam sinalização explícita.

ios_base& noshowpos(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

noshowpos está ativado por padrão.

O manipulador efetivamente chama str.unsetf(ios_base::showpos) e depois retorna str.

Exemplo

Consulte showpos para ver um exemplo de como usar noshowpos.

noskipws

Faz com que 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 um tipo que herda de ios_base.

Valor de retorno

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

Comentários

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

O manipulador efetivamente chama str.unsetf(ios_base::skipws) e depois 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 um tipo que herda de ios_base.

Valor de retorno

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

Comentários

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

O manipulador efetivamente chama str.unsetf(ios_base::unitbuf) e depois retorna str.

nouppercase

Especifica que dígitos hexadecimais e o expoente em notação científica apareçam em letras minúsculas.

ios_base& nouppercase(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

O manipulador efetivamente chama str.unsetf(ios_base::uppercase) e depois retorna str.

Exemplo

Consulte uppercase para ver um exemplo de como usar nouppercase.

oct

Especifica que variáveis inteiras aparecem em notação de base 8.

ios_base& oct(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

Por padrão, variáveis inteiras são exibidas em notação de 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 depois retorna str.

Exemplo

Consulte dec para ver um exemplo de como usar oct.

Faz com que um texto que não é tão largo quanto a largura de saída apareça no fluxo alinhado à margem direita.

ios_base& right(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

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

O manipulador efetivamente chama str.setf(ios_base::right, ios_base::adjustfield) e depois 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

scientific

Faz com que números de ponto 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 um tipo que herda de ios_base.

Valor de retorno

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

Comentários

Por padrão, a notação fixed está em vigor para números de ponto flutuante.

O manipulador efetivamente chama str.setf(ios_base::scientific, ios_base::floatfield) e depois 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 da notação em que um número é exibido.

ios_base& showbase(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

A base da notação de um número pode ser alterada com dec, oct ou hex.

O manipulador efetivamente chama str.setf(ios_base::showbase) e depois 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

showpoint

Exibe a parte de número inteiro de um número de ponto flutuante e os dígitos à direita do ponto decimal, mesmo quando a parte fracionária for zero.

ios_base& showpoint(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

Por padrão, noshowpoint está em vigor.

O manipulador efetivamente chama str.setf(ios_base::showpoint) e depois retorna str.

Exemplo

Consulte noshowpoint para ver um exemplo de como usar showpoint.

showpos

Faz com que números positivos recebam sinalização explícita.

ios_base& showpos(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

noshowpos é o padrão.

O manipulador efetivamente chama str.setf(ios_base::showpos) e depois 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

Faz com que 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 um tipo que herda de ios_base.

Valor de retorno

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

Comentários

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

O manipulador efetivamente chama str.setf(ios_base::skipws) e depois 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 estiver vazio.

ios_base& unitbuf(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

Observe que endl também libera o buffer.

nounitbuf está em vigor por padrão.

O manipulador efetivamente chama str.setf(ios_base::unitbuf) e depois retorna str.

uppercase

Especifica que dígitos hexadecimais e o expoente em notação científica apareçam em letras maiúsculas.

ios_base& uppercase(ios_base& str);

Parâmetros

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

Valor de retorno

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

Comentários

Por padrão, nouppercase está em vigor.

O manipulador efetivamente chama str.setf(ios_base::uppercase) e depois 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