Write a string to an output stream.

Synopsis

Declared in <bslstl_string.h>

template<
    class CHAR_TYPE,
    class CHAR_TRAITS,
    class ALLOCATOR>
std::basic_ostream<CHAR_TYPE, CHAR_TRAITS>&
operator<<(
    std::basic_ostream<CHAR_TYPE, CHAR_TRAITS>& os,
    basic_string<CHAR_TYPE, CHAR_TRAITS, ALLOCATOR> const& str);

Description

Write the string specified by str into the output stream specified by os, and return os. If the string is shorter than os.width(), then it is padded to os.width() with the current os.fill() character. The padding, if any, is output after the string (on the right) if `os.flags() | ios::left` is non‐zero and before the string otherwise. This function will do nothing unless os.good() is true on entry.

Return Value

reference to the output stream os

Parameters

Name

Description

os

output stream

str

string to write

Created with MrDocs