Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::ifstream: wejściowy strumień plikowy

std::ifstream wiąże operacje wejściowe znaków z plikiem i przechowuje stan formatowania, EOF oraz błędów.

Wersja: C++23

Składnia

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> jest aliasem std::basic_ifstream<char>. Zawiera std::basic_filebuf i dziedziczy formatowane oraz niesformatowane wejście po std::basic_istream. Konstruktor lub open przekazuje tryb powiększony o std::ios::in; std::ios::binary wyłącza właściwe platformie translacje trybu tekstowego. Można podać ścieżkę std::filesystem::path.

Przykład najpierw tworzy plik z tekstem 12 cyan, potem otwiera go przez std::ifstream, pobiera liczbę i słowo i wypisuje 12 cyan. Sprawdzenie if (!input) weryfikuje wynik ekstrakcji; jawne close poprzedza usunięcie pliku.

Nieudane otwarcie ustawia failbit; is_open() mówi o powiązaniu bufora, a operator bool, fail(), bad() i eof() o stanie operacji. std::ios_base::failure jest rzucany tylko dla bitów w exceptions(). Po EOF przed ponownym seekg zwykle trzeba wywołać clear(). Strumień jest przenoszalny, niekopiowalny; destruktor zamyka plik, lecz do raportowania błędu zamknięcia użyj jawnego close i sprawdź stan.

Przykłady

#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);
}

Wynik

12 cyan

std::ifstream → 12 cyan

Źródła