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

`formatValue` overloads

== Synopses

Declared in `<util/fs.h>`

Format a `char` value, printing as an integer when an integer conversion is requested.


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

[.small]#[_» more..._]#

Format a `signed char` value, printing as an integer when an integer conversion is requested.


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

[.small]#[_» more..._]#

Format an `unsigned char` value, printing as an integer when an integer conversion is requested.


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

[.small]#[_» more..._]#

Format a value into a stream, delegating to operator<< by default.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<typename T>
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..._]#

Deleted specialization that forbids formatting a std::filesystem::path, which encodes locale‐dependently on Windows.


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

[.small]#[_» more..._]#

Deleted specialization that forbids formatting an fs::path, which encodes locale‐dependently on Windows.


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

[.small]#[_» more..._]#

== Parameters

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


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