[#tinyformat-formatValue-07]
= xref:tinyformat.adoc[tinyformat]::formatValue
:relfileprefix: ../
:mrdocs:

`formatValue` overloads

== Synopses

Declared in `&lt;util&sol;fs&period;h&gt;`

Format a `char` value, printing as an integer when an integer conversion is requested&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
formatValue(
    std::ostream& out,
    char const*,
    char const* fmtEnd,
    int,
    char value);
----

[.small]#[_» more&period;&period;&period;_]#

Format a `signed char` value, printing as an integer when an integer conversion is requested&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
formatValue(
    std::ostream& out,
    char const*,
    char const* fmtEnd,
    int,
    signed char value);
----

[.small]#[_» more&period;&period;&period;_]#

Format an `unsigned char` value, printing as an integer when an integer conversion is requested&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
formatValue(
    std::ostream& out,
    char const*,
    char const* fmtEnd,
    int,
    unsigned char value);
----

[.small]#[_» more&period;&period;&period;_]#

Format a value into a stream, delegating to operator&lt;&lt; by default&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;typename T&gt;
void
xref:tinyformat/formatValue-05.adoc[formatValue](
    std::ostream& out,
    char const* fmtBegin,
    char const* fmtEnd,
    int ntrunc,
    T const& value);
----

[.small]#xref:tinyformat/formatValue-05.adoc[_» more&period;&period;&period;_]#

Deleted specialization that forbids formatting a std&colon;&colon;filesystem&colon;&colon;path, which encodes locale&hyphen;dependently on Windows&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;&gt;
void
formatValue&lt;path&gt;(
    std::ostream&,
    char const*,
    char const*,
    int,
    std::filesystem::path const&) = delete;
----

[.small]#[_» more&period;&period;&period;_]#

Deleted specialization that forbids formatting an fs&colon;&colon;path, which encodes locale&hyphen;dependently on Windows&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;&gt;
void
formatValue&lt;path&gt;(
    std::ostream&,
    char const*,
    char const*,
    int,
    xref:fs/path.adoc[fs::path] const&) = delete;
----

[.small]#[_» more&period;&period;&period;_]#

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| Stream to write the formatted value to&period;
| *fmtBegin*
| Pointer to the first character of the format specification&period;
| *fmtEnd*
| Pointer past the last character of the format specification&period;
| *ntrunc*
| Maximum number of characters to emit for truncating conversions, or negative for none&period;
| *value*
| Value to format&period;
|===


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