|
typedef ctype< _CharT > | __ctype_type |
|
typedef basic_filebuf< char_type, traits_type > | __filebuf_type |
|
typedef basic_ios< _CharT, _Traits > | __ios_type |
|
typedef num_put< _CharT, ostreambuf_iterator< _CharT, _Traits > > | __num_put_type |
|
typedef basic_ostream< char_type, traits_type > | __ostream_type |
|
typedef basic_streambuf< _CharT, _Traits > | __streambuf_type |
|
typedef _CharT | char_type |
|
typedef traits_type::int_type | int_type |
|
typedef traits_type::off_type | off_type |
|
typedef traits_type::pos_type | pos_type |
|
typedef _Traits | traits_type |
|
|
| basic_ofstream () |
|
| basic_ofstream (basic_ofstream &&__rhs) |
|
template<typename _Path , typename _Require = _If_fs_path<_Path>> |
| basic_ofstream (const _Path &__s, ios_base::openmode __mode=ios_base::out) |
|
| basic_ofstream (const basic_ofstream &)=delete |
|
| basic_ofstream (const char *__s, ios_base::openmode __mode=ios_base::out) |
|
| basic_ofstream (const std::string &__s, ios_base::openmode __mode=ios_base::out) |
|
| ~basic_ofstream () |
|
template<typename _ValueT > |
basic_ostream< _CharT, _Traits > & | _M_insert (_ValueT __v) |
|
void | close () |
|
__ostream_type & | flush () |
|
bool | is_open () |
|
bool | is_open () const |
|
template<typename _Path > |
_If_fs_path< _Path, void > | open (const _Path &__s, ios_base::openmode __mode=ios_base::out) |
|
void | open (const char *__s, ios_base::openmode __mode=ios_base::out) |
|
void | open (const std::string &__s, ios_base::openmode __mode=ios_base::out) |
|
__ostream_type & | operator<< (__streambuf_type *__sb) |
|
__ostream_type & | operator<< (const void *__p) |
|
__ostream_type & | operator<< (nullptr_t) |
|
basic_ofstream & | operator= (basic_ofstream &&__rhs) |
|
basic_ofstream & | operator= (const basic_ofstream &)=delete |
|
__filebuf_type * | rdbuf () const |
|
__ostream_type & | seekp (off_type, ios_base::seekdir) |
|
__ostream_type & | seekp (pos_type) |
|
void | swap (basic_ofstream &__rhs) |
|
pos_type | tellp () |
|
|
__ostream_type & | operator<< (__ostream_type &(*__pf)(__ostream_type &)) |
|
__ostream_type & | operator<< (__ios_type &(*__pf)(__ios_type &)) |
|
__ostream_type & | operator<< (ios_base &(*__pf)(ios_base &)) |
|
|
All the operator<< functions (aka formatted output functions) have some common behavior. Each starts by constructing a temporary object of type std::basic_ostream::sentry. This can have several effects, concluding with the setting of a status flag; see the sentry documentation for more.
If the sentry status is good, the function tries to generate whatever data is appropriate for the type of the argument.
If an exception is thrown during insertion, ios_base::badbit will be turned on in the stream's error state without causing an ios_base::failure to be thrown. The original exception will then be rethrown.
|
__ostream_type & | operator<< (long __n) |
|
__ostream_type & | operator<< (unsigned long __n) |
|
__ostream_type & | operator<< (bool __n) |
|
__ostream_type & | operator<< (short __n) |
|
__ostream_type & | operator<< (unsigned short __n) |
|
__ostream_type & | operator<< (int __n) |
|
__ostream_type & | operator<< (unsigned int __n) |
|
__ostream_type & | operator<< (long long __n) |
|
__ostream_type & | operator<< (unsigned long long __n) |
|
|
__ostream_type & | operator<< (double __f) |
|
__ostream_type & | operator<< (float __f) |
|
__ostream_type & | operator<< (long double __f) |
|
|
All the unformatted output functions have some common behavior. Each starts by constructing a temporary object of type std::basic_ostream::sentry. This has several effects, concluding with the setting of a status flag; see the sentry documentation for more.
If the sentry status is good, the function tries to generate whatever data is appropriate for the type of the argument.
If an exception is thrown during insertion, ios_base::badbit will be turned on in the stream's error state. If badbit is on in the stream's exceptions mask, the exception will be rethrown without completing its actions.
|
__ostream_type & | put (char_type __c) |
|
__ostream_type & | write (const char_type *__s, streamsize __n) |
|
|
__ostream_type & | operator<< (__ostream_type &(*__pf)(__ostream_type &)) |
|
__ostream_type & | operator<< (__ios_type &(*__pf)(__ios_type &)) |
|
__ostream_type & | operator<< (ios_base &(*__pf)(ios_base &)) |
|
|
All the operator<< functions (aka formatted output functions) have some common behavior. Each starts by constructing a temporary object of type std::basic_ostream::sentry. This can have several effects, concluding with the setting of a status flag; see the sentry documentation for more.
If the sentry status is good, the function tries to generate whatever data is appropriate for the type of the argument.
If an exception is thrown during insertion, ios_base::badbit will be turned on in the stream's error state without causing an ios_base::failure to be thrown. The original exception will then be rethrown.
|
__ostream_type & | operator<< (long __n) |
|
__ostream_type & | operator<< (unsigned long __n) |
|
__ostream_type & | operator<< (bool __n) |
|
__ostream_type & | operator<< (short __n) |
|
__ostream_type & | operator<< (unsigned short __n) |
|
__ostream_type & | operator<< (int __n) |
|
__ostream_type & | operator<< (unsigned int __n) |
|
__ostream_type & | operator<< (long long __n) |
|
__ostream_type & | operator<< (unsigned long long __n) |
|
|
__ostream_type & | operator<< (double __f) |
|
__ostream_type & | operator<< (float __f) |
|
__ostream_type & | operator<< (long double __f) |
|
|
All the unformatted output functions have some common behavior. Each starts by constructing a temporary object of type std::basic_ostream::sentry. This has several effects, concluding with the setting of a status flag; see the sentry documentation for more.
If the sentry status is good, the function tries to generate whatever data is appropriate for the type of the argument.
If an exception is thrown during insertion, ios_base::badbit will be turned on in the stream's error state. If badbit is on in the stream's exceptions mask, the exception will be rethrown without completing its actions.
|
__ostream_type & | put (char_type __c) |
|
__ostream_type & | write (const char_type *__s, streamsize __n) |
|
template<typename _CharT, typename _Traits>
class std::basic_ofstream< _CharT, _Traits >
Controlling output for files.
- Template Parameters
-
_CharT | Type of character stream. |
_Traits | Traits for character type, defaults to char_traits<_CharT>. |
This class supports reading from named files, using the inherited functions from std::basic_ostream. To control the associated sequence, an instance of std::basic_filebuf is used, which this page refers to as sb
.
Definition at line 760 of file fstream.
template<typename _CharT , typename _Traits >
template<typename _Path , typename _Require = _If_fs_path<_Path>>
Create an output file stream.
- Parameters
-
__s | filesystem::path specifying the filename. |
__mode | Open file in specified mode (see std::ios_base). |
ios_base::out
is automatically included in __mode.
Definition at line 849 of file fstream.
template<typename _CharT , typename _Traits >
Synchronizing the stream buffer.
- Returns
- *this
If rdbuf()
is a null pointer, changes nothing.
Otherwise, calls rdbuf()->pubsync()
, and if that returns -1, sets badbit.
Definition at line 222 of file ostream.tcc.
template<typename _CharT , typename _Traits >
template<typename _Path >
Opens an external file.
- Parameters
-
__s | The name of the file, as a filesystem::path. |
__mode | The open mode flags. |
Calls std::basic_filebuf::open
(__s,__mode|out). If that function fails, failbit
is set in the stream's error state.
Definition at line 988 of file fstream.
template<typename _CharT , typename _Traits >
Extracting from another streambuf.
- Parameters
-
__sb | A pointer to a streambuf |
This function behaves like one of the basic arithmetic extractors, in that it also constructs a sentry object and has the same error handling behavior.
If __sb
is NULL, the stream will set failbit in its error state.
Characters are extracted from __sb
and inserted into *this
until one of the following occurs:
- the input stream reaches end-of-file,
- insertion into the output sequence fails (in this case, the character that would have been inserted is not extracted), or
- an exception occurs while getting a character from
__sb
, which sets failbit in the error state
If the function inserts no characters, failbit is set.
Definition at line 125 of file ostream.tcc.
template<typename _CharT , typename _Traits >
Floating point arithmetic inserters.
- Parameters
-
__f | A variable of builtin floating point type. |
- Returns
*this
if successful
These functions use the stream's current locale (specifically, the num_get
facet) to perform numeric formatting.
Definition at line 222 of file ostream.
template<typename _CharT , typename _Traits >
Floating point arithmetic inserters.
- Parameters
-
__f | A variable of builtin floating point type. |
- Returns
*this
if successful
These functions use the stream's current locale (specifically, the num_get
facet) to perform numeric formatting.
Definition at line 226 of file ostream.
template<typename _CharT , typename _Traits >
Floating point arithmetic inserters.
- Parameters
-
__f | A variable of builtin floating point type. |
- Returns
*this
if successful
These functions use the stream's current locale (specifically, the num_get
facet) to perform numeric formatting.
Definition at line 234 of file ostream.
template<typename _CharT , typename _Traits >
Changing the current write position.
- Parameters
-
__off | A file offset object. |
__dir | The direction in which to seek. |
- Returns
- *this
If fail()
is not true, calls rdbuf()->pubseekoff(off,dir)
. If that function fails, sets failbit.
Definition at line 288 of file ostream.tcc.
template<typename _CharT , typename _Traits >
Changing the current write position.
- Parameters
-
__pos | A file position object. |
- Returns
- *this
If fail()
is not true, calls rdbuf()->pubseekpos(pos)
. If that function fails, sets failbit.
Definition at line 269 of file ostream.tcc.
template<typename _CharT , typename _Traits >
Getting the current write position.
- Returns
- A file position object.
If fail()
is not false, returns pos_type
(-1) to indicate failure. Otherwise returns rdbuf()->pubseekoff(0,cur,out)
.
Definition at line 257 of file ostream.tcc.