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

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

== Synopsis

Declared in `<fmt/ranges.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<typename T>
[[deprecated]]
xref:fmt/join_view.adoc[join_view<T const*, T const*>]
join(
    std::initializer_list<T> list,
    xref:fmt/string_view.adoc[string_view] sep);
----

[WARNING]
====
https://en.cppreference.com/cpp/language/attributes/deprecated[Deprecated^]. Use of this entity is allowed but discouraged.
====
== Description

*Example*:

fmt::print("{}", fmt::join({1, 2, 3}, ", ")); // Output: "1, 2, 3"


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