[#BloombergLP-balxml-Decoder_StdStringContext]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balxml.adoc[balxml]::Decoder_StdStringContext
:relfileprefix: ../../
:mrdocs:

COMPONENT‐PRIVATE CLASS. DO NOT USE OUTSIDE OF THIS COMPONENT.

== Synopsis

Declared in `<balxml_decoder.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
class Decoder_StdStringContext
    : public xref:BloombergLP/balxml/Decoder_ElementContext.adoc[Decoder_ElementContext]
----

== Description

Proxy context for `bsl::string`. This is just a proxy context. It will forward all callbacks to the appropriate context, based on the formatting mode.

== Base Classes

[cols="1,4"]
|===
| Name| Description
| `xref:BloombergLP/balxml/Decoder_ElementContext.adoc[Decoder_ElementContext]`
| COMPONENT‐PRIVATE CLASS. DO NOT USE OUTSIDE OF THIS COMPONENT.
|===

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balxml/Decoder_StdStringContext/Base64Context.adoc[`Base64Context`] 
| Context type for base64‐encoded string parsing.
| xref:BloombergLP/balxml/Decoder_StdStringContext/HexContext.adoc[`HexContext`] 
| Context type for hex‐encoded string parsing.
| xref:BloombergLP/balxml/Decoder_StdStringContext/UTF8Context.adoc[`UTF8Context`] 
| Context type for UTF‐8 string parsing.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balxml/Decoder_StdStringContext/2constructor.adoc[`Decoder_StdStringContext`]         [.small]#[constructor]#
| Create a proxy context for decoding a `bsl::string` using the specified `formattingMode`.
| xref:BloombergLP/balxml/Decoder_StdStringContext/2destructor.adoc[`~Decoder_StdStringContext`] [.small]#[destructor]# [.small]#[virtual]#
| Destroy this string parsing context.
| xref:BloombergLP/balxml/Decoder_StdStringContext/addCharacters.adoc[`addCharacters`]  [.small]#[virtual]#
| Process the specified character data `chars` of the specified `length` while decoding a `bsl::string` element. Return 0 on success and a non‐zero value otherwise.
| xref:BloombergLP/balxml/Decoder_ElementContext/beginParse.adoc[`beginParse`] 
| Invoked when the decoder begins parsing. Return 0 on success, and a non‐zero value otherwise.
| xref:BloombergLP/balxml/Decoder_StdStringContext/endElement.adoc[`endElement`]  [.small]#[virtual]#
| Invoked when the decoder finishes parsing an element. Return 0 on success, and a non‐zero value otherwise.
| xref:BloombergLP/balxml/Decoder_StdStringContext/parseAttribute.adoc[`parseAttribute`]  [.small]#[virtual]#
| Invoked when the decoder encounters an attribute. Return 0 on success, and a non‐zero value otherwise.
| xref:BloombergLP/balxml/Decoder_StdStringContext/parseSubElement.adoc[`parseSubElement`]  [.small]#[virtual]#
| Invoked when the decoder encounters a sub‐element. Return 0 on success, and a non‐zero value otherwise.
| xref:BloombergLP/balxml/Decoder_StdStringContext/startElement.adoc[`startElement`]  [.small]#[virtual]#
| Invoked when the decoder begins parsing an element. Return 0 on success, and a non‐zero value otherwise.
|===


== Data Members

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balxml/Decoder_StdStringContext/d_base64Context.adoc[`d_base64Context`] [.small]#[variant member]#
| Active base64 parser context storage.
| xref:BloombergLP/balxml/Decoder_StdStringContext/d_hexContext.adoc[`d_hexContext`] [.small]#[variant member]#
| Active hex parser context storage.
| xref:BloombergLP/balxml/Decoder_StdStringContext/d_utf8Context.adoc[`d_utf8Context`] [.small]#[variant member]#
| Active UTF‐8 parser context storage.
|===



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