Namensräume
Varianten
Aktionen

std::iostream_category

Von cppreference.com
< cpp‎ | io
 
 
 
Definiert in Header <ios>
const std::error_category& iostream_category() noexcept;
(seit C++11)

Ruft eine Referenz auf das statische Fehlerkategorieobjekt für iostream-Fehler ab. Das Objekt muss die virtuelle Funktion error_category::name() überschreiben, um einen Zeiger auf den String "iostream" zurückzugeben. Es wird verwendet, um Fehlercodes zu identifizieren, die in den Ausnahmen vom Typ std::ios_base::failure angegeben sind.

Inhalt

[bearbeiten] Parameter

(keine)

[bearbeiten] Rückgabewert

Eine Referenz auf das statische Objekt eines nicht spezifizierten Laufzeittyps, abgeleitet von std::error_category.

[bearbeiten] Beispiel

#include <fstream>
#include <iostream>
 
int main()
{
    std::ifstream f("doesn't exist");
    try
    {
        f.exceptions(f.failbit);
    }
    catch (const std::ios_base::failure& e)
    {
        std::cout << "Caught an ios_base::failure.\n"
                  << "Error code: " << e.code().value() 
                  << " (" << e.code().message() << ")\n"
                  << "Error category: " << e.code().category().name() << '\n';
 
    }
}

Mögliche Ausgabe

Caught an ios_base::failure.
Error code: 1 (unspecified iostream_category error)
Error category: iostream

[bearbeiten] Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 2087 C++11 iostream_category war nicht als noexcept deklariert als noexcept deklariert

[bearbeiten] Siehe auch

Stream-Exception
(public member class of std::ios_base) [bearbeiten]
(C++11)
die IO-Stream-Fehlercodes
(Aufzählung) [bearbeiten]