std::locale::facet(3)

💖 std::locale::facet(3) — Library Functions Manual, bestie 💖

okay so we're in section 3 of the Library Functions Manual and today's main character is std::locale::facet. it's the localization functionality base class and honestly? it's giving foundation. it's giving "everyone else stands on my shoulders." let's get into it 🫶

---

🌸 NAME 🌸

std::locale::facet — Localization functionality base class. periodt.

---

✨ SYNOPSIS ✨

#include <locale>

🦋 Inherited by

bestie the inheritance list is LONG. like, long long. buckle up:

• std::__codecvt_abstract_base< _InternT, _ExternT, encoding_state >
• std::__codecvt_abstract_base< char, char, mbstate_t >
• std::__codecvt_abstract_base< char16_t, char, mbstate_t >
• std::__codecvt_abstract_base< char32_t, char, mbstate_t >
• std::__codecvt_abstract_base< wchar_t, char, mbstate_t >
• std::__codecvt_abstract_base< _Elem, char, mbstate_t >
• std::mask< _CharT >
• std::__ctype_abstract_base< wchar_t >
• std::num_get< _CharT, istreambuf_iterator< _CharT, _Traits > >
• std::num_put< _CharT, ostreambuf_iterator< _CharT, _Traits > >
• std::__codecvt_abstract_base< _InternT, _ExternT, _StateT >
• std::__ctype_abstract_base< _CharT >
• std::__cxx11::collate< _CharT >
• , , , ,
• std::ctype< char >
• std::messages< _CharT >
• std::money_get< _CharT, _InIter >
• std::money_put< _CharT, _OutIter >
• std::moneypunct< _CharT, _Intl >
• and std::num_get< _CharT, _InIter >

not me pointing out that there are literally four blank entries chilling in the middle of that list like , , , , 💀 that's not a typo on my part, that's just what the page says. iykyk.

🔒 Protected Member Functions

• facet (const facet &)=delete — nope. not allowed. deleted.
• facet (size_t __refs=0) throw () — Facet constructor.
• virtual ~facet () — Facet destructor.
• facet & operator= (const facet &)=delete — also nope. also deleted.

🧚 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)

💜 Friends

• class locale
• class locale::_Impl

---

👑 Detailed Description 👑

Localization functionality base class.

The facet class is the base class for a localization feature, such as money, time, and number printing. It provides common support for facets and reference management.

🚨 Facets may not be copied or assigned. like, at all. don't even try it, bestie, the compiler will simply say no.

---

🎀 Constructor & Destructor Documentation 🎀

std::locale::facet::facet (size_t __refs = 0) [inline], [explicit], [protected]

Facet constructor. This is the constructor provided by the standard. If refs is 0, the facet is destroyed when the last referencing locale is destroyed. Otherwise the facet will never be destroyed.

Parameters

• __refs — The initial value for reference count.

Referenced by

• std::__cxx11::collate< _CharT >::collate()
• std::__cxx11::collate< _CharT >::collate()
• std::messages< _CharT >::messages()
• std::messages< _CharT >::messages()
• std::money_get< _CharT, _InIter >::money_get()
• std::money_put< _CharT, _OutIter >::money_put()
• std::moneypunct< _CharT, _Intl >::moneypunct()
• std::moneypunct< _CharT, _Intl >::moneypunct()
• std::moneypunct< _CharT, _Intl >::moneypunct()
• std::num_get< _CharT, istreambuf_iterator< _CharT, _Traits > >::num_get()
• std::num_put< _CharT, ostreambuf_iterator< _CharT, _Traits > >::num_put()
• std::numpunct< _CharT >::numpunct()
• std::numpunct< _CharT >::numpunct()
• std::numpunct< _CharT >::numpunct()
• std::time_get< _CharT, _InIter >::time_get()
• std::time_put< _CharT, _OutIter >::time_put()
• and ~facet()

(yes bestie, several of those appear more than once. that's literally what the page says. no i will not be fixing it, i am not the compiler 🫶)

virtual std::locale::facet::~facet () [protected], [virtual]

Facet destructor.

References facet().

---

🌈 Author 🌈

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

---

and that's the whole page, bestie! this absolute icon of a manpage comes to you straight from libstdc++, auto-generated by Doxygen for libstdc++ from the source code 💅✨ no cap, that's the sign-off — go forth and let your facets reference-count responsibly. mwah! 🦋💖🎀