| CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Wed, 23 Jul 2025 15:33:11 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/fstream/basic_filebuf/close/
HTTP/1.1 200 OK
Server: nginx
Date: Wed, 23 Jul 2025 15:33:12 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"74fa-pdyou4YQNnI0p/KqZgbE2/06bo8"
Content-Encoding: gzip
Closes the file currently associated with the object, disassociating them.
Any pending output sequence is written to the file (as if calling virtual member overflow), along with any unshift characters (codecvt::unshift), when needed.
The function fails if any of these operations fail, or if no file is currently open.
In case of failure (including when the file is not open), a null pointer is returned.
Concurrent access to the same file stream buffer object may introduce data races.
Any exception thrown by an internal operation is caught by the function and rethrown after closing the file.
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
<fstream>
class templates
classes
basic_filebuf
- basic_filebuf::~basic_filebuf
- basic_filebuf::basic_filebuf
public members
protected virtual members
non-member overloads
-
swap (basic_filebuf)C++11
-
- Reference
- <fstream>
- basic_filebuf
- close
public member function
<fstream>
std::basic_filebuf::close
basic_filebuf* close();
Close file
Any pending output sequence is written to the file (as if calling virtual member overflow), along with any unshift characters (codecvt::unshift), when needed.
The function fails if any of these operations fail, or if no file is currently open.
Parameters
noneReturn Value
The function returnsthis, if successful.In case of failure (including when the file is not open), a null pointer is returned.
Example
|
|
Data races
Modifies the basic_filebuf object.Concurrent access to the same file stream buffer object may introduce data races.
Exception safety
Basic guarantee: if an exception is thrown, the file stream buffer is in a valid state.Any exception thrown by an internal operation is caught by the function and rethrown after closing the file.
See also
- basic_filebuf::open
- Open file (public member function)
- basic_filebuf::is_open
- Check if file is open (public member function)
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us