[#BloombergLP-bdld-operator_lshift-0cb]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdld.adoc[bdld]::operator&lt;&lt;
:relfileprefix: ../../
:mrdocs:

Stream insertion operators

== Synopses

Declared in `&lt;bdld&lowbar;datum&period;h&gt;`

Write the value of the specified `rhs` object to the specified output `stream` in a single&hyphen;line format, and return a reference to the modifyable `stream`&period; If `stream` is not valid on entry, this operation has no effect&period; Note that this human&hyphen;readable format is not fully specified, can change without notice, and is logically equivalent to&colon; &grave; print(stream, 0, &hyphen;1)&semi; &grave;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-0b4.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/DatumBinaryRef.adoc[DatumBinaryRef] const& rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-0b4.adoc[_» more&period;&period;&period;_]#

Write the value of the specified `rhs` object to the specified output `stream` in a single&hyphen;line format, and return a reference to the modifyable `stream`&period; If `stream` is not valid on entry, this operation has no effect&period; Note that this human&hyphen;readable format is not fully specified, can change without notice, and is logically equivalent to&colon; &grave; print(stream, 0, &hyphen;1)&semi; &grave; Single line output format for the `DatumError` object is shown below&colon; &grave; error(n) error(n,&apos;msg&apos;) &grave; (where n is the integer error code value and `msg` is the error message value in single quotes)&period; Note that the first version will be output if there is no error message string&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-0ca.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/DatumError.adoc[DatumError] const& rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-0ca.adoc[_» more&period;&period;&period;_]#

Write the value of the specified `rhs` object to the specified output `stream` in a single&hyphen;line format, and return a reference to the modifyable `stream`&period; If `stream` is not valid on entry, this operation has no effect&period; Note that this human&hyphen;readable format is not fully specified, can change without notice, and is logically equivalent to&colon; &grave; print(stream, 0, &hyphen;1)&semi; &grave; Single line output format for the `DatumUdt` object is shown below&colon; &grave; user&hyphen;defined(&lt;address&gt;,type) &grave; (where `address` is hex value of the pointer to the user&hyphen;define object and `type` is the type of the user&hyphen;defined object)


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-05a.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/DatumUdt.adoc[DatumUdt] const& rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-05a.adoc[_» more&period;&period;&period;_]#

Write the specified `rhs` value to the specified output `stream` in the format shown in the second column in the table below (based on the type of value stored, indicated by the first column)&colon; &grave; null &hyphen; nil


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-015.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/Datum.adoc[Datum] const& rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-015.adoc[_» more&period;&period;&period;_]#

Write the string representation of the specified enumeration `rhs` to the specified `stream` in a single&hyphen;line format, and return a reference to the modifiable `stream`&period; See `dataTypeToAscii` for what constitutes the string representation of a `Datum&colon;&colon;DataType` value&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-0b3.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/Datum/DataType.adoc[Datum::DataType] rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-0b3.adoc[_» more&period;&period;&period;_]#

Write the specified `rhs` value to the specified output `stream` in the format shown below&colon; &grave; &lsqb;aa,bb,cc&rsqb;&hyphen; aa, bb and cc are the result of invoking operator `&lt;&lt;` on the individual elements in the array &grave; and return a reference to the modifiable `stream`&period; The function will have no effect if the `stream` is not valid&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-034.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/DatumArrayRef.adoc[DatumArrayRef] const& rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-034.adoc[_» more&period;&period;&period;_]#

Write the specified `rhs` value to the specified output `stream` in the format shown below&colon; &grave; (nnn,aa) &hyphen; nnn is key integer, while aa is the result of invoking operator `&lt;&lt;` on the value &grave; and return a reference to the modifiable `stream`&period; The function will have no effect if the `stream` is not valid&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-033.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/DatumIntMapEntry.adoc[DatumIntMapEntry] const& rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-033.adoc[_» more&period;&period;&period;_]#

Write the specified `rhs` value to the specified output `stream` in the format shown below&colon; &grave; &lsqb; nnn &equals; aa, mmm &equals; bb&rsqb;&hyphen; nnn and mmm are key ints, while aa and bb are the result of invoking operator `&lt;&lt;` on the individual value elements in the map &grave; and return a reference to the modifiable `stream`&period; The function will have no effect if the `stream` is not valid&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-0c0.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/DatumIntMapRef.adoc[DatumIntMapRef] const& rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-0c0.adoc[_» more&period;&period;&period;_]#

Write the specified `rhs` value to the specified output `stream` in the format shown below&colon; &grave; (abc,aa) &hyphen; abc is key string, while aa is the result of invoking operator `&lt;&lt;` on the value &grave; and return a reference to the modifiable `stream`&period; The function will have no effect if the `stream` is not valid&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-01f.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/DatumMapEntry.adoc[DatumMapEntry] const& rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-01f.adoc[_» more&period;&period;&period;_]#

Write the specified `rhs` value to the specified output `stream` in the format shown below&colon; &grave; &lsqb; abc &equals; aa, pqr &equals; bb&rsqb;&hyphen; abc and pqr are key strings, while aa and bb are the result of invoking operator &apos;&lt;&lt;&apos; on the individual value elements in the map &grave; and return a reference to the modifiable `stream`&period; The function will have no effect if the `stream` is not valid&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-0b8.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/DatumMapRef.adoc[DatumMapRef] const& rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-0b8.adoc[_» more&period;&period;&period;_]#

Write the specified `rhs` value to the specified output `stream` and return a reference to the modifiable `stream`&period; This function has no effect if `stream` is not valid on entry&period; Note that this method invokes `operator&lt;&lt;` defined for `Datum`&period; See the function&hyphen;level documentation of the `operator&lt;&lt;` defined for `Datum` for details of the format of the output&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
xref:BloombergLP/bdld/operator_lshift-05d.adoc[operator&lt;&lt;](
    std::ostream& stream,
    xref:BloombergLP/bdld/ManagedDatum.adoc[ManagedDatum] const& rhs);
----

[.small]#xref:BloombergLP/bdld/operator_lshift-05d.adoc[_» more&period;&period;&period;_]#


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