std::basic_ostream::write
basic_ostream& write( const char_type* s, std::streamsize count );
|
||
Behaves as an UnformattedOutputFunction
. After constructing and checking the sentry object, outputs the characters from successive locations in the character array whose first element is pointed to by s
. Characters are inserted into the output sequence until one of the following occurs:
- exactly
count
characters are inserted - inserting into the output sequence fails (in which case setstate(badbit) is called)
Contents |
[edit] Parameters
s | - | pointer to the character string to write |
count | - | number of characters to write |
[edit] Return value
*this
[edit] Notes
This function is not overloaded for the types signed char or unsigned char, unlike the formatted operator<<
Also, unlike the formatted output functions, this function does not set the failbit
on failure.
[edit] Exceptions
If an exception occurs during output and exceptions() & badbit != 0, rethrows that exception.
If output fails and exceptions() & badbit != 0, throws ios_base::failure.
[edit] Example
This function may be used to output object representations, i.e. binary output
Output:
DCBA This
[edit] See also
inserts character data (function template) |
|
inserts a character (public member function) |