STD::MESSAGES_BYNAME(3)

📦
version 16.2.1+r23+gd564253eb6c8 · 8 versions
, in arch rolling, fedora 44

💖 NAME 💖

okay bestie, gather round, because today we're meeting std::messages_byname< _CharT > — it's the class messages_byname, and yes that's its whole government name, section [22.2.7.2] in the standard, no cap. ✨

🦋 SYNOPSIS 🦋

#include <locale>

and also, real quick, it inherits from std::messages< _CharT > — so everything that facet does, this one's doing it too. family trait moment 👑

🌸 Public Types 🌸

  • typedef int catalog — the type it uses to keep track of catalogs, it's literally just an int
  • typedef _CharT char_type — the character type, whatever _CharT is, that's what she is
  • typedef basic_string< _CharT > string_type — a string of those characters, iconic

🎀 Public Member Functions 🎀

  • messages_byname (const char *__s, size_t __refs=0) — construct her from a C string name
  • messages_byname (const string &__s, size_t __refs=0) — and also from a string name, we love options
  • void close (catalog __c) const — closes a catalog
  • string_type get (catalog __c, int __set, int __msgid, const string_type &__s) const — fetches a message out of a catalog
  • catalog open (const basic_string< char > &, const locale &, const char *) const — opens a catalog, three-argument flavor
  • catalog open (const basic_string< char > &__s, const locale &__loc) const — and the two-argument flavor, __s and __loc

⭐ Static Public Attributes ⭐

  • static locale::id id — and the docs literally describe it as the Numpunct facet id. yes bestie, that's what it says. we're just relaying the message 💅

💜 Protected Member Functions 💜

  • string_type _M_convert_from_char (char *) const
  • char * _M_convert_to_char (const string_type &__msg) const
  • virtual void do_close (catalog) const
  • void do_close (catalog) const
  • void do_close (catalog) const — yep. three of them. the same signature, listed three times. not me questioning the docs, just reporting 🫶
  • string do_get (catalog, int, int, const string &) const — described as "Specializations for required instantiations."
  • virtual string_type do_get (catalog, int, int, const string_type &__dfault) const
  • wstring do_get (catalog, int, int, const wstring &) const
  • virtual catalog do_open (const basic_string< char > &, const locale &) const
  • messages< wchar_t >::catalog do_open (const basic_string< char > &, const locale &) const
  • messages< char >::catalog do_open (const basic_string< char > &, const locale &) const

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

🍓 Protected Attributes 🍓

  • __c_locale _M_c_locale_messages
  • const char * _M_name_messages

✨ DETAILED DESCRIPTION ✨

template<typename _CharT>
class std::messages_byname< _CharT >

and the description is, and I quote, "class messages_byname [22.2.7.2]. — she's a template over _CharT, that's the whole vibe. 🔥

💅 MEMBER FUNCTION DOCUMENTATION 💅

  • string std::messages< char >::do_get (catalog , int , int , const string & ) const [protected], [inherited] — note the [protected] and [inherited] tags, she got this from her parent. and the note: "Specializations for required instantiations."

👑 MEMBER DATA DOCUMENTATION 👑

  • template<typename _CharT> locale::id std::messages< _CharT >::id [static], [inherited] — static, inherited, and described as the Numpunct facet id. it's giving mysterious but okay 😭

🌈 AUTHOR 🌈

Generated automatically by Doxygen for libstdc++ from the source code. so like… no human wrote this, a robot did, and honestly? it ate. 🤖✨

mwah bestie, that's the whole page 💖 this gem comes to you straight from libstdc++ — that's the source and the version, slay — and the footer's std::messa...< _CharT >(3) manual tag, which is just the truncated name being cute about it. stay locale-aware, drink water, and always close your catalogs 🫶🌸

📦 where this page comes from
  • arch rolling: gcc 16.2.1+r23+gd564253eb6c8-1 · GPL-3.0-or-later WITH GCC-exception-3.1 AND GFDL-1.3-or-later
  • fedora 44: libstdc++-docs 16.0.1-0.10.fc44 · GPL-3.0-or-later AND LGPL-3.0-or-later AND (GPL-3.0-or-later WITH GCC-exception-3.1) AND (GPL-3.0-or-later WITH Texinfo-exception) AND (LGPL-2.1-or-later WITH GCC-exception-2.0) AND (GPL-2.0-or-later WITH GCC-exception-2.0) AND (GPL-2.0-or-later WITH GNU-compiler-exception) AND BSL-1.0 AND GFDL-1.3-or-later AND Linux-man-pages-copyleft-2-para AND SunPro AND BSD-1-Clause AND BSD-2-Clause AND BSD-2-Clause-Views AND BSD-3-Clause AND BSD-4-Clause AND BSD-Source-Code AND Zlib AND MIT AND Apache-2.0 AND (Apache-2.0 WITH LLVM-Exception) AND ZPL-2.1 AND ISC AND LicenseRef-Fedora-Public-Domain AND HP-1986 AND curl AND Martin-Birgmeier AND HPND-Markus-Kuhn AND dtoa AND SMLNJ AND AMD-newlib AND OAR AND HPND-merchantability-variant AND HPND-Intel
  • fedora 44: libstdc++-docs 16.2.1-2.fc44
  • fedora 44: libstdc++-docs 16.2.1-3.fc44 · GPL-3.0-or-later AND LGPL-3.0-or-later AND (GPL-3.0-or-later WITH GCC-exception-3.1) AND (GPL-3.0-or-later WITH Texinfo-exception) AND (LGPL-2.1-or-later WITH GCC-exception-2.0) AND (GPL-2.0-or-later WITH GCC-exception-2.0) AND (GPL-2.0-or-later WITH GNU-compiler-exception) AND BSL-1.0 AND GFDL-1.3-or-later AND Linux-man-pages-copyleft-2-para AND SunPro AND BSD-1-Clause AND BSD-2-Clause AND BSD-2-Clause-Views AND BSD-3-Clause AND BSD-4-Clause AND BSD-Source-Code AND Zlib AND MIT AND Apache-2.0 AND (Apache-2.0 WITH LLVM-Exception) AND ZPL-2.1 AND ISC AND LicenseRef-Fedora-Public-Domain AND HP-1986 AND curl AND Martin-Birgmeier AND HPND-Markus-Kuhn AND dtoa AND SMLNJ AND AMD-newlib AND OAR AND HPND-merchantability-variant AND HPND-Intel
  • 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms