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

Parse a Standard format specification from `context`&period;

== Synopsis

Declared in `&lt;bslfmt&lowbar;standardformatspecification&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class t&lowbar;PARSE&lowbar;CONTEXT&gt;
constexpr
void
parse(
    t&lowbar;PARSE&lowbar;CONTEXT* context,
    xref:BloombergLP/bslfmt/StandardFormatSpecification/Category.adoc[Category] category);
----

== Description

Parse a format string using the iterator&hyphen;range from the specified `context` assuming it is a Standard format specification for arguments of the specified `category` and if successful update this object with the parsing result, as well as set the status to `e&lowbar;PARSED`&semi; otherwise, if the format specification denoted by the `context` iterator&hyphen;range is not a valid Standard format specification for arguments of category `category` throw a `bsl&colon;&colon;format&lowbar;error` exception&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *context*
| parse context providing the format&hyphen;string iterator range
| *category*
| argument category that selects the type&hyphen;character mapping
|===


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