[#bsl-operator_lshift-05f]
= xref:bsl.adoc[bsl]::operator<<
:relfileprefix: ../
:mrdocs:

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.

== Synopsis

Declared in `<bslstl_string.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
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,
    xref:bsl/basic_string-0faf.adoc[basic_string<CHAR_TYPE, CHAR_TRAITS, ALLOCATOR>] const& str);
----


[.small]#Created with https://www.mrdocs.com[MrDocs]#