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

A format context for use by `formatter::format()` partial specialization.

== Synopsis

Declared in `<bslfmt_format_context.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class t_OUT,
    class t_CHAR>
class basic_format_context;
----

== Description

It provides access to the output iterator for writing the formatted value and access to all formatting arguments.

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bslfmt/basic_format_context/char_type.adoc[`char_type`] 
| This `typedef` is an alias for the character type `t_CHAR`.
| xref:BloombergLP/bslfmt/basic_format_context/formatter_type.adoc[`formatter_type`] 
| Alias for `bsl::formatter` specialized on `t_TYPE` and `t_CHAR`.
| xref:BloombergLP/bslfmt/basic_format_context/iterator.adoc[`iterator`] 
| This `typedef` is an alias for the output iterator type `t_OUT`.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bslfmt/basic_format_context/advance_to.adoc[`advance_to`] 
| Update the contained iterator to that specified by `it`.
| xref:BloombergLP/bslfmt/basic_format_context/arg-02.adoc[`arg`] 
| Return the formatting argument at zero‐based index `id`.
| xref:BloombergLP/bslfmt/basic_format_context/out.adoc[`out`] 
| Return (by value) the contained output iterator.
|===


== Friends

[cols="1,4"]
|===
| Name| Description
| `xref:BloombergLP/bslfmt/Format_ContextFactory.adoc[BloombergLP::bslfmt::Format_ContextFactory]`
| Utility factory for constructing `basic_format_context` objects.
|===


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