std::experi...tagged_tuple(3)

okay bestie, welcome to std::experi...tagged_tuple(3) from the C++ Standard Libary — yes, that's the manual name, typo and all, and we're keeping it 💅✨

🌸 NAME 🌸

• std::experimental::ranges::tagged_tuple — the name is literally std::experimental::ranges::tagged_tuple, and the original name line is std::experimental::ranges::tagged_tuple - std::experimental::ranges::tagged_tuple. slay, that's the whole name moment 🫶

✨ Synopsis ✨

the synopsis is giving:

Defined in header <experimental/ranges/tuple>
template< TaggedType... Types >                (ranges TS)
using tagged_tuple = /* see below */;

It's the convenience alias template for naming a ranges::tagged wrapping a std::tuple.

A TaggedType is a function type S(T), where S is a TagSpecifier and T is the type of the element.

So tagged_tuple<S1(T1), ..., SN(TN)> is an alias for ranges::tagged<std::tuple<T1, ..., TN>, S1, ..., SN>. periodt 💖

💖 Notes 💖

Because a function type is used to “glue” the tag specifier and the corresponding element type together, the usual parameter type adjustments apply. In particular, top-level cv-qualifiers are removed and array types are adjusted to pointers:

tagged_tuple<tag::in(const int* const), tag::out(int[])> is
ranges::tagged<std::tuple<const int*, int*>, tag::in, tag::out>.

that's the example, bestie — keep those consts exactly where they are 👀✨

🌈 See also 🌈

• TaggedType — specifies that a type represents a tag specifier and its element type (concept)
• tagged — augument a tuple-like type with named accessors (class template)
• tagged_pair — alias template for a tagged std::pair (alias template)
• make_tagged_pair — convenience function for creating a tagged_pair (function template)
• make_tagged_tuple — convenience function for creating a tagged_tuple (function template)

and the tag-specifier block from the original see-also section goes exactly like this:

in
in1
in2
out
out1              tag specifiers for use with ranges::tagged
out2              (class)
fun
min
max
begin
end

the original really says augument for tagged — typo and all, we keep it, because facts don't change even when spelling is iconic 💀💅

that's the whole page, bestie 💖 source/version + date vibes: this one's from http://cppreference.com, dated 2024.06.10, and it's literally std::experi...tagged_tuple(3). go forth and tag those tuples 🎀🦋