[#fmt-join-08]
= xref:fmt.adoc[fmt]::join
:relfileprefix: ../
:mrdocs:

Returns an object that formats `std::tuple` with elements separated by `sep`.

== Synopsis

Declared in `<fmt/ranges.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<typename Tuple>
constexpr
xref:fmt/tuple_join_view.adoc[tuple_join_view<Tuple, char>]
join(
    Tuple const& tuple,
    xref:fmt/string_view.adoc[string_view] sep);
----

== Description

*Example*:

auto t = std::tuple<int, char>(1, 'a'); fmt::print("{}", fmt::join(t, ", ")); // Output: 1, a

== Return Value

an object that formats `std::tuple` with elements separated by `sep`.


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