std::basic_filebuf<CharT,Traits>::close

std::basic_filebuf<CharT, Traits>* close();

Если существует область записи (например, файл открыт для записи), сначала вызывает overflow(Traits::eof()), чтобы записать в файл все ожидающие вывода данные, включая последовательности сброса состояния.

Если последней вызванной функцией из underflow(), overflow(), seekpos() и seekoff() была overflow(), то вызывает std::codecvt::unshift(), возможно, несколько раз, чтобы определить последовательность сброса состояния в соответствии с используемой локалью, и записывает эту последовательность в файл с помощью overflow(Traits::eof()).

Затем закрывает файл, как если бы была вызвана std::fclose(), независимо от того, завершились ли успешно или с ошибкой предыдущие вызовы.

Если любой из выполненных вызовов функций, включая вызов std::fclose(), завершается ошибкой, возвращает нулевой указатель. Если любой из выполненных вызовов функций выбрасывает исключение, оно перехватывается и повторно выбрасывается после закрытия файла. Если файл уже закрыт, сразу возвращает нулевой указатель.

В любом случае обновляет закрытую переменную-член, доступ к которой осуществляется через is_open().

Параметры

(нет)

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

this при успехе, нулевой указатель при ошибке.

Примечания

close() обычно вызывается деструктором std::basic_filebuf (который, в свою очередь, обычно вызывается деструктором std::basic_fstream.

Пример

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

См. также