BloombergLP::balxml::Formatter_PrettyImplUtil::addHeader

Add an XML declaration header with the optionally specified encoding.

Synopsis

Declared in <balxml_formatter_prettyimpl.h>

static
std::ostream&
addHeader(
    std::ostream& stream,
    State* state,
    std::string_view const& encoding);

Description

Write to the specified stream, with formatting depending on the specified state, and update state accordingly. Return the stream. Version is always "1.0". The behavior is undefined unless addHeader is the first manipulator (with the exception of rawOutputStream) after construction or reset.

Return Value

a reference to the modifiable stream

Parameters

NameDescription
streamoutput stream to write to
stateformatter state to update
encodingcharacter encoding named in the XML declaration