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

Format one recognized specifier from `*specInOut` into `*outIt`.

== Synopsis

Declared in `<bdlt_dateformatter.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class t_ITERATOR>
bool
formatNextSpecifier(
    bsl::basic_string_view<t_CHAR>* specInOut,
    t_ITERATOR* outIt,
    xref:BloombergLP/bdlt/DateFormatter_Cache.adoc[DateFormatter_Cache] const& value) const;
----

== Description

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

== 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 date fields to format
|===


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