STD::TIME_PUT_BYNAME(3cxx)

okay bestie, welcome to the 3cxx manual page for std::time_put_byname< _CharT, _OutIter > — yes, the whole template situation. ✨ We’re keeping every detail, no cap.

💅 NAME 💅

std::time_put_byname< _CharT, _OutIter > - class time_put_byname [22.2.5.4].

That’s the name entry, and yes the [22.2.5.4]. is part of it. Periodt.

✨ SYNOPSIS ✨

Start here, bestie:

#include <locale>

Inherits std::time_put< _CharT, _OutIter >. That’s the parent vibe.

🌸 Public Types 🌸

• typedef _CharT char_type
• typedef _OutIter iter_type

💖 Public Member Functions 💖

• time_put_byname (const char *, size_t __refs=0)
• time_put_byname (const string &__s, size_t __refs=0)
• iter_type put (iter_type __s, ios_base &__io, char_type __fill, const tm *__tm, char __format, char __mod=0) const — Format and output a time or date.
• iter_type put (iter_type __s, ios_base &__io, char_type __fill, const tm *__tm, const _CharT *__beg, const _CharT *__end) const — Format and output a time or date.

🦋 Static Public Attributes 🦋

• static locale::id id — Numpunct facet id.

The docs literally call it Numpunct facet id. and I’m not touching it. Copy/paste sacred.

🎀 Protected Member Functions 🎀

• virtual iter_type do_put (iter_type __s, ios_base &__io, char_type __fill, const tm *__tm, char __format, char __mod) const — Format and output a time or date.

🧚 Static Protected Member Functions 🧚

• static __c_locale _S_clone_c_locale (__c_locale &__cloc) throw ()
• static void _S_create_c_locale (__c_locale &__cloc, const char *__s, __c_locale __old=0)
• static void _S_destroy_c_locale (__c_locale &__cloc)
• static __c_locale _S_get_c_locale ()
• static const char * _S_get_c_name () throw ()
• static __c_locale _S_lc_ctype_c_locale (__c_locale __cloc, const char *__s)

😭 Detailed Description 😭

Here’s the template situation in code, exactly:

template<typename _CharT, typename _OutIter>
    class std::time_put_byname< _CharT, _OutIter >"class time_put_byname [22.2.5.4].

Notice the quote after the >? That’s in the original, so it stays. Details are sacred, periodt. 💅

🔥 Member Function Documentation 🔥

💅 do_put — the protected virtual one

Full signature, with all the labels:

template<typename _CharT , typename _OutIter > _OutIter std::time_put< _CharT, _OutIter >::do_put (iter_type __s, ios_base & __io, char_type __fill, const tm * __tm, char __format, char __mod) const [protected], [virtual],  [inherited]

Format and output a time or date. This function formats the data in struct tm according to the provided format char and optional modifier. This function is a hook for derived classes to change the value returned.

👀 See also

put() for more details.

🍓 Parameters

• __s — The stream to write to.
• __io — Source of locale.
• __fill — char_type to use for padding.
• __tm — Struct tm with date and time info to format.
• __format — Format char.
• __mod — Optional modifier char.

Returns: Iterator after writing.

References: std::ios_base::_M_getloc(), and std::__ctype_abstract_base< _CharT >::widen().

Referenced by: std::time_put< _CharT, _OutIter >::put().

✨ put — format char + modifier overload

template<typename _CharT , typename _OutIter > iter_type std::time_put< _CharT, _OutIter >::put (iter_type __s, ios_base & __io, char_type __fill, const tm * __tm, char __format, char __mod = 0) const [inline], [inherited]

Format and output a time or date. This function formats the data in struct tm according to the provided format char and optional modifier. The format and modifier are interpreted as by strftime(). It does so by returning time_put::do_put().

🍓 Parameters

• __s — The stream to write to.
• __io — Source of locale.
• __fill — char_type to use for padding.
• __tm — Struct tm with date and time info to format.
• __format — Format char.
• __mod — Optional modifier char.

Returns: Iterator after writing.

References: std::time_put< _CharT, _OutIter >::do_put().

🦋 put — format string range overload

template<typename _CharT , typename _OutIter > _OutIter std::time_put< _CharT, _OutIter >::put (iter_type __s, ios_base & __io, char_type __fill, const tm * __tm, const _CharT * __beg, const _CharT * __end) const [inherited]

Format and output a time or date. This function formats the data in struct tm according to the provided format string. The format string is interpreted as by strftime().

🍓 Parameters

• __s — The stream to write to.
• __io — Source of locale.
• __fill — char_type to use for padding.
• __tm — Struct tm with date and time info to format.
• __beg — Start of format string.
• __end — End of format string.

Returns: Iterator after writing.

References: std::ios_base::_M_getloc(), and std::__ctype_abstract_base< _CharT >::narrow().

👑 Member Data Documentation 👑

💀 the static id

template<typename _CharT , typename _OutIter > locale::id std::time_put< _CharT, _OutIter >::id [static],  [inherited]

Numpunct facet id.

Again: the docs say Numpunct facet id. Keep it, don’t fix it. 😭

🫶 Author 🫶

Generated automatically by Doxygen for libstdc++ from the source code.

---

Source/version vibes: libstdc++; manual: 3cxx; date: the footer didn’t list one, so I’m not inventing one — no cap, facts only. Mwah 💋