Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::ifstream: vstupní souborový stream

std::ifstream spojuje znakový vstup se souborem a uchovává formátovací, EOF a chybový stav.

Verze: C++23

Syntaxe

using std::ifstream = std::basic_ifstream<char>;

explicit std::ifstream(const char* path,
    std::ios_base::openmode mode = std::ios_base::in);
explicit std::ifstream(const std::filesystem::path& path,
    std::ios_base::openmode mode = std::ios_base::in);

void open(const std::filesystem::path& path,
    std::ios_base::openmode mode = std::ios_base::in);
void close();
bool is_open() const;

std::ifstream z <fstream> je alias std::basic_ifstream<char>. Obsahuje std::basic_filebuf a dědí formátovaný i neformátovaný vstup z std::basic_istream. Konstruktor nebo open přidává k režimu std::ios::in; std::ios::binary vypíná případné platformní textové převody. Soubor lze pojmenovat pomocí std::filesystem::path.

Příklad nejprve vytvoří soubor s 12 cyan, potom jej otevře přes std::ifstream, načte číslo a slovo a vypíše 12 cyan. if (!input) ověří extrakci a explicitní close předchází odstranění souboru.

Neúspěšné otevření nastaví failbit; is_open() hlásí spojení bufferu, kdežto operator bool, fail(), bad() a eof() stav operace. std::ios_base::failure se vyhodí jen pro bity v exceptions(). Po EOF před novým seekg zavolejte clear(), pokud stav brání operaci. Stream lze přesouvat, ne kopírovat. Destruktor zavírá, ale pro diagnostiku chyby použijte close a zkontrolujte stav.

Příklady

#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>

int main() {
    const std::filesystem::path path = "cpp-ref-015-ifstream.txt";
    {
        std::ofstream output(path);
        output << "12 cyan\n";
    }

    std::ifstream input(path);
    int number{};
    std::string word;
    input >> number >> word;
    if (!input) return 1;
    std::cout << number << ' ' << word << '\n';
    input.close();
    std::filesystem::remove(path);
}

Výsledek

12 cyan

std::ifstream → 12 cyan

Zdroje