std::ends - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::ends

From cppreference.com
< cpp‎ | io‎ | manip

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.

### [edit] 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.

### [edit] Parameters

os | - | reference to output stream

### [edit] Return value

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

### [edit] 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

### [edit] See also

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

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/io/manip/ends&oldid=77519"