Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::ofstream — zapis do pliku

std::ofstream z nagłówka <fstream> zapisuje dane do pliku za pomocą interfejsu strumieniowego. Poznaj domyślne nadpisywanie zawartości, dopisywanie oraz sprawdzanie błędów otwarcia, zapisu i zamknięcia.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <fstream>
std::ofstream out("file.txt");
out << "text\n";
out.close();

std::ofstream z nagłówka <fstream> jest aliasem std::basic_ofstream<char>. Udostępnia strumień wyjściowy powiązany z plikiem; operator << służy do zapisu formatowanego. Obiekt można przenosić, ale nie kopiować.

Konstruktor przyjmujący ścieżkę próbuje od razu otworzyć plik. Domyślne std::ios::out tworzy plik, jeśli to możliwe, albo usuwa dotychczasową zawartość istniejącego pliku. std::ios::trunc wyraża to usunięcie jawnie. Aby dopisywać, użyj std::ios::app, które kieruje każdy zapis na koniec pliku. std::ios::ate ustawia pozycję na końcu tylko po otwarciu; nie jest zamiennikiem dopisywania. std::ios::binary wybiera tryb binarny, ale nie zamienia << w surowy zapis reprezentacji obiektu.

Sprawdzaj stan przez if (!out) po otwarciu oraz po zapisie i zamknięciu. is_open() informuje o powiązaniu z otwartym plikiem, a nie o powodzeniu wszystkich zapisów. Domyślnie błędy strumienia są sygnalizowane flagami stanu; można włączyć wyjątki przez exceptions(). Zapis jest buforowany: błąd może ujawnić się dopiero podczas opróżniania bufora lub close().

Zniszczenie obiektu automatycznie zamyka plik przez jego bufor. Jawne close() pozwala sprawdzić błąd zamknięcia, zanim strumień przestanie istnieć. Przykład nadpisuje cktis-ofstream-example.txt w bieżącym katalogu roboczym i wypisuje saved dopiero po sprawdzeniu stanu po zamknięciu. Używa funkcji dostępnych w C++23; podlinkowany dokument jest rozwijanym szkicem standardu, a nie zamrożonym wydaniem C++23.

Przykłady

#include <fstream>
#include <iostream>

int main() {
    std::ofstream out("cktis-ofstream-example.txt",
                      std::ios::out | std::ios::trunc);
    if (!out) {
        std::cerr << "open failed\n";
        return 1;
    }

    out << "Hello, file!\n";
    out.close();
    if (!out) {
        std::cerr << "write or close failed\n";
        return 1;
    }

    std::cout << "saved\n";
}

Wynik

saved

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła