Функции <ios><ios> functions

boolalphaboolalpha

Указывает, что переменные типа bool отображаются как true или false в потоке.Specifies that variables of type bool appear as true or false in the stream.

ios_base& boolalpha(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию переменные типа bool отображаются как 1 или 0.By default, variables of type bool are displayed as 1 or 0.

boolalphaфактически вызывает str. setf( ios_base::boolalpha ), а затем возвращает str.boolalpha effectively calls str.setf( ios_base::boolalpha), and then returns str.

noboolalpha отменяет результат boolalpha.noboolalpha reverses the effect of boolalpha.

ПримерExample

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

Устанавливает режим отображения целочисленных переменных в нотации с основанием 10.Specifies that integer variables appear in base 10 notation.

ios_base& dec(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию целочисленные переменные отображаются в десятичной записи.By default, integer variables are displayed in base 10.

decфактически вызывает str. setf( ios_base::dec , ios_base::basefield ), а затем возвращает str.dec effectively calls str.setf( ios_base::dec, ios_base::basefield), and then returns str.

ПримерExample

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

<ios> defaultfloat<ios> defaultfloat

Устанавливает флаги объекта ios_base в соответствии с форматом отображения значений с плавающей запятой, принятым по умолчанию.Configures the flags of an ios_base object to use a default display format for float values.

ios_base& defaultfloat(ios_base& iosbase);

ПараметрыParameters

_Iosbase_Iosbase
Объект ios_base.An ios_base object.

КомментарииRemarks

Манипулятор фактически вызывает iosbase. ios_base:: unsetf (ios_base::floatfield) , а затем возвращает iosbase.The manipulator effectively calls iosbase.ios_base::unsetf(ios_base::floatfield), then returns iosbase.

префиксfixed

Устанавливает режим отображения чисел с плавающей запятой в нотации фиксированного десятичного формата.Specifies that a floating-point number is displayed in fixed-decimal notation.

ios_base& fixed(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

fixed — это отображаемая по умолчанию нотация для чисел с плавающей запятой.fixed is the default display notation for floating-point numbers. scientific вызывает отображение чисел с плавающей запятой в экспоненциальном представлении.scientific causes floating-point numbers to be displayed using scientific notation.

Манипулятор фактически вызывает str. setf( ios_base::fixed , ios_base::floatfield ), а затем возвращает str.The manipulator effectively calls str.setf( ios_base::fixed, ios_base::floatfield ), and then returns str.

ПримерExample

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

Hexhex

Устанавливает режим отображения целочисленных переменных в шестнадцатеричной записи.Specifies that integer variables shall appear in base 16 notation.

ios_base& hex(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию целочисленные переменные отображаются в десятичной записи.By default, integer variables are displayed in base 10 notation. dec и oct также изменяют способ показа целочисленных переменных.dec and oct also change the way integer variables appear.

Манипулятор эффективно вызывает str . setf( ios_base::hex , ios_base::basefield ), а затем возвращает str.The manipulator effectively calls str.setf( ios_base::hex, ios_base::basefield), and then returns str.

ПримерExample

Пример использования см. в Dec hex .See dec for an example of how to use hex.

свертыванияhexfloat

ios_base& hexfloat (ios_base& str);

io_errcio_errc

enum class io_errc {
    stream = 1
};

внутрикластерныхinternal

Устанавливает режим выравнивания знака числа по левому краю, а самого числа — по правому краю.Causes a number's sign to be left justified and the number to be right justified.

ios_base& internal(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

showpos вызывает показ знака для отображения положительных чисел.showpos causes the sign to display for positive numbers.

Манипулятор фактически вызывает str. setf ( ios_base:: Internal , ios_base:: adjustfield ) , а затем возвращает str.The manipulator effectively calls str.setf(ios_base::internal, ios_base::adjustfield), and then returns str.

ПримерExample

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

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

iostream_categoryiostream_category

const error_category& iostream_category() noexcept;

слеваleft

Устанавливает режим добавления левого поля для текста, ширина которого меньше, чем ширина выходных данных, при представлении его в потоке.Causes text that is not as wide as the output width to appear in the stream flush with the left margin.

ios_base& left(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

Манипулятор фактически вызывает str. setf (ios_base::left, ios_base::adjustfield) , а затем возвращает str.The manipulator effectively calls str.setf(ios_base::left, ios_base::adjustfield), and then returns str.

ПримерExample

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

error_code make_error_code(io_errc e) noexcept;

make_error_conditionmake_error_condition

error_condition make_error_condition(io_errc e) noexcept;

нобулалфаnoboolalpha

Устанавливает режим отображения переменных типа bool в потоке в виде 1 или 0.Specifies that variables of type bool appear as 1 or 0 in the stream.

ios_base& noboolalpha(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию действует noboolalpha.By default, noboolalpha is in effect.

noboolalphaфактически вызывает str. unsetf (ios_base::boolalpha) , а затем возвращает str.noboolalpha effectively calls str.unsetf(ios_base::boolalpha), and then returns str.

noboolalpha отменяет результат noboolalpha.boolalpha reverses the effect of noboolalpha.

ПримерExample

См. boolalpha с примером использования noboolalpha.See boolalpha for an example of using noboolalpha.

ношовбасеnoshowbase

Отключает отображение основания нотации, в которой отображается число.Turns off indicating the notational base in which a number is displayed.

ios_base& noshowbase(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

noshowbase включен по умолчанию.noshowbase is on by default. Используйте showbase для указания основания чисел.Use showbase to indicate the notational base of numbers.

Манипулятор фактически вызывает str. unsetf (ios_base::showbase) , а затем возвращает str.The manipulator effectively calls str.unsetf(ios_base::showbase), and then returns str.

ПримерExample

См. showbase с примером использования noshowbase.See showbase for an example of how to use noshowbase.

ношовпоинтnoshowpoint

Отображает только целую часть числа с плавающей запятой, дробная часть которого равна нулю.Displays only the whole-number part of floating-point numbers whose fractional part is zero.

ios_base& noshowpoint(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию noshowpoint включен. Используйте showpoint и precision для показа нулей после десятичной запятой.noshowpoint is on by default; use showpoint and precision to display zeros after the decimal point.

Манипулятор фактически вызывает str. unsetf (ios_base::showpoint) , а затем возвращает str.The manipulator effectively calls str.unsetf(ios_base::showpoint), and then returns str.

ПримерExample

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

Устанавливает режим отображения положительных чисел без обязательного знака.Causes positive numbers to not be explicitly signed.

ios_base& noshowpos(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

noshowpos включен по умолчанию.noshowpos is on by default.

Манипулятор фактически вызывает str. unsetf (ios_base::showps) , а затем возвращает str.The manipulator effectively calls str.unsetf(ios_base::showps), then returns str.

ПримерExample

См. showpos с примером использования noshowpos.See showpos for an example of using noshowpos.

noskipwsnoskipws

Устанавливает режим чтения пробелов потоком ввода.Cause spaces to be read by the input stream.

ios_base& noskipws(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию используется skipws.By default, skipws is in effect. При чтении пробела из входного потока он сообщает о конце буфера.When a space is read in the input stream, it signals the end of the buffer.

Манипулятор фактически вызывает str. unsetf (ios_base::skipws) , а затем возвращает str.The manipulator effectively calls str.unsetf(ios_base::skipws), and then returns str.

ПримерExample

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

Устанавливает буферизацию выходных данных и их обработку при заполнении буфера.Causes output to be buffered and processed on when the buffer is full.

ios_base& nounitbuf(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

unitbuf вызывает обработку буфера, когда он не пустой.unitbuf causes the buffer to be processed when it is not empty.

Манипулятор фактически вызывает str. unsetf (ios_base::unitbuf) , а затем возвращает str.The manipulator effectively calls str.unsetf(ios_base::unitbuf), and then returns str.

прописные буквыnouppercase

Устанавливает режим отображения шестнадцатеричных цифр и показателя степени в экспоненциальном представлении в нижнем регистре.Specifies that hexadecimal digits and the exponent in scientific notation appear in lowercase.

ios_base& nouppercase(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

Манипулятор фактически вызывает str. unsetf (ios_base::uppercase) , а затем возвращает str.The manipulator effectively calls str.unsetf(ios_base::uppercase), and then returns str.

ПримерExample

См. uppercase с примером использования nouppercase.See uppercase for an example of using nouppercase.

октябряoct

Устанавливает режим отображения целочисленных переменных в нотации с основанием 8.Specifies that integer variables appear in base 8 notation.

ios_base& oct(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию целочисленные переменные отображаются в десятичной записи.By default, integer variables are displayed in base 10 notation. dec и hex также изменяют способ показа целочисленных переменных.dec and hex also change the way integer variables appear.

Манипулятор фактически вызывает str. setf (ios_base::oct, ios_base::basefield) , а затем возвращает str.The manipulator effectively calls str.setf(ios_base::oct, ios_base::basefield), and then returns str.

ПримерExample

Пример использования см. в Dec oct .See dec for an example of how to use oct.

Устанавливает режим добавления правого поля для текста, ширина которого меньше, чем ширина выходных данных, при представлении его в потоке.Causes text that is not as wide as the output width to appear in the stream flush with the right margin.

ios_base& right(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

left также изменяет выравнивание текста.left also modifies the justification of text.

Манипулятор фактически вызывает str. setf (ios_base::right, ios_base::adjustfield) , а затем возвращает str.The manipulator effectively calls str.setf(ios_base::right, ios_base::adjustfield), and then returns str.

ПримерExample

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

Устанавливает режим отображения чисел с плавающей запятой с использованием экспоненциального представления.Causes floating-point numbers to be displayed using scientific notation.

ios_base& scientific(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию числа с плавающей запятой показываются в нотации fixed.By default, fixed notation is in effect for floating-point numbers.

Манипулятор фактически вызывает str. setf (ios_base::scientific, ios_base::floatfield) , а затем возвращает str.The manipulator effectively calls str.setf(ios_base::scientific, ios_base::floatfield), and then returns str.

ПримерExample

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

showbaseshowbase

Включает отображение основания нотации, в которой отображается число.Indicates the notational base in which a number is displayed.

ios_base& showbase(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

Запись числа можно изменить при помощи dec, oct или hex.The notational base of a number can be changed with dec, oct, or hex.

Манипулятор фактически вызывает str. setf (ios_base::showbase) , а затем возвращает str.The manipulator effectively calls str.setf(ios_base::showbase), and then returns str.

ПримерExample

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

showpointshowpoint

Отображает целую часть числа с плавающей запятой и цифры справа от десятичной запятой даже в том случае, если дробная часть равна нулю.Displays the whole-number part of a floating-point number and digits to the right of the decimal point even when the fractional part is zero.

ios_base& showpoint(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию действует noshowpoint.By default, noshowpoint is in effect.

Манипулятор фактически вызывает str. setf (ios_base::showpoint) , а затем возвращает str.The manipulator effectively calls str.setf(ios_base::showpoint), and then returns str.

ПримерExample

См. noshowpoint с примером использования showpoint.See noshowpoint for an example of using showpoint.

showposshowpos

Устанавливает режим отображения положительных чисел с обязательным знаком.Causes positive numbers to be explicitly signed.

ios_base& showpos(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию используется noshowpos.noshowpos is the default.

Манипулятор фактически вызывает str. setf (ios_base::showpos) , а затем возвращает str.The manipulator effectively calls str.setf(ios_base::showpos), and then returns str.

ПримерExample

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

skipwsskipws

Устанавливает режим игнорирования пробелов потоком ввода.Cause spaces to not be read by the input stream.

ios_base& skipws(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию действует skipws.By default, skipws is in effect. noskipws устанавливает режим чтения пробелов из входного потока.noskipws will cause spaces to be read from the input stream.

Манипулятор фактически вызывает str. setf (ios_base::skipws) , а затем возвращает str.The manipulator effectively calls str.setf(ios_base::skipws), and then returns str.

ПримерExample

#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.

unitbufunitbuf

Устанавливает режим обработки выходных данных при наличии данных в буфере.Causes output to be processed when the buffer is not empty.

ios_base& unitbuf(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

Обратите внимание, что endl также очищает буфер.Note that endl also flushes the buffer.

По умолчанию действует nounitbuf.nounitbuf is in effect by default.

Манипулятор фактически вызывает str. setf ( ios_base:: unitbuf ) , а затем возвращает str.The manipulator effectively calls str.setf(ios_base::unitbuf), and then returns str.

верхний регистрuppercase

Устанавливает режим отображения шестнадцатеричных цифр и показателя степени в экспоненциальном представлении в верхнем регистре.Specifies that hexadecimal digits and the exponent in scientific notation appear in uppercase.

ios_base& uppercase(ios_base& str);

ПараметрыParameters

strstr
Ссылка на объект типа ios_base, или на тип, который наследует от ios_base.A reference to an object of type ios_base, or to a type that inherits from ios_base.

Возвращаемое значениеReturn Value

Ссылка на объект, из которого является производным str .A reference to the object from which str is derived.

КомментарииRemarks

По умолчанию действует nouppercase.By default, nouppercase is in effect.

Манипулятор фактически вызывает str. setf ( ios_base:: прописные ) и возвращает str.The manipulator effectively calls str.setf(ios_base::uppercase), and then returns str.

ПримерExample

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