[#BloombergLP-balxml-Formatter_PrettyImplStateId-Enum]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balxml.adoc[balxml]::xref:BloombergLP/balxml/Formatter_PrettyImplStateId.adoc[Formatter&lowbar;PrettyImplStateId]::Enum
:relfileprefix: ../../../
:mrdocs:

Enumerators labeling distinct states of `Formatter&lowbar;PrettyImplState`&period;

== Synopsis

Declared in `&lt;balxml&lowbar;formatter&lowbar;prettyimpl&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
enum Enum;
----

== Members

[cols="1,4"]
|===
| Name| Description
| `e&lowbar;AT&lowbar;START` 
| This state indicates that the current write position of the formatter is at the start of the document&period; The formatter is only allowed to add an XML header when in this state&period;
| `e&lowbar;AFTER&lowbar;START&lowbar;NO&lowbar;TAG` 
| This state indicates that the current write position of the formatter is after some tokens have been emitted, such as an XML header and&sol;or some comments, but before any XML tags have been emitted&period; The formatter is not allowed to emit an XML header when in this state&period;
| `e&lowbar;IN&lowbar;TAG` 
| This state indicates that the current write position of the formatter is immediately after the name of an opening tag, or otherwise immediately after the value of an attribute of an opening tag&period; In this state, most token printing operations, other than adding attributes, need to emit a &quot;&gt;&quot; character to close the currently open tag before emitting their content&period; For example&colon; &grave; 1&verbar; &lt;someTag &grave;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&circ;
| `e&lowbar;FIRST&lowbar;DATA&lowbar;BETWEEN&lowbar;TAGS` 
| This state indicates that the current write position of the formatter is after a complete opening tag, before any data for the tag, and that there are tokens already emitted on the current line (i&period;e&period;, that the current write position is not at the start of the line)&period; In this state, whether or not token printing operations need to emit a new line and indentation generally depends on the whitespace mode set for the currently&hyphen;open tag&period; Note that comments are not considered data&period; For example&colon; &grave; 1&verbar; &lt;someTag&gt; &grave;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&circ; &grave; or&colon; &grave; 1&verbar; &lt;someTag&gt; &lt;!&hyphen;&hyphen; comment &hyphen;&hyphen;&gt; &grave;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&circ; &grave; or&colon; &grave; 1&verbar; &lt;someTag attr&equals;&quot;value&quot;&gt; 2&verbar; &lt;!&hyphen;&hyphen; comment &hyphen;&hyphen;&gt; &grave;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&circ; &grave;
| `e&lowbar;FIRST&lowbar;DATA&lowbar;AT&lowbar;LINE&lowbar;BETWEEN&lowbar;TAGS` 
| This state indicates that the current write position of the formatter is at column 0 (i&period;e&period;, that it is at the start of a new line) and either 1) after a closing tag, or 2) after a complete opening tag and optional data&period; In this state, most token printing operations need to emit indentation before their content&period; For example&colon; &grave; 1&verbar; &lt;someTag&gt; 2&verbar; &grave;&circ; &grave; or&colon; &grave; 1&verbar; &lt;someTag&gt; 2&verbar; &lt;&sol;someTag&gt; 3&verbar; &grave;&circ;
| `e&lowbar;TRAILING&lowbar;DATA&lowbar;BETWEEN&lowbar;TAGS` 
| This state indicates that the current write position of the formatter is after one or more data tokens for the currently&hyphen;open tag, and that there are tokens already emitted on the current line (i&period;e&period;, that the current write position is not at the start of a new line)&period; In this state, data printing operations must put delimiting whitespace before their data&period; What whitespace they emit may depend on the whitespace mode of the currently&hyphen;open tag&period; For example&colon; &grave; 1&verbar; &lt;someTag&gt; someData &grave;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&circ; &grave; or &grave; 1&verbar; &lt;someTag&gt; 2&verbar; some list data 3&verbar; some more list data &grave;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&circ; &grave;
| `e&lowbar;AT&lowbar;END` 
| This state indicates that the current write position of the formatter is immediately after the top&hyphen;level closing tag of the document&period;
|===



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