log4cpp::Category(3)

📦
version 1.1.4 · 4 versions
, in opensuse-leap 16.0

🌸 log4cpp::Category(3) — Library Functions Manual 🎀

okay bestie, gather round, because this is the page. like, the main character of the whole log4cpp library. no cap. this is log4cpp::Category(3), and she is everything. 💅

✨ NAME ✨

log4cpp::Category — this is the central class in the log4j package. that's it. that's the vibe. she's iconic, she's the hub, everyone reports to her. 👑

✨ SYNOPSIS ✨

#include <Category.hh>

Inherited by log4cpp::FixedContextCategory. (yes, she has a daughter. proud mom moment. 🥹)

💖 Public Member Functions

  • virtual ~Category () — Destructor for Category.
  • virtual const std::string & getName () const LOG4CPP_NOTHROW — Return the category name.
  • virtual void setPriority (Priority::Value priority) — Set the priority of this Category.
  • virtual Priority::Value getPriority () const LOG4CPP_NOTHROW — Returns the assigned Priority, if any, for this Category.
  • virtual Priority::Value getChainedPriority () const LOG4CPP_NOTHROW — Starting from this Category, search the category hierarchy for a set priority and return it.
  • virtual bool isPriorityEnabled (Priority::Value priority) const LOG4CPP_NOTHROW — Returns true if the chained priority of the Category is equal to or higher than given priority.
  • virtual void addAppender (Appender *appender) — Adds an Appender to this Category.
  • virtual void addAppender (Appender &appender) — Adds an Appender for this Category.
  • void setAppender (Appender *appender) — Adds an Appender to this Category.
  • void setAppender (Appender &appender) — Adds an Appender for this Category.
  • virtual Appender * getAppender () const — Returns the first Appender for this Category, or NULL if no Appender has been set.
  • virtual Appender * getAppender (const std::string &name) const — Returns the specified Appender for this Category, or NULL if the Appender is not attached to this Category.
  • virtual AppenderSet getAllAppenders () const — Returns the set of Appenders currently attached to this Catogory. (that spelling is hers, don't @ me 🫶)
  • virtual void removeAllAppenders () — Removes all appenders for this Category.
  • virtual void removeAppender (Appender *appender) — Removes specified appender for this Category.
  • virtual bool ownsAppender () const LOG4CPP_NOTHROW — Returns true if the Category owns the first Appender in its Appender set.
  • virtual bool ownsAppender (Appender *appender) const LOG4CPP_NOTHROW — Returns true if the Category owns the Appender.
  • virtual void callAppenders (const LoggingEvent &event) LOG4CPP_NOTHROW — Call the appenders in the hierarchy starting at this.
  • virtual void setAdditivity (bool additivity) — Set the additivity flag for this Category instance.
  • virtual bool getAdditivity () const LOG4CPP_NOTHROW — Returns the additivity flag for this Category instance.
  • virtual Category * getParent () LOG4CPP_NOTHROW — Returns the parent category of this category, or NULL if the category is the root category.
  • virtual const Category * getParent () const LOG4CPP_NOTHROW — Returns the parent category of this category, or NULL if the category is the root category. (yes twin, same energy, const version 💜)
  • virtual void log (Priority::Value priority, const char *stringFormat,...) LOG4CPP_NOTHROW — Log a message with the specified priority.
  • virtual void log (Priority::Value priority, const std::string &message) LOG4CPP_NOTHROW — Log a message with the specified priority.
  • virtual void logva (Priority::Value priority, const char *stringFormat, va_list va) LOG4CPP_NOTHROW — Log a message with the specified priority.
  • void debug (const char *stringFormat,...) LOG4CPP_NOTHROW — Log a message with debug priority.
  • void debug (const std::string &message) LOG4CPP_NOTHROW — Log a message with debug priority.
  • bool isDebugEnabled () const LOG4CPP_NOTHROW — Return true if the Category will log messages with priority DEBUG.
  • CategoryStream debugStream () — Return a CategoryStream with priority DEBUG.
  • void info (const char *stringFormat,...) LOG4CPP_NOTHROW — Log a message with info priority.
  • void info (const std::string &message) LOG4CPP_NOTHROW — Log a message with info priority.
  • bool isInfoEnabled () const LOG4CPP_NOTHROW — Return true if the Category will log messages with priority INFO.
  • CategoryStream infoStream () — Return a CategoryStream with priority INFO.
  • void notice (const char *stringFormat,...) LOG4CPP_NOTHROW — Log a message with notice priority.
  • void notice (const std::string &message) LOG4CPP_NOTHROW — Log a message with notice priority.
  • bool isNoticeEnabled () const LOG4CPP_NOTHROW — Return true if the Category will log messages with priority NOTICE.
  • CategoryStream noticeStream () — Return a CategoryStream with priority NOTICE.
  • void warn (const char *stringFormat,...) LOG4CPP_NOTHROW — Log a message with warn priority.
  • void warn (const std::string &message) LOG4CPP_NOTHROW — Log a message with warn priority.
  • bool isWarnEnabled () const LOG4CPP_NOTHROW — Return true if the Category will log messages with priority WARN.
  • CategoryStream warnStream () — Return a CategoryStream with priority WARN.
  • void error (const char *stringFormat,...) LOG4CPP_NOTHROW — Log a message with error priority.
  • void error (const std::string &message) LOG4CPP_NOTHROW — Log a message with error priority.
  • bool isErrorEnabled () const LOG4CPP_NOTHROW — Return true if the Category will log messages with priority ERROR.
  • CategoryStream errorStream () — Return a CategoryStream with priority ERROR.
  • void crit (const char *stringFormat,...) LOG4CPP_NOTHROW — Log a message with crit priority.
  • void crit (const std::string &message) LOG4CPP_NOTHROW — Log a message with crit priority.
  • bool isCritEnabled () const LOG4CPP_NOTHROW — Return true if the Category will log messages with priority CRIT.
  • CategoryStream critStream () — Return a CategoryStream with priority CRIT.
  • void alert (const char *stringFormat,...) LOG4CPP_NOTHROW — Log a message with alert priority.
  • void alert (const std::string &message) LOG4CPP_NOTHROW — Log a message with alert priority.
  • bool isAlertEnabled () const LOG4CPP_NOTHROW — Return true if the Category will log messages with priority ALERT.
  • CategoryStream alertStream () LOG4CPP_NOTHROW — Return a CategoryStream with priority ALERT.
  • void emerg (const char *stringFormat,...) LOG4CPP_NOTHROW — Log a message with emerg priority.
  • void emerg (const std::string &message) LOG4CPP_NOTHROW — Log a message with emerg priority.
  • bool isEmergEnabled () const LOG4CPP_NOTHROW — Return true if the Category will log messages with priority EMERG.
  • CategoryStream emergStream () — Return a CategoryStream with priority EMERG.
  • void fatal (const char *stringFormat,...) LOG4CPP_NOTHROW — Log a message with fatal priority.
  • void fatal (const std::string &message) LOG4CPP_NOTHROW — Log a message with fatal priority.
  • bool isFatalEnabled () const LOG4CPP_NOTHROW — Return true if the Category will log messages with priority FATAL.
  • CategoryStream fatalStream () — Return a CategoryStream with priority FATAL.
  • virtual CategoryStream getStream (Priority::Value priority) — Return a CategoryStream with given Priority.
  • virtual CategoryStream operator<< (Priority::Value priority) — Return a CategoryStream with given Priority.

💜 Static Public Member Functions

  • static Category & getRoot () — Return the root of the Category hierarchy.
  • static void setRootPriority (Priority::Value priority) — Set the priority of the root Category.
  • static Priority::Value getRootPriority () LOG4CPP_NOTHROW — Get the priority of the root Category.
  • static Category & getInstance (const std::string &name) — Instantiate a Category with name name.
  • static Category * exists (const std::string &name) — If the named category exists (in the default hierarchy) then it returns a reference to the category, otherwise it returns NULL.
  • static std::vector< Category * > * getCurrentCategories () — Returns all the currently defined categories as a vector of Category pointers.
  • static void shutdown () — This method will remove all Appenders from Categories.XXX.
  • static void shutdownForced () — This method will remove all Appenders from Categories.XXX and delete all appenders.

🦋 Protected Member Functions

  • Category (const std::string &name, Category *parent, Priority::Value priority=Priority::NOTSET) — Constructor.
  • virtual void _logUnconditionally (Priority::Value priority, const char *format, va_list arguments) LOG4CPP_NOTHROW
  • virtual void _logUnconditionally2 (Priority::Value priority, const std::string &message) LOG4CPP_NOTHROW — Unconditionally log a message with the specified priority.

🧚 Friends

  • class HierarchyMaintainer

🌈 Detailed Description

okay so. this is the central class in the log4j package. that's not me being dramatic, that's literally the description. she runs the whole thing. 👑

One of the distintive features of log4j (and hence log4cpp) are hierarchal categories and their evaluation. (yes, "distintive" — she said what she said, and we love her for it 🫶)

🎀 Constructor & Destructor Documentation

log4cpp::Category::~Category () [virtual]

Destructor for Category. she's logging off. say goodbye, bestie. 😭💔

log4cpp::Category::Category (const std::string & name, Category * parent, Priority::Value priority = Priority::NOTSET) [protected]

Constructor. the birth of a whole icon, tbh. ✨

Parameters

  • name — the fully qualified name of this Category
  • parent — the parent of this parent, or NULL for the root Category
  • priority — the priority for this Category. Defaults to Priority::NOTSET

💅 Member Function Documentation

void log4cpp::Category::_logUnconditionally (Priority::Value priority, const char * format, va_list arguments) [protected], [virtual]

void log4cpp::Category::_logUnconditionally2 (Priority::Value priority, const std::string & message) [protected], [virtual]

Unconditionally log a message with the specified priority. no vibe check, no filter, no nothing — it just goes. 🔥

Parameters

  • priority — The priority of this log message.
  • message — string to write in the log file

Reimplemented in log4cpp::FixedContextCategory.

void log4cpp::Category::addAppender (Appender & appender) [virtual]

Adds an Appender for this Category. This method does not pass ownership from the caller to the Category. (so like, you still own it, bestie — she's just borrowing 👀)

Since 0.2.7

Parameters

  • appender — The Appender this category has to log to.

Reimplemented in log4cpp::FixedContextCategory.

void log4cpp::Category::addAppender (Appender * appender) [virtual]

Adds an Appender to this Category. This method passes ownership from the caller to the Category. (now she owns it. it's hers now. full custody. 💅)

Since 0.2.7

Parameters

  • appender — The Appender to wich this category has to log. (yes, "wich". icon behaviour. 🎀)

Exceptions

  • std::invalid_argument if the appender is NULL. bestie do NOT pass her a null pointer, she WILL throw. 💀

Reimplemented in log4cpp::FixedContextCategory.

void log4cpp::Category::alert (const char * stringFormat, ...)

Log a message with alert priority.

Parameters

  • stringFormat — Format specifier for the string to write in the log file.
  • ... — The arguments for stringFormat

void log4cpp::Category::alert (const std::string & message)

Log a message with alert priority.

  • message — the string to write in the log file 📝

CategoryStream log4cpp::Category::alertStream () [inline]

Hands you a CategoryStream that's already set to priority ALERT 💅

Returns — the CategoryStream. That's it, that's the whole vibe.

void log4cpp::Category::callAppenders (const LoggingEvent & event) [virtual]

Calls the appenders up the hierarchy, starting right here at this category. And if it can't find a single appender? It emits a warning. 🫶

Heads up bestie, this one always calls all the appenders inherited from the hierarchy — it fully circumvents any evaluation of whether to log or not to log that particular log request. No vibe check, no filter, it just sends it. 🔥

Parameters

  • event — the LogginEvent to log. (yes, that spelling is in the source, we don't touch it ✨)

Reimplemented in log4cpp::FixedContextCategory.

void log4cpp::Category::crit (const char * stringFormat, ...)

Logs a message at crit priority. Iconic, dramatic, exactly what you want. 😭

Parameters

  • stringFormat — the format specifier for the string to write in the log file.
  • ... — the arguments for stringFormat.

void log4cpp::Category::crit (const std::string & message)

Same crit priority energy, but you're handing over a ready-made message. 🎀

Parameters

  • message — the string to write in the log file.

CategoryStream log4cpp::Category::critStream () [inline]

Gives you a CategoryStream with priority CRIT.

Returns — the CategoryStream. 💅

void log4cpp::Category::debug (const char * stringFormat, ...)

Logs a message at debug priority. For when you need to know everything. 🦋

Parameters

  • stringFormat — the format specifier for the string to write in the log file.
  • ... — the arguments for stringFormat.

void log4cpp::Category::debug (const std::string & message)

debug priority, but with a pre-built std::string message. 🌸

Parameters

  • message — the string to write in the log file.

CategoryStream log4cpp::Category::debugStream () [inline]

Returns a CategoryStream with priority DEBUG.

Returns — the CategoryStream. ✨

void log4cpp::Category::emerg (const char * stringFormat, ...)

Logs a message at emerg priority. Emergency mode, main character crisis, we're all here for it. 💀

Parameters

  • stringFormat — the format specifier for the string to write in the log file.
  • ... — the arguments for stringFormat.

void log4cpp::Category::emerg (const std::string & message)

emerg priority with a std::string message, no formatting required. 🍓

Parameters

  • message — the string to write in the log file.

CategoryStream log4cpp::Category::emergStream () [inline]

Returns a CategoryStream with priority EMERG.

Returns — the CategoryStream. 🚨

void log4cpp::Category::error (const char * stringFormat, ...)

Logs a message at error priority. Not great, not terrible, but definitely logged. 😭

Parameters

  • stringFormat — the format specifier for the string to write in the log file.
  • ... — the arguments for stringFormat.

void log4cpp::Category::error (const std::string & message)

error priority, with your message already assembled. 💜

Parameters

  • message — the string to write in the log file.

CategoryStream log4cpp::Category::errorStream () [inline]

Returns a CategoryStream with priority ERROR.

Returns — the CategoryStream. 🔥

Category * log4cpp::Category::exists (const std::string & name) [static]

Vibe check on a category name 👀 — if a category with that name exists in the default hierarchy, you get a reference to it. Otherwise? You get NULL. That's the whole deal, no cap.

Since — 0.2.7

void log4cpp::Category::fatal (const char * stringFormat, ...)

Logs a message at fatal priority. NB. priority fatal is equivalent to emerg. 💀

Since — 0.2.7

Parameters

  • stringFormat — the format specifier for the string to write in the log file.
  • ... — the arguments for stringFormat.

void log4cpp::Category::fatal (const std::string & message)

fatal priority, string-message edition. NB. priority fatal is equivalent to emerg. 😭

Since — 0.2.7

Parameters

  • message — the string to write in the log file.

CategoryStream log4cpp::Category::fatalStream () [inline]

Returns a CategoryStream with priority FATAL. NB. priority fatal is equivalent to emerg. 🫶

Since — 0.2.7

Returns — the CategoryStream.

bool log4cpp::Category::getAdditivity () const [virtual]

Returns the additivity flag for this Category instance. Has it inherited its parents' appenders or is it going solo? This tells you. ✨

Reimplemented in log4cpp::FixedContextCategory.

AppenderSet log4cpp::Category::getAllAppenders () const [virtual]

Returns the set of Appenders currently attached to this Catogory. (that typo is canon, bestie, we keep it 💅)

Since — 0.3.1

Returns — the set of attached Appenders.

Reimplemented in log4cpp::FixedContextCategory.

Appender * log4cpp::Category::getAppender () const [virtual]

Returns the first Appender for this Category, or NULL if no Appender has been set. 🦋

Deprecated — use getAppender(const std::string&) instead. Don't be that girl still calling the deprecated one, ok? 🥲

Returns — the Appender.

Reimplemented in log4cpp::FixedContextCategory.

Appender * log4cpp::Category::getAppender (const std::string & name) const [virtual]

Returns the Appender you asked for by name, or NULL if that Appender isn't attached to this Category. The respectful, non-deprecated way to do it. 👑

Since — 0.2.7

Returns — the Appender.

Reimplemented in log4cpp::FixedContextCategory.

Priority::Value log4cpp::Category::getChainedPriority () const [virtual]

Starts at this Category and walks up the category hierarchy looking for a set priority, then returns it. Nothing set anywhere? Then you get the priority of the root category. 🌈

And like — the Category class is literally designed so this method executes as quickly as possible. Speed. Main character efficiency. ⭐

Reimplemented in log4cpp::FixedContextCategory.

std::vector< Category * > * log4cpp::Category::getCurrentCategories () [static]

Returns every currently defined category as a vector of Category pointers. 📋

Read this part carefully, bestie, it's giving ownership rules 🔥: this function does not pass ownership of the categories in the vector to the caller — only the ownership of the vector. But vector<Category&>* isn't legal C++, so the default ownership conventions couldn't be followed. Sad but true. 😭

And unlike in log4j, the root category is included in the returned set. Don't forget it. 🎀

Since — 0.3.2. Before 0.3.2 this method returned a std::set.

Category & log4cpp::Category::getInstance (const std::string & name) [static]

Instantiates a Category named name. ✨ Important: this method does not set the priority of the category — it's Priority::NOTSET by default. It's a whole not-set situation. 💅

Parameters

  • name — the name of the category to retrieve.

const std::string & log4cpp::Category::getName () const [virtual]

Returns the category name. Identity! 🪞

Returns — the category name.

const Category * log4cpp::Category::getParent () const [virtual]

Returns the parent category of this category, or NULL if this category is the root category. 👑 (root has no parent — it's the parent)

Returns — the parent category.

Category * log4cpp::Category::getParent () [virtual]

The non-const twin 🫶 — returns the parent category of this category, or NULL if this category is the root category.

Returns — the parent category.

Priority::Value log4cpp::Category::getPriority () const [virtual]

Returns the priority that's been assigned to this Category, if there is one. 🎀

Returns — Priority, the assigned Priority. And yes, it can be Priority::NOTSET.

Reimplemented in log4cpp::FixedContextCategory.

Category & log4cpp::Category::getRoot () [static]

Returns the root of the Category hierarchy. The root category is always instantiated and available, no setup needed. Its name is the empty string. 🫥

And here's the log4j difference that lives rent free in my head: unlike in log4j, calling Category.getInstance("") does retrieve the root category — it does not give you a category just under root named "". ✨

Returns — the root category.

Priority::Value log4cpp::Category::getRootPriority () [static]

Gets the priority of the root Category. 👑

Returns — the priority of the root category.

CategoryStream log4cpp::Category::getStream (Priority::Value priority) [virtual]

Returns a CategoryStream with whatever priority you hand it. Build-your-own-stream energy. 🦋

Parameters

  • priority — the Priority of the CategoryStream.

Returns — the requested CategoryStream.

void log4cpp::Category::info (const char * stringFormat, ...)

Logs a message at info priority. The bread and butter. 🍞

Parameters

  • stringFormat — the format specifier for the string to write in the log file.
  • ... — the arguments for stringFormat.

void log4cpp::Category::info (const std::string & message)

info priority, with a std::string you already made. 🌸

Parameters

  • message — the string to write in the log file.

CategoryStream log4cpp::Category::infoStream () [inline]

Returns a CategoryStream with priority INFO.

Returns — the CategoryStream. 💜

bool log4cpp::Category::isAlertEnabled () const [inline]

Returns true if the Category will log messages with priority ALERT. 🚨

Returns — whether the Category will log.

bool log4cpp::Category::isCritEnabled () const [inline]

Returns true if the Category will log messages with priority CRIT. 😭

Returns — whether the Category will log.

bool log4cpp::Category::isDebugEnabled () const [inline]

Returns true if the Category will log messages with priority DEBUG. 🦋

Returns — whether the Category will log.

bool log4cpp::Category::isEmergEnabled () const [inline]

Returns true if the Category will log messages with priority EMERG. 💀

Returns — whether the Category will log.

bool log4cpp::Category::isErrorEnabled () const [inline]

Returns true if the Category will log messages with priority ERROR. 🔥

Returns — whether the Category will log.

bool log4cpp::Category::isFatalEnabled () const [inline]

Returns true if the Category will log messages with priority FATAL. NB. priority fatal is equivalent to emerg. 💀

Since — 0.2.7

Returns — whether the Category will log.

bool log4cpp::Category::isInfoEnabled () const [inline]

Returns true if the Category will log messages with priority INFO. ✨

Returns — whether the Category will log.

bool log4cpp::Category::isNoticeEnabled () const [inline]

Returns true if the Category will log messages with priority NOTICE. 🎀

Returns — whether the Category will log.

bool log4cpp::Category::isPriorityEnabled (Priority::Value priority) const [virtual]

Returns true if the chained priority of the Category is equal to or higher than the priority you passed in. 🫶

Parameters

  • priority — the priority to compare with.

Returns — whether logging is enable for this priority. (yep, "enable", that's the source's word, we respect it 💅)

bool log4cpp::Category::isWarnEnabled () const [inline]

Returns true if the Category will log messages with priority WARN. 🌈

Returns — whether the Category will log.

void log4cpp::Category::log (Priority::Value priority, const char * stringFormat, ...) [virtual]

Logs a message with the priority you specify — you're driving. 🔥

Parameters

  • priority — the priority of this log message.
  • stringFormat — the format specifier for the string to write in the log file.
  • ... — the arguments for stringFormat.

void log4cpp::Category::log (Priority::Value priority, const std::string & message) [virtual]

Logs a message with the priority you specify, pre-formatted string style. 🎀

Parameters

  • priority — the priority of this log message.
  • message — the string to write in the log file.

void log4cpp::Category::logva (Priority::Value priority, const char * stringFormat, va_list va) [virtual]

Logs a message with the priority you specify, va_list flavour — the one you use when you're already inside a variadic function and need to forward the args. 🧚

Since — 0.2.7

Parameters

  • priority — the priority of this log message, obvs. It's what decides whether the message actually makes it out alive 🫶
  • stringFormat — the format specifier for the string that gets written into the log file. Your template, bestie ✨
  • va — the arguments for stringFormat. All the lil fill-ins 🎀

notice, notice, noticeStream 🌸

  • void log4cpp::Category::notice (const char * stringFormat, ...) — logs a message with notice priority.
    • stringFormat — format specifier for the string to write in the log file.
    • ... — the arguments for stringFormat.
  • void log4cpp::Category::notice (const std::string & message) — logs a message with notice priority.
    • message — the string to write in the log file.
  • CategoryStream log4cpp::Category::noticeStream () [inline] — hands you back a CategoryStream with priority NOTICE.
    • Returns — the CategoryStream. That's it, that's the whole vibe 🦋

operator<< 💅

  • CategoryStream log4cpp::Category::operator<< (Priority::Value priority) [virtual] — returns a CategoryStream with whatever Priority you hand it. It's virtual, so it's giving main character energy in the inheritance department 👑
    • priority — the Priority of the CategoryStream.
    • Returns — the requested CategoryStream.

ownsAppender (the messy one) 😭

  • virtual bool log4cpp::Category::ownsAppender () const [inline], [virtual] — returns true if the Category owns the first Appender in its Appender set. In that case the Category destructor will delete the Appender. No cap, that's the whole deal.
Deprecated — use ownsAppender(Appender*) instead. Like, please. The no-arg version is so 1.0 🙈
  • Reimplemented in log4cpp::FixedContextCategory.
  • bool log4cpp::Category::ownsAppender (Appender * appender) const [virtual] — returns true if the Category owns the Appender (the one you point at). In that case the Category destructor will delete the Appender. This is the glow-up version, use this one 🫶
    • Since — 0.2.7
    • Reimplemented in log4cpp::FixedContextCategory.

removeAllAppenders & removeAppender ✨

  • void log4cpp::Category::removeAllAppenders () [virtual] — removes all appenders for this Category. Yeet, gone, every single one 💀
    • Reimplemented in log4cpp::FixedContextCategory.
  • void log4cpp::Category::removeAppender (Appender * appender) [virtual] — removes the specified appender for this Category. Just the one. Targeted yeet 🎯
    • Since — 0.2.7

setAdditivity 🧚

  • void log4cpp::Category::setAdditivity (bool additivity) [virtual] — sets the additivity flag for this Category instance. It's virtual, it's iconic, it's fine.
    • Reimplemented in log4cpp::FixedContextCategory.

setAppender, setAppender (yes, both, and yes, both deprecated) 💀

  • void log4cpp::Category::setAppender (Appender & appender) [inline] — adds an Appender for this Category. Heads up: this method does not pass ownership from the caller to the Category. You keep the keys, bestie 🔑
Deprecated — use addAppender(Appender&) instead.
  • appender — the Appender this category has to log to.
  • void log4cpp::Category::setAppender (Appender * appender) [inline] — adds an Appender to this Category. This one does pass ownership from the caller to the Category. So like, be sure you meant that 🙈
Deprecated — use addAppender(Appender*) or removeAllAppenders() instead.
  • appender — the Appender this category has to log to or NULL to remove the current Appenders.

setPriority 🔥

  • void log4cpp::Category::setPriority (Priority::Value priority) [virtual] — sets the priority of this Category.
    • priority — the priority to set. Use Priority::NOTSET to let the category use its parent's priority as its effective priority. Inheritance slay ✨
    • Exceptions — std::invalid_argument if the caller tries to set Priority::NOTSET on the Root Category.
Fr fr, do not try to set Priority::NOTSET on the Root Category. The Root has no parent to borrow a priority from, so it just throws std::invalid_argument at you 😭

setRootPriority ⭐

  • void log4cpp::Category::setRootPriority (Priority::Value priority) [static] — sets the priority of the root Category. Static, so you call it on the class, not on an instance. Big main-character-of-the-whole-hierarchy energy 👑
    • priority — the new priority for the root Category.

shutdown & shutdownForced 🧨

  • void log4cpp::Category::shutdown () [static] — this method will remove all Appenders from Categories.XXX.
  • void log4cpp::Category::shutdownForced () [static] — this method will remove all Appenders from Categories.XXX and delete all appenders. It releases more memory than shutdown() by deleting the appenders. So, like — the nuclear option, but in a cute, memory-clean way 💅

warn, warn, warnStream 🌈

  • void log4cpp::Category::warn (const char * stringFormat, ...) — logs a message with warn priority.
    • stringFormat — format specifier for the string to write in the log file.
    • ... — the arguments for stringFormat.
  • void log4cpp::Category::warn (const std::string & message) — logs a message with warn priority.
    • message — the string to write in the log file.
  • CategoryStream log4cpp::Category::warnStream () [inline] — returns a CategoryStream with priority WARN.
    • Returns — the CategoryStream. Stream it, bestie 🍓
  • friend class HierarchyMaintainer [friend] — yeah, they're a friend of the class. That's the whole entry. Keep it in the group chat 💜

✨ Author ✨

Generated automatically by Doxygen for log4cpp from the source code. Like, nobody hand-wrote this and that's honestly iconic of Doxygen 🎀

And that's a wrap, bestie! This little masterpiece is from log4cpp, Version 1.1, and you're reading log4cpp::Category(3) — go forth and log responsibly 💖✨👑

📦 where this page comes from