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