<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.3.1"/> <title>log4c: category.h File Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">log4c  <span id="projectnumber">1.2.4</span> </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.3.1 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>Globals</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_6ba53b81c010ccbbf4e80737d395d27b.html">log4c</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="summary"> <a href="#define-members">Macros</a> | <a href="#typedef-members">Typedefs</a> | <a href="#func-members">Functions</a> </div> <div class="headertitle"> <div class="title">category.h File Reference</div> </div> </div><!--header--> <div class="contents"> <p>central class in the log4c package. <a href="#details">More...</a></p> <div class="textblock"><code>#include <stdio.h></code><br/> <code>#include <stdarg.h></code><br/> <code>#include <log4c/defs.h></code><br/> <code>#include <<a class="el" href="priority_8h_source.html">log4c/priority.h</a>></code><br/> <code>#include <<a class="el" href="location__info_8h_source.html">log4c/location_info.h</a>></code><br/> </div><div class="textblock"><div class="dynheader"> Include dependency graph for category.h:</div> <div class="dyncontent"> <div class="center"><img src="category_8h__incl.png" border="0" usemap="#category_8h" alt=""/></div> <map name="category_8h" id="category_8h"> <area shape="rect" id="node9" href="priority_8h.html" title="The priority class provides importance levels with which one can categorize log messages." alt="" coords="235,80,341,107"/><area shape="rect" id="node12" href="location__info_8h.html" title="The internal representation of caller location information." alt="" coords="365,80,507,107"/></map> </div> </div> <p><a href="category_8h_source.html">Go to the source code of this file.</a></p> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a> Macros</h2></td></tr> <tr class="memitem:ab6671c118bfc2bf2ae2531af4eec588d"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#ab6671c118bfc2bf2ae2531af4eec588d">log4c_category_define</a>(a_category, a_name)</td></tr> <tr class="separator:ab6671c118bfc2bf2ae2531af4eec588d"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a> Typedefs</h2></td></tr> <tr class="memitem:a4a19c6cac0bb9a9309d5fe6cce4d3881"><td class="memItemLeft" align="right" valign="top">typedef struct __log4c_category </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a></td></tr> <tr class="separator:a4a19c6cac0bb9a9309d5fe6cce4d3881"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a> Functions</h2></td></tr> <tr class="memitem:a01e8bb77e87204aed8dcd286a070c5a1"><td class="memItemLeft" align="right" valign="top"><a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a01e8bb77e87204aed8dcd286a070c5a1">log4c_category_get</a> (const char *a_name)</td></tr> <tr class="separator:a01e8bb77e87204aed8dcd286a070c5a1"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a4d0973bb519df095046bb61b060ac8af"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a4d0973bb519df095046bb61b060ac8af">log4c_category_list</a> (<a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> **a_cats, int a_ncats)</td></tr> <tr class="separator:a4d0973bb519df095046bb61b060ac8af"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a3a1c1e1100b07d09cd392d34fb490437"><td class="memItemLeft" align="right" valign="top"><a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a3a1c1e1100b07d09cd392d34fb490437">log4c_category_new</a> (const char *a_name)</td></tr> <tr class="separator:a3a1c1e1100b07d09cd392d34fb490437"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a3059753c2720cacd3ded410225e2bc4b"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a3059753c2720cacd3ded410225e2bc4b">log4c_category_delete</a> (<a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a3059753c2720cacd3ded410225e2bc4b"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a6ea845421c9335b7b0ea7bcb7f22c83d"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a6ea845421c9335b7b0ea7bcb7f22c83d">log4c_category_get_name</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a6ea845421c9335b7b0ea7bcb7f22c83d"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a5abd1c3379680c3c0e4d13ab0c7349b7"><td class="memItemLeft" align="right" valign="top">struct __log4c_appender * </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a5abd1c3379680c3c0e4d13ab0c7349b7">log4c_category_get_appender</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a5abd1c3379680c3c0e4d13ab0c7349b7"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a14a10988c850eb8689dc43b2dca09b39"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a14a10988c850eb8689dc43b2dca09b39">log4c_category_get_additivity</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a14a10988c850eb8689dc43b2dca09b39"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a073944f1ec7fa9be4fca89cff3a8ce43"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a073944f1ec7fa9be4fca89cff3a8ce43">log4c_category_get_priority</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a073944f1ec7fa9be4fca89cff3a8ce43"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ac55d7a08b37efa6fc99c4367378cba29"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#ac55d7a08b37efa6fc99c4367378cba29">log4c_category_get_chainedpriority</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:ac55d7a08b37efa6fc99c4367378cba29"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aa7d34c99642e0d516c35dbefc45c76f5"><td class="memItemLeft" align="right" valign="top">struct __log4c_appender * </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#aa7d34c99642e0d516c35dbefc45c76f5">log4c_category_set_appender</a> (<a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, struct __log4c_appender *a_appender)</td></tr> <tr class="separator:aa7d34c99642e0d516c35dbefc45c76f5"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aae4341b6fa42f38e522d6b3e78511bde"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#aae4341b6fa42f38e522d6b3e78511bde">log4c_category_set_priority</a> (<a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, int a_priority)</td></tr> <tr class="separator:aae4341b6fa42f38e522d6b3e78511bde"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a2f4fe4658b1c89c8d1db782d65cfd2dd"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a2f4fe4658b1c89c8d1db782d65cfd2dd">log4c_category_set_additivity</a> (<a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, int a_additivity)</td></tr> <tr class="separator:a2f4fe4658b1c89c8d1db782d65cfd2dd"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:abb57e39c78f6a748a3d2a806b2c54519"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#abb57e39c78f6a748a3d2a806b2c54519">log4c_category_print</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, FILE *a_stream)</td></tr> <tr class="separator:abb57e39c78f6a748a3d2a806b2c54519"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a4d96cdb020cbaa8b0e9cb510f264fab0"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, int a_priority)</td></tr> <tr class="separator:a4d96cdb020cbaa8b0e9cb510f264fab0"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a9c9430e7a7545038d42542c7b452ba92"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a9c9430e7a7545038d42542c7b452ba92">log4c_category_is_fatal_enabled</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a9c9430e7a7545038d42542c7b452ba92"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a0ee231f2169ba13facf3f0ac408a257d"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a0ee231f2169ba13facf3f0ac408a257d">log4c_category_is_alert_enabled</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a0ee231f2169ba13facf3f0ac408a257d"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a099d525e912c7195811355211f3d9710"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a099d525e912c7195811355211f3d9710">log4c_category_is_crit_enabled</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a099d525e912c7195811355211f3d9710"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a3fb9fab93618c48e0553f8b1c1ca2fc5"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a3fb9fab93618c48e0553f8b1c1ca2fc5">log4c_category_is_error_enabled</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a3fb9fab93618c48e0553f8b1c1ca2fc5"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a68a04ce5395be39befa62ad6ff90e353"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a68a04ce5395be39befa62ad6ff90e353">log4c_category_is_warn_enabled</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a68a04ce5395be39befa62ad6ff90e353"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ac639057e0cfc380f998321d71d65e188"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#ac639057e0cfc380f998321d71d65e188">log4c_category_is_notice_enabled</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:ac639057e0cfc380f998321d71d65e188"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aed1a56dde3433ba1596aa0e04910f3cf"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#aed1a56dde3433ba1596aa0e04910f3cf">log4c_category_is_info_enabled</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:aed1a56dde3433ba1596aa0e04910f3cf"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a5b33252747976e877e9476843e8cc293"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a5b33252747976e877e9476843e8cc293">log4c_category_is_debug_enabled</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:a5b33252747976e877e9476843e8cc293"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ae3ba19a368c314538d53f990987b2a43"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#ae3ba19a368c314538d53f990987b2a43">log4c_category_is_trace_enabled</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category)</td></tr> <tr class="separator:ae3ba19a368c314538d53f990987b2a43"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a19fa3eadd3ed30031299778d90b6ad29"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a19fa3eadd3ed30031299778d90b6ad29">log4c_category_log</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, int a_priority, const char *a_format,...)</td></tr> <tr class="separator:a19fa3eadd3ed30031299778d90b6ad29"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a4aa807997d3688dd74c2347051a89262"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a4aa807997d3688dd74c2347051a89262">log4c_category_log_locinfo</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, const <a class="el" href="structlog4c__location__info__t.html">log4c_location_info_t</a> *a_locinfo, int a_priority, const char *a_format,...)</td></tr> <tr class="separator:a4aa807997d3688dd74c2347051a89262"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a2b7213338714acd43550b656f77aa929"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a2b7213338714acd43550b656f77aa929">log4c_category_fatal</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, const char *a_format,...)</td></tr> <tr class="separator:a2b7213338714acd43550b656f77aa929"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a6e67e98f6ef4966200972a624af6a135"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a6e67e98f6ef4966200972a624af6a135">log4c_category_alert</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, const char *a_format,...)</td></tr> <tr class="separator:a6e67e98f6ef4966200972a624af6a135"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a5ae3e66a260d2a9d7eaf51a63388b9b9"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a5ae3e66a260d2a9d7eaf51a63388b9b9">log4c_category_crit</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, const char *a_format,...)</td></tr> <tr class="separator:a5ae3e66a260d2a9d7eaf51a63388b9b9"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a50c9763085716faf5f47d9259a09f997"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a50c9763085716faf5f47d9259a09f997">log4c_category_error</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, const char *a_format,...)</td></tr> <tr class="separator:a50c9763085716faf5f47d9259a09f997"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a3b208422a80ed282f935fe48ff9c6209"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a3b208422a80ed282f935fe48ff9c6209">log4c_category_warn</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, const char *a_format,...)</td></tr> <tr class="separator:a3b208422a80ed282f935fe48ff9c6209"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a0c257b5663dbfb86c67b9004a67e97c0"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a0c257b5663dbfb86c67b9004a67e97c0">log4c_category_notice</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, const char *a_format,...)</td></tr> <tr class="separator:a0c257b5663dbfb86c67b9004a67e97c0"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af5a54cff8d8aa5c498565fc35f8e7160"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#af5a54cff8d8aa5c498565fc35f8e7160">log4c_category_info</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, const char *a_format,...)</td></tr> <tr class="separator:af5a54cff8d8aa5c498565fc35f8e7160"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a05c59bda7dd7782b375a328207332f06"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#a05c59bda7dd7782b375a328207332f06">log4c_category_debug</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, const char *a_format,...)</td></tr> <tr class="separator:a05c59bda7dd7782b375a328207332f06"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af883cd63b979ab258c2275fb8b1b26ab"><td class="memItemLeft" align="right" valign="top">static LOG4C_INLINE void </td><td class="memItemRight" valign="bottom"><a class="el" href="category_8h.html#af883cd63b979ab258c2275fb8b1b26ab">__log4c_category_trace</a> (const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> *a_category, const char *a_format,...)</td></tr> <tr class="separator:af883cd63b979ab258c2275fb8b1b26ab"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><p>central class in the log4c package. </p> <p>One of the distintive features of log4j (and hence log4c) are hierarchical categories and their evaluation. </p> </div><h2 class="groupheader">Macro Definition Documentation</h2> <a class="anchor" id="ab6671c118bfc2bf2ae2531af4eec588d"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define log4c_category_define</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname">a_category, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname">a_name </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Helper macro to define static categories.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t pointer name </td></tr> <tr><td class="paramname">a_name</td><td>the category name </td></tr> </table> </dd> </dl> </div> </div> <h2 class="groupheader">Typedef Documentation</h2> <a class="anchor" id="a4a19c6cac0bb9a9309d5fe6cce4d3881"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">typedef struct __log4c_category <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a></td> </tr> </table> </div><div class="memdoc"> <p>log4c category class </p> </div> </div> <h2 class="groupheader">Function Documentation</h2> <a class="anchor" id="af883cd63b979ab258c2275fb8b1b26ab"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void __log4c_category_trace </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with trace priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217aacfb33711a411127fed8ad0b1029dbc5">LOG4C_PRIORITY_TRACE</a>.</p> </div> </div> <a class="anchor" id="a6e67e98f6ef4966200972a624af6a135"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void log4c_category_alert </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with alert priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217ab9b55be3e083228073e281fe565c17e8">LOG4C_PRIORITY_ALERT</a>.</p> </div> </div> <a class="anchor" id="a5ae3e66a260d2a9d7eaf51a63388b9b9"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void log4c_category_crit </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with crit priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a8d1529c8838ec999221ecad85f1a4a2d">LOG4C_PRIORITY_CRIT</a>.</p> </div> </div> <a class="anchor" id="a05c59bda7dd7782b375a328207332f06"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void log4c_category_debug </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with debug priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a760104d64a4aa0a2e60aee66764b1c35">LOG4C_PRIORITY_DEBUG</a>.</p> </div> </div> <a class="anchor" id="a3059753c2720cacd3ded410225e2bc4b"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void log4c_category_delete </td> <td>(</td> <td class="paramtype"><a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Destructor for a log4c_category_t.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a50c9763085716faf5f47d9259a09f997"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void log4c_category_error </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with error priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a69a26a9c633f45a9f5ee5be89e59590f">LOG4C_PRIORITY_ERROR</a>.</p> </div> </div> <a class="anchor" id="a2b7213338714acd43550b656f77aa929"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void log4c_category_fatal </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with fatal priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a10f457ce84fdfc01b44430fba456bf2a">LOG4C_PRIORITY_FATAL</a>.</p> </div> </div> <a class="anchor" id="a01e8bb77e87204aed8dcd286a070c5a1"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a>* log4c_category_get </td> <td>(</td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_name</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Instantiate a log4c_category_t with name <em>name</em>. This method does not set priority of the category which is by default <code>LOG4C_PRIORITY_NOTSET</code>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_name</td><td>The name of the category to retrieve.</td></tr> </table> </dd> </dl> <dl class="bug"><dt><b><a class="el" href="bug.html#_bug000002">Bug:</a></b></dt><dd>the root category name should be "" not "root". * </dd></dl> </div> </div> <a class="anchor" id="a14a10988c850eb8689dc43b2dca09b39"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int log4c_category_get_additivity </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Get the additivity flag for this log4c_category_t..</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the category additivity </dd></dl> </div> </div> <a class="anchor" id="a5abd1c3379680c3c0e4d13ab0c7349b7"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">struct __log4c_appender* log4c_category_get_appender </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">read</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Returns the Appender for this log4c_category_t, or NULL if no Appender has been set. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>The Appender. </dd></dl> </div> </div> <a class="anchor" id="ac55d7a08b37efa6fc99c4367378cba29"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int log4c_category_get_chainedpriority </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Starting from this category, search the category hierarchy for a set priority and return it. Otherwise, return the priority of the root category.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object</td></tr> </table> </dd> </dl> <dl class="todo"><dt><b><a class="el" href="todo.html#_todo000003">Todo:</a></b></dt><dd>the log4c_category_t is designed so that this method executes as quickly as possible. It could even be faster if the set priority was propagated through the children hierarchy of a category. </dd></dl> <p>References <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a692ee4b3f035edcb79359acaa3372ecc">LOG4C_PRIORITY_NOTSET</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a27cc81aee37c91f3699a0bcc5dbfb4bb">LOG4C_PRIORITY_UNKNOWN</a>.</p> </div> </div> <a class="anchor" id="a6ea845421c9335b7b0ea7bcb7f22c83d"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const char* log4c_category_get_name </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Return the category name. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the category name. </dd></dl> </div> </div> <a class="anchor" id="a073944f1ec7fa9be4fca89cff3a8ce43"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int log4c_category_get_priority </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Returns the assigned Priority, if any, for this log4c_category_t. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Priority - the assigned Priority, can be LOG4C_PRIORITY_NOTSET </dd></dl> <p>References <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a27cc81aee37c91f3699a0bcc5dbfb4bb">LOG4C_PRIORITY_UNKNOWN</a>.</p> </div> </div> <a class="anchor" id="af5a54cff8d8aa5c498565fc35f8e7160"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void log4c_category_info </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with info priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a2cfd18cd18781e1988424b823ff4f170">LOG4C_PRIORITY_INFO</a>.</p> </div> </div> <a class="anchor" id="a0ee231f2169ba13facf3f0ac408a257d"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static int log4c_category_is_alert_enabled </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return true if the category will log messages with priority <code>LOG4C_PRIORITY_ALERT</code>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Whether the category will log. </dd></dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217ab9b55be3e083228073e281fe565c17e8">LOG4C_PRIORITY_ALERT</a>.</p> </div> </div> <a class="anchor" id="a099d525e912c7195811355211f3d9710"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static int log4c_category_is_crit_enabled </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return true if the category will log messages with priority <code>LOG4C_PRIORITY_CRIT</code>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Whether the category will log. </dd></dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a8d1529c8838ec999221ecad85f1a4a2d">LOG4C_PRIORITY_CRIT</a>.</p> </div> </div> <a class="anchor" id="a5b33252747976e877e9476843e8cc293"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static int log4c_category_is_debug_enabled </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return true if the category will log messages with priority <code>LOG4C_PRIORITY_DEBUG</code>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Whether the category will log. </dd></dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a760104d64a4aa0a2e60aee66764b1c35">LOG4C_PRIORITY_DEBUG</a>.</p> </div> </div> <a class="anchor" id="a3fb9fab93618c48e0553f8b1c1ca2fc5"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static int log4c_category_is_error_enabled </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return true if the category will log messages with priority <code>LOG4C_PRIORITY_ERROR</code>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Whether the category will log. </dd></dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a69a26a9c633f45a9f5ee5be89e59590f">LOG4C_PRIORITY_ERROR</a>.</p> </div> </div> <a class="anchor" id="a9c9430e7a7545038d42542c7b452ba92"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static int log4c_category_is_fatal_enabled </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return true if the category will log messages with priority <code>LOG4C_PRIORITY_FATAL</code>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Whether the category will log. </dd></dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a10f457ce84fdfc01b44430fba456bf2a">LOG4C_PRIORITY_FATAL</a>.</p> </div> </div> <a class="anchor" id="aed1a56dde3433ba1596aa0e04910f3cf"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static int log4c_category_is_info_enabled </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return true if the category will log messages with priority <code>LOG4C_PRIORITY_INFO</code>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Whether the category will log. </dd></dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a2cfd18cd18781e1988424b823ff4f170">LOG4C_PRIORITY_INFO</a>.</p> </div> </div> <a class="anchor" id="ac639057e0cfc380f998321d71d65e188"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static int log4c_category_is_notice_enabled </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return true if the category will log messages with priority <code>LOG4C_PRIORITY_NOTICE</code>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Whether the category will log. </dd></dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217aa1680c09b84e444c25b81a6c87f658c6">LOG4C_PRIORITY_NOTICE</a>.</p> </div> </div> <a class="anchor" id="a4d96cdb020cbaa8b0e9cb510f264fab0"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static int log4c_category_is_priority_enabled </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>a_priority</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Returns true if the chained priority of the log4c_category_t is equal to or higher than given priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_priority</td><td>The priority to compare with. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>whether logging is enable for this priority. </dd></dl> </div> </div> <a class="anchor" id="ae3ba19a368c314538d53f990987b2a43"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static int log4c_category_is_trace_enabled </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return true if the category will log messages with priority <code>LOG4C_PRIORITY_TRACE</code>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Whether the category will log. </dd></dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217aacfb33711a411127fed8ad0b1029dbc5">LOG4C_PRIORITY_TRACE</a>.</p> </div> </div> <a class="anchor" id="a68a04ce5395be39befa62ad6ff90e353"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static int log4c_category_is_warn_enabled </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return true if the category will log messages with priority <code>LOG4C_PRIORITY_WARN</code>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Whether the category will log. </dd></dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a38567b92f1273ad16e30a7e47c834c2f">LOG4C_PRIORITY_WARN</a>.</p> </div> </div> <a class="anchor" id="a4d0973bb519df095046bb61b060ac8af"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int log4c_category_list </td> <td>(</td> <td class="paramtype"><a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> ** </td> <td class="paramname"><em>a_cats</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>a_ncats</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Fill in an array with the log4c categories.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_cats</td><td>array of categories that will be filled </td></tr> <tr><td class="paramname">a_ncats</td><td>number of categories in the array</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>-1 if it fails or the number of available categories in log4c. </dd></dl> </div> </div> <a class="anchor" id="a19fa3eadd3ed30031299778d90b6ad29"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void log4c_category_log </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>a_priority</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with the specified priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_priority</td><td>The priority of this log message. </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>.</p> </div> </div> <a class="anchor" id="a4aa807997d3688dd74c2347051a89262"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void log4c_category_log_locinfo </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const <a class="el" href="structlog4c__location__info__t.html">log4c_location_info_t</a> * </td> <td class="paramname"><em>a_locinfo</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>a_priority</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with the specified priority and a user location info. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_locinfo</td><td>a user location info </td></tr> <tr><td class="paramname">a_priority</td><td>The priority of this log message. </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>.</p> </div> </div> <a class="anchor" id="a3a1c1e1100b07d09cd392d34fb490437"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a>* log4c_category_new </td> <td>(</td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_name</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Constructor for a log4c_category_t.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_name</td><td>the category name </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>a log4c_category object </dd></dl> <dl class="section warning"><dt>Warning</dt><dd>this method should not be called directly. You should use the <a class="el" href="category_8h.html#a01e8bb77e87204aed8dcd286a070c5a1">log4c_category_get()</a> method in order to preserve the categories hierarchy. </dd></dl> <p>References <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a692ee4b3f035edcb79359acaa3372ecc">LOG4C_PRIORITY_NOTSET</a>.</p> </div> </div> <a class="anchor" id="a0c257b5663dbfb86c67b9004a67e97c0"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void log4c_category_notice </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with notice priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217aa1680c09b84e444c25b81a6c87f658c6">LOG4C_PRIORITY_NOTICE</a>.</p> </div> </div> <a class="anchor" id="abb57e39c78f6a748a3d2a806b2c54519"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void log4c_category_print </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">FILE * </td> <td class="paramname"><em>a_stream</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>prints the log4c_category_t object on a stream</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_stream</td><td>The stream </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a2f4fe4658b1c89c8d1db782d65cfd2dd"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int log4c_category_set_additivity </td> <td>(</td> <td class="paramtype"><a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>a_additivity</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Sets a new additivity flag for this category.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_additivity</td><td>the new category additivity </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the previous category additivity </dd></dl> </div> </div> <a class="anchor" id="aa7d34c99642e0d516c35dbefc45c76f5"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">struct __log4c_appender* log4c_category_set_appender </td> <td>(</td> <td class="paramtype"><a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>this</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="appender_8h.html#ab9a6df639c26566a4576233dfcc21b55">log4c_appender_t</a> * </td> <td class="paramname"><em>a_appender</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">read</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Sets a new appender for this category.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_appender</td><td>the new category appender </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the previous category appender</dd></dl> <dl class="todo"><dt><b><a class="el" href="todo.html#_todo000002">Todo:</a></b></dt><dd>need multiple appenders per category </dd></dl> </div> </div> <a class="anchor" id="aae4341b6fa42f38e522d6b3e78511bde"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int log4c_category_set_priority </td> <td>(</td> <td class="paramtype"><a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>a_priority</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Sets a new priority of this category.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_priority</td><td>the new priority to set. Use LOG4C_PRIORITY_NOTSET to let the category use its parents priority as effective priority. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the previous category priority </dd></dl> <p>References <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a27cc81aee37c91f3699a0bcc5dbfb4bb">LOG4C_PRIORITY_UNKNOWN</a>.</p> </div> </div> <a class="anchor" id="a3b208422a80ed282f935fe48ff9c6209"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">static LOG4C_INLINE void log4c_category_warn </td> <td>(</td> <td class="paramtype">const <a class="el" href="category_8h.html#a4a19c6cac0bb9a9309d5fe6cce4d3881">log4c_category_t</a> * </td> <td class="paramname"><em>a_category</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>a_format</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"><em>...</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">static</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Log a message with warn priority. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">a_category</td><td>the log4c_category_t object </td></tr> <tr><td class="paramname">a_format</td><td>Format specifier for the string to write in the log file. </td></tr> <tr><td class="paramname">...</td><td>The arguments for a_format </td></tr> </table> </dd> </dl> <p>References <a class="el" href="category_8h.html#a4d96cdb020cbaa8b0e9cb510f264fab0">log4c_category_is_priority_enabled()</a>, and <a class="el" href="priority_8h.html#a2efa50b9e3c75e5bb20867a4641c4217a38567b92f1273ad16e30a7e47c834c2f">LOG4C_PRIORITY_WARN</a>.</p> </div> </div> </div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.3.1 </small></address> </body> </html>