std::basic_filebuf
is a std::basic_streambuf whose associated character sequence is a file. Both the input sequence and the output sequence are associated with the same file, and a joint file position is maintained for both operations. The restrictions on reading and writing a sequence with std::basic_filebuf
are the same as std::FILEs.
The functions underflow() and overflow() / sync() perform the actual I/O between the file and the get and put areas of the buffer. When CharT
is not char, most implementations store multibyte characters in the file and a std::codecvt facet is used to perform wide/multibyte character conversion.
Several typedefs for common character types are provided:
Type Definitionstd::filebuf
std::basic_filebuf<char> std::wfilebuf
std::basic_filebuf<wchar_t> [edit] Member types Type Definition char_type
CharT
[edit] traits_type
Traits
; the program is ill-formed if Traits::char_type
is not CharT
.[edit] int_type
Traits::int_type
[edit] pos_type
Traits::pos_type
which is required to be std::fpos<Traits::state_type> off_type
Traits::off_type
[edit] native_handle_type
(C++26) implementation-defined type that is TriviallyCopyable and semiregular
[edit] [edit] Member functions Public member functions constructs a basic_filebuf
object
basic_filebuf
object
basic_filebuf
objects
basic_filebuf
object and closes the file if it is open
char_type
CharT
[edit] traits_type
Traits
; the program is ill-formed if Traits::char_type
is not CharT
.[edit] int_type
Traits::int_type
[edit] pos_type
Traits::pos_type
[edit] off_type
Traits::off_type
[edit] Member functions destructs the basic_streambuf
object
std::basic_streambuf<CharT,Traits>
) [edit] Locales changes the associated locale and invokes imbue()
std::basic_streambuf<CharT,Traits>
) [edit] obtains a copy of the associated locale
std::basic_streambuf<CharT,Traits>
) [edit] Positioning invokes setbuf()
std::basic_streambuf<CharT,Traits>
) [edit] invokes seekoff()
std::basic_streambuf<CharT,Traits>
) [edit] invokes seekpos()
std::basic_streambuf<CharT,Traits>
) [edit] invokes sync()
std::basic_streambuf<CharT,Traits>
) [edit] Get area obtains the number of characters immediately available in the get area
std::basic_streambuf<CharT,Traits>
) [edit] advances the input sequence, then reads one character without advancing again
std::basic_streambuf<CharT,Traits>
) [edit] reads one character from the input sequence and advances the sequence
std::basic_streambuf<CharT,Traits>
) [edit] reads one character from the input sequence without advancing the sequence
std::basic_streambuf<CharT,Traits>
) [edit] invokes xsgetn()
std::basic_streambuf<CharT,Traits>
) [edit] Put area writes one character to the put area and advances the next pointer
std::basic_streambuf<CharT,Traits>
) [edit] invokes xsputn()
std::basic_streambuf<CharT,Traits>
) [edit] Putback puts one character back in the input sequence
std::basic_streambuf<CharT,Traits>
) [edit] moves the next pointer in the input sequence back by one
std::basic_streambuf<CharT,Traits>
) [edit] Protected member functions constructs a basic_streambuf
object
basic_streambuf
object
basic_streambuf
objects
std::basic_streambuf<CharT,Traits>
) [edit] Positioning replaces the buffer with user-defined array, if permitted
std::basic_streambuf<CharT,Traits>
) [edit] repositions the next pointer in the input sequence, output sequence, or both, using relative addressing
std::basic_streambuf<CharT,Traits>
) [edit] repositions the next pointer in the input sequence, output sequence, or both using absolute addressing
std::basic_streambuf<CharT,Traits>
) [edit] synchronizes the buffers with the associated character sequence
std::basic_streambuf<CharT,Traits>
) [edit] Get area obtains the number of characters available for input in the associated input sequence, if known
std::basic_streambuf<CharT,Traits>
) [edit] reads characters from the associated input sequence to the get area
std::basic_streambuf<CharT,Traits>
) [edit] reads characters from the associated input sequence to the get area and advances the next pointer
std::basic_streambuf<CharT,Traits>
) [edit] reads multiple characters from the input sequence
std::basic_streambuf<CharT,Traits>
) [edit] returns a pointer to the beginning, current character and the end of the get area
std::basic_streambuf<CharT,Traits>
) [edit] writes characters to the associated output sequence from the put area
std::basic_streambuf<CharT,Traits>
) [edit] returns a pointer to the beginning, current character and the end of the put area
std::basic_streambuf<CharT,Traits>
) [edit] [edit] Notes [edit] See also object type, capable of holding all information needed to control a C I/O stream
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4