[#BloombergLP-bdlt-TimeTzFormatter-formatNextSpecifier]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlt.adoc[bdlt]::xref:BloombergLP/bdlt/TimeTzFormatter.adoc[TimeTzFormatter]::formatNextSpecifier
:relfileprefix: ../../../
:mrdocs:

Format one recognized specifier from `&ast;specInOut` into `&ast;outIt`&period;

== Synopsis

Declared in `&lt;bdlt&lowbar;timetzformatter&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class t&lowbar;ITERATOR&gt;
bool
formatNextSpecifier(
    xref:BloombergLP/bdlt/TimeTzFormatter.adoc[StringView]* specInOut,
    t&lowbar;ITERATOR* outIt,
    xref:BloombergLP/bdlt/TimeTzFormatter.adoc[FormatCache] const& value) const;
----

== Description

If the first character of the specified `&ast;specInOut` is recognized by this specifier formatter, use it to format the specified `value` to `&ast;outIt`, remove the character from `&ast;specInOut`, and return `true`, otherwise return `false` with no modification to `&ast;specInOut`&period;

== Return Value

`true` if a specifier was formatted

== Parameters

[cols="1,4"]
|===
| Name| Description
| *specInOut*
| remaining format specification
| *outIt*
| output iterator receiving formatted characters
| *value*
| cached time&hyphen;tz fields to format
|===


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