std::ends

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Input/output library

I/O manipulators

C-style I/O

Buffers

basic_streambuf

basic_filebuf

basic_stringbuf

strstreambuf (deprecated)

Streams

Abstractions

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

File I/O

basic_ifstream

basic_ofstream

basic_fstream

String I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array I/O

istrstream (deprecated)

ostrstream (deprecated)

strstream (deprecated)

Types

streamoff

streamsize

fpos

Error category interface

iostream_category (C++11)

io_errc (C++11)

 

Input/output manipulators

Floating-point formatting
showpoint noshowpoint setprecision	fixed scientific hexfloat defaultfloat (C++11) (C++11)
Integer formatting
setbase showbase noshowbase	dec hex oct
Boolean formatting
boolalpha noboolalpha
Field width and fill control
setfill setw	internal left right
Other formatting
showpos noshowpos	uppercase nouppercase
Whitespace processing
ws ends	skipws noskipws
Output flushing
flush endl	unitbuf nounitbuf
Status flags manipulation
resetiosflags	setiosflags
Time and money I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)

 

Defined in header <ostream>
template< class CharT, class Traits > std::basic_ostream<charT,traits>& ends( std::basic_ostream<CharT, Traits>& os );

Inserts a null character into the output sequence os as if by calling os.put(CharT()).

This is an output-only I/O manipulator, it may be called with an expression such as out << std::ends for any out of type std::basic_ostream.

Notes

This manipulator is typically used with std::ostrstream, when the associated output buffer needs to be null-terminated to be processed as a C string.

Unlike std::endl, this manipulator does not flush the stream.

Parameters

os

-

reference to output stream

Return value

os (reference to the stream after insertion of the null character)

Example

run this code

#include <cstdio>
#include <strstream>
int main()
{
    std::ostrstream oss;
    oss << "Sample text: " << 42 << std::ends;
    std::printf("%s\n", oss.str());
    oss.freeze(false); // enable memory deallocation
}

Output:

Sample text: 42

See also

ostrstream (deprecated)	implements character array output operations (class)