[#BloombergLP-balxml-Decoder-2constructor-0c]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balxml.adoc[balxml]::xref:BloombergLP/balxml/Decoder.adoc[Decoder]::Decoder
:relfileprefix: ../../../
:mrdocs:

Construct a decoder using the specified `options` and `reader`.

== Synopsis

Declared in `<balxml_decoder.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
Decoder(
    xref:BloombergLP/balxml/DecoderOptions.adoc[DecoderOptions] const* options,
    xref:BloombergLP/balxml/Reader.adoc[Reader]* reader,
    xref:BloombergLP/balxml/ErrorInfo.adoc[ErrorInfo]* errInfo = 0,
    std::ostream* errorStream = 0,
    std::ostream* warningStream = 0,
    xref:BloombergLP/bslma/Allocator.adoc[bslma::Allocator]* basicAllocator = 0);
----

== Description

Construct a decoder object using the specified `options` and the specified `reader` to perform the XML‐level parsing. If the (optionally) specified `errorInfo` is non‐null, it is used to store information about most serious error encountered during parsing. During parsing, error and warning messages will be written to the (optionally) specified `errorStream` and `warningStream` respectively. The behavior is undefined unless `options` and `reader` are both non‐zero. The behavior becomes undefined if the objects pointed to by any of the arguments is destroyed before this object has completed parsing.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *options*
| decoder options; held, not owned
| *reader*
| XML reader used for parsing; held, not owned
| *errInfo*
| optional error‐info structure; held, not owned
| *errorStream*
| optional stream for error messages; held, not owned
| *warningStream*
| optional stream for warning messages; held, not owned
| *basicAllocator*
| allocator used to supply memory
|===


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