std::fclose

Определён в заголовочном файле `<cstdio>`
int fclose( std::FILE* stream );

Закрывает заданный файловый поток и записывает все незаписанные данные из буфера stream на связанное устройство вывода. Все непрочитанные буферизованные данные отбрасываются.

Независимо от того, завершилась ли операция успешно, поток больше не связан с файлом, а буфер, выделенный с помощью std::setbuf или std::setvbuf, если таковой имеется, также отсоединяется и освобождается, если использовалось автоматическое выделение памяти.

Если данные записываются на устройство вывода, возврат из std::fclose устанавливает наблюдаемую контрольную точку.

(начиная с C++26)

Поведение не определено, если значение указателя stream используется после возврата из std::fclose.

Параметры

stream

закрываемый файловый поток

Возвращаемое значение

0 в случае успеха, в противном случае — EOF.

Пример

#include <cstdio>
#include <cstdlib>

int main()
{
    int is_ok = EXIT_FAILURE;
    FILE* fp = std::fopen("/tmp/test.txt", "w+");
    if (!fp)
    {
        std::perror("File opening failed");
        return is_ok;
    }

    int c; // Note: int, not char, required to handle EOF
    while ((c = std::fgetc(fp)) != EOF) // Standard C I/O file reading loop
        std::putchar(c);

    if (std::ferror(fp))
        std::puts("I/O error when reading");
    else if (std::feof(fp))
    {
        std::puts("End of file reached successfully");
        is_ok = EXIT_SUCCESS;
    }

    std::fclose(fp);
    return is_ok;
}

Вывод:

End of file reached successfully

См. также

fopen	открывает файл (функция)
freopen	открывает существующий поток под другим именем (функция)
close	сбрасывает буфер области записи и закрывает связанный файл (открытая функция-член `std::basic_filebuf<CharT,Traits>`)
Документация по C для `fclose`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/c/fclose