<ios> -Funktionen

boolalpha

Gibt an, dass Variablen vom Typ "Bool " als true oder false im Datenstrom angezeigt werden.

ios_base& boolalpha(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

Standardmäßig werden Variablen vom Typ bool als 1 oder 0 angezeigt.

boolalpha ruft str.setf( ios_base::boolalpha) effektiv auf und gibt dann str.

noboolalpha kehrt den Effekt von boolalpha um.

Beispiel

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

Gibt an, dass ganzzahlige Variablen in Basis-10-Schreibweise angezeigt werden.

ios_base& dec(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

Standardmäßig werden Ganzzahlvariablen in Basis-10-Schreibweise angezeigt.

dec ruft str.setf( ios_base::dec, ios_base::basefield) effektiv auf und gibt dann str.

Beispiel

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

Konfiguriert die Flags eines ios_base-Objekts, sodass ein Standard-Anzeigeformat für Floatwerte verwendet wird.

ios_base& defaultfloat(ios_base& iosbase);

Parameter

_Iosbase
Ein ios_base-Objekt.

Hinweise

Der Manipulator ruft iosbase.effektiv ios_base::unsetf(ios_base::floatfield) auf und gibt dann iosbase zurück.

fixed

Gibt an, dass eine Gleitkommazahl in fester Dezimalschreibweise angezeigt wird.

ios_base& fixed(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

fixed ist die Standardanzeigenotation für Gleitkommazahlen. scientific bewirkt, dass Gleitkommazahlen in wissenschaftlicher Schreibweise angezeigt werden.

Der Manipulator ruft effektiv str.setf( ios_base::fixed, ios_base::floatfield ), und gibt dann str.

Beispiel

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

Gibt an, dass ganzzahlige Variablen in Basis-16-Schreibweise angezeigt werden soll.

ios_base& hex(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

Standardmäßig werden Ganzzahlvariablen in Basis-10-Schreibweise angezeigt. Ebenfalls verändern dec und oct die Anzeige von Ganzzahlvariablen.

Der Manipulator ruft effektiv auf str.setf( ios_base::hex, ios_base::basefield), und gibt dann str.

Beispiel

Ein Beispiel für die Verwendung finden Sie unter dec.hex

Hexfloat

ios_base& hexfloat (ios_base& str);

io_errc

enum class io_errc {
    stream = 1
};

internal

Bewirkt, dass ein Nummernzeichen linksbündig und die Zahl rechtsbündig ausgerichtet wird.

ios_base& internal(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

Durch showpos zeigt das Nummernzeichen für positive Zahlen an.

Der Manipulator ruft str.setf(effektiv ios_base::internal,ios_base::adjustfield) auf und gibt dann str zurück.

Beispiel

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

nach links

Bewirkt, dass Text, der nicht so breit ist wie die Ausgabebreite, im Stream linksbündig angezeigt wird.

ios_base& left(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

Der Manipulator ruft setf effektiv auf str.und gibt dann str zurück.(ios_base::left, ios_base::adjustfield)

Beispiel

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

Gibt an, dass Variablen des Typs bool im Stream als 1 oder 0 angezeigt werden.

ios_base& noboolalpha(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

In der Standardeinstellung ist noboolalpha aktiviert.

noboolalpha ruft str.effektiv unetf(ios_base::boolalpha) auf und gibt dann str zurück.

boolalpha kehrt den Effekt von noboolalpha um.

Beispiel

Unter boolalpha finden Sie ein Beispiel für die Verwendung von noboolalpha.

noshowbase

Deaktiviert die Angabe der Schreibweisenbasis, mit der eine Zahl angezeigt wird.

ios_base& noshowbase(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

noshowbase ist standardmäßig aktiviert. Verwenden Sie showbase, um die Schreibweisenbasis von Zahlen zu kennzeichnen.

Der Manipulator ruft str.effektiv unetf(ios_base::showbase) auf und gibt dann str zurück.

Beispiel

Unter showbase finden Sie ein Beispiel zur Verwendung von noshowbase.

noshowpoint

Zeigt nur den ganzzahligen Teil von Gleitkommazahlen an, dessen Bruchteil null ist.

ios_base& noshowpoint(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

noshowpoint ist standardmäßig aktiviert; verwenden Sie showpoint und precision, um Nullen hinter dem Dezimaltrennzeichen angezeigt zu bekommen.

Der Manipulator ruft str.effektiv unetf(ios_base::showpoint) auf und gibt dann str zurück.

Beispiel

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

Bewirkt, dass positive Zahlen nicht explizit signiert werden.

ios_base& noshowpos(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

noshowpos ist standardmäßig aktiviert.

Der Manipulator ruft str.effektiv unetf(ios_base::showpos) auf und gibt dann str zurück.

Beispiel

Unter showpos finden Sie ein Beispiel für die Verwendung von noshowpos.

noskipws

Bewirkt, dass Leerzeichen vom Eingabestream gelesen werden.

ios_base& noskipws(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

In der Standardeinstellung ist skipws aktiviert. Wenn im Eingabestream ein Leerzeichen erkannt wird, wird dadurch das Ende des Puffers markiert.

Der Manipulator ruft str.effektiv unetf(ios_base::skipws) auf und gibt dann str zurück.

Beispiel

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

Bewirkt, dass die Ausgabe gepuffert und verarbeitet wird, wenn der Puffer voll ist.

ios_base& nounitbuf(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

unitbuf bewirkt, dass der Puffer verarbeitet wird, wenn dieser nicht leer ist.

Der Manipulator ruft str.effektiv unetf(ios_base::unitbuf) auf und gibt dann str zurück.

nouppercase

Gibt an, dass hexadezimale Ziffern und der Exponent in wissenschaftlicher Schreibweise in Kleinbuchstaben angezeigt werden.

ios_base& nouppercase(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

Der Manipulator ruft str.effektiv unetf(ios_base::uppercase) auf und gibt dann str zurück.

Beispiel

Unter uppercase finden Sie ein Beispiel für die Verwendung von nouppercase.

oct

Gibt an, dass ganzzahlige Variablen in Basis-8-Schreibweise angezeigt werden.

ios_base& oct(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

Standardmäßig werden Ganzzahlvariablen in Basis-10-Schreibweise angezeigt. Ebenfalls verändern dec und hex die Anzeige von Ganzzahlvariablen.

Der Manipulator ruft setf effektiv auf str.und gibt dann str zurück.(ios_base::oct, ios_base::basefield)

Beispiel

Ein Beispiel für die Verwendung finden Sie unter dec.oct

Bewirkt, dass Text, der nicht so breit ist wie die Ausgabebreite, im Stream rechtsbündig angezeigt wird.

ios_base& right(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

left modifiziert auch die Textausrichtung.

Der Manipulator ruft setf effektiv auf str.und gibt dann str zurück.(ios_base::right, ios_base::adjustfield)

Beispiel

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

Bewirkt, dass Gleitkommazahlen in wissenschaftlicher Schreibweise angezeigt werden.

ios_base& scientific(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

Für Gleitkommazahlen ist die fixed-Schreibweise standardmäßig aktiviert.

Der Manipulator ruft setf effektiv auf str.und gibt dann str zurück.(ios_base::scientific, ios_base::floatfield)

Beispiel

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

Gibt die Schreibweisenbasis an, mit der eine Zahl angezeigt wird.

ios_base& showbase(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

Die Schreibweisenbasis einer Zahl kann mit dec, oct und hex geändert werden.

Der Manipulator ruft setf effektiv auf str.und gibt dann str zurück.(ios_base::showbase)

Beispiel

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

Zeigt den ganzzahligen Teil einer Gleitkommazahl und Ziffern rechts vom Dezimaltrennzeichen an, selbst wenn der Bruchteil null ist.

ios_base& showpoint(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

noshowpoint ist standardmäßig aktiviert.

Der Manipulator ruft setf effektiv auf str.und gibt dann str zurück.(ios_base::showpoint)

Beispiel

Unter noshowpoint finden Sie ein Beispiel für die Verwendung von showpoint.

showpos

Bewirkt, dass positive Zahlen explizit signiert werden.

ios_base& showpos(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

noshowpos ist die Standardeinstellung.

Der Manipulator ruft setf effektiv auf str.und gibt dann str zurück.(ios_base::showpos)

Beispiel

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

Bewirkt, dass Leerzeichen nicht vom Eingabestream gelesen werden.

ios_base& skipws(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

In der Standardeinstellung ist skipws aktiviert. noskipws bewirkt, dass Leerzeichen aus Eingabestream gelesen werden.

Der Manipulator ruft setf effektiv auf str.und gibt dann str zurück.(ios_base::skipws)

Beispiel

#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

Bewirkt, dass die Ausgabe verarbeitet wird, wenn der Puffer nicht leer ist.

ios_base& unitbuf(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

Bitte beachten Sie, dass endl auch den Puffer leert.

nounitbuf ist standardmäßig aktiviert.

Der Manipulator ruft str.setf(effektiv ios_base::unitbuf) auf und gibt dann str zurück.

Großbuchstaben

Gibt an, dass hexadezimale Ziffern und der Exponent in wissenschaftlicher Schreibweise in Großbuchstaben angezeigt werden.

ios_base& uppercase(ios_base& str);

Parameter

str
Ein Verweis auf ein ios_base-Objekt oder auf einen Typ, der von ios_base erbt.

Rückgabewert

Ein Verweis auf das Objekt, von dem str abgeleitet wird.

Hinweise

nouppercase ist standardmäßig aktiviert.

Der Manipulator ruft str.setf(effektiv ios_base::Großbuchstaben) auf und gibt dann str zurück.

Beispiel

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