[#BloombergLP-balxml-Decoder_NillableContext]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balxml.adoc[balxml]::Decoder_NillableContext
: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_NillableContext
    : public xref:BloombergLP/balxml/Decoder_ElementContext.adoc[Decoder_ElementContext]
----

== Description

Context for elements that have `bdlat_FormattingMode::e_NILLABLE`. It acts as a proxy and forwards all callbacks to the held `d_elementContext_p`. If `endElement` is called directly after `startElement`, then the `isNil()` accessor will return true.

== 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.
|===

== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balxml/Decoder_NillableContext/2constructor.adoc[`Decoder_NillableContext`]         [.small]#[constructor]#
| Create a nillable‐element parsing context.
| xref:BloombergLP/balxml/Decoder_NillableContext/2destructor.adoc[`~Decoder_NillableContext`] [.small]#[destructor]# [.small]#[virtual]#
| Destroy this parsing context.
| xref:BloombergLP/balxml/Decoder_NillableContext/addCharacters.adoc[`addCharacters`]  [.small]#[virtual]#
| Process the specified character data while decoding. 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_NillableContext/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_NillableContext/isNil.adoc[`isNil`] 
| Return `true` if the element is nil.
| xref:BloombergLP/balxml/Decoder_NillableContext/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_NillableContext/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_NillableContext/setElementContext.adoc[`setElementContext`] 
| Set the element context to the specified `elementContext`. The behavior of all methods in this class are undefined if this method has not been called.
| xref:BloombergLP/balxml/Decoder_NillableContext/startElement.adoc[`startElement`]  [.small]#[virtual]#
| Invoked when the decoder begins parsing an element. Return 0 on success, and a non‐zero value otherwise.
|===



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