[#BloombergLP-bslfmt-FormatSpecificationParser]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslfmt.adoc[bslfmt]::FormatSpecificationParser
:relfileprefix: ../../
:mrdocs:

Mechanism for parsing Standard C++ format‐specification sections.

== Synopsis

Declared in `<bslfmt_formatspecificationparser.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class t_CHAR>
class FormatSpecificationParser
    : public xref:BloombergLP/bslfmt/FormatSpecificationParserEnums.adoc[FormatSpecificationParserEnums]
----

== Description

This class supports parsing syntaxes of the form `fill‐and‐align?sign # 0 width?precision?L` and any syntax that contains a subset of the sections therein.

== Base Classes

[cols="1,4"]
|===
| Name| Description
| `xref:BloombergLP/bslfmt/FormatSpecificationParserEnums.adoc[FormatSpecificationParserEnums]`
| Namespace struct holding enums used for parsing.
|===

== Enums

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bslfmt/FormatSpecificationParserEnums/Alignment.adoc[`Alignment`] 
| Alignment options parsed from a format specification.
| xref:BloombergLP/bslfmt/FormatSpecificationParserEnums/ProcessingState.adoc[`ProcessingState`] 
| Parser processing states for a format specification.
| xref:BloombergLP/bslfmt/FormatSpecificationParserEnums/Sections.adoc[`Sections`] 
| Bit flags indicating which format‐spec sections were parsed.
| xref:BloombergLP/bslfmt/FormatSpecificationParserEnums/Sign.adoc[`Sign`] 
| Sign options parsed from a format specification.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bslfmt/FormatSpecificationParser/2constructor.adoc[`FormatSpecificationParser`]         [.small]#[constructor]#
| Create a default instance of `FormatSpecificationParser`.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/alignment.adoc[`alignment`] 
| Return the stored alignment value.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/alternativeFlag.adoc[`alternativeFlag`] 
| Return whether an alternative processing flag was parsed.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/filler.adoc[`filler`] 
| Return the stored filler string.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/fillerCodePointDisplayWidth.adoc[`fillerCodePointDisplayWidth`] 
| Return the width of the filler code point.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/localeSpecificFlag.adoc[`localeSpecificFlag`] 
| Return whether a locale‐specific formatting flag was parsed.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/numFillerCharacters.adoc[`numFillerCharacters`] 
| Return the size of the stored filler string.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/parse.adoc[`parse`] 
| Parse format specification sections from `parseContext`.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/postprocess.adoc[`postprocess`] 
| Resolve nested width and precision from `context` arguments.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/postprocessedPrecision.adoc[`postprocessedPrecision`] 
| Return the modified numeric precision extracted during postprocessing.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/postprocessedWidth.adoc[`postprocessedWidth`] 
| Return the modified numeric width extracted during postprocessing.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/processingState.adoc[`processingState`] 
| Return the current processing state of this parser.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/rawPrecision.adoc[`rawPrecision`] 
| Return the unmodified precision extracted during parsing.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/rawWidth.adoc[`rawWidth`] 
| Return the unmodified width extracted during parsing.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/remainingSpec.adoc[`remainingSpec`] 
| Return the unparsed remainder of the specification string.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/sign.adoc[`sign`] 
| Return the stored sign value.
| xref:BloombergLP/bslfmt/FormatSpecificationParser/zeroPaddingFlag.adoc[`zeroPaddingFlag`] 
| Return whether a zero padding flag was parsed.
|===



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