Google Git
Sign in
apache/iceberg-cpp/refs/heads/gh-pages/./mkdocs/docs/api/log__macros_8h.html
blob: 2e7422f783f05b04821282675fe636079ccdbe3c [file]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.8"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>iceberg-cpp: iceberg/logging/log_macros.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="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.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 id="projectrow">
<td id="projectalign">
<div id="projectname">iceberg-cpp
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.8 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search/",'.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<div id="MSearchResults">
<div class="SRPage">
<div id="SRIndex">
<div id="SRResults"></div>
<div class="SRStatus" id="Loading">Loading...</div>
<div class="SRStatus" id="Searching">Searching...</div>
<div class="SRStatus" id="NoMatches">No Matches</div>
</div>
</div>
</div>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_51d145386ec5f52aa06ebf5e46944abc.html">iceberg</a></li><li class="navelem"><a class="el" href="dir_e261caeeda3f8e02492ad86220e1178e.html">logging</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#namespaces">Namespaces</a> &#124;
<a href="#define-members">Macros</a> &#124;
<a href="#func-members">Functions</a> </div>
<div class="headertitle"><div class="title">log_macros.h File Reference</div></div>
</div><!--header-->
<div class="contents">
<p>Iceberg-prefixed logging macros (ICEBERG_LOG_*).
<a href="#details">More...</a></p>
<div class="textblock"><code>#include &lt;cstdlib&gt;</code><br />
<code>#include &lt;format&gt;</code><br />
<code>#include &lt;memory&gt;</code><br />
<code>#include &lt;source_location&gt;</code><br />
<code>#include &lt;string&gt;</code><br />
<code>#include &lt;string_view&gt;</code><br />
<code>#include &lt;utility&gt;</code><br />
<code>#include &quot;<a class="el" href="log__level_8h_source.html">iceberg/logging/log_level.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="logger_8h_source.html">iceberg/logging/logger.h</a>&quot;</code><br />
</div>
<p><a href="log__macros_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 id="namespaces" name="namespaces"></a>
Namespaces</h2></td></tr>
<tr class="memitem:namespaceiceberg" id="r_namespaceiceberg"><td class="memItemLeft" align="right" valign="top">namespace &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceiceberg.html">iceberg</a></td></tr>
<tr class="memdesc:namespaceiceberg"><td class="mdescLeft">&#160;</td><td class="mdescRight">Core Apache Iceberg C++ APIs. <br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="define-members" name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:a79326338ec95f3929a34aa00e16de94e" id="r_a79326338ec95f3929a34aa00e16de94e"><td class="memItemLeft" align="right" valign="top"><a id="a79326338ec95f3929a34aa00e16de94e" name="a79326338ec95f3929a34aa00e16de94e"></a>
#define&#160;</td><td class="memItemRight" valign="bottom"><b>ICEBERG_LOG_ACTIVE_LEVEL</b>&#160;&#160;&#160;::iceberg::LogLevel::kTrace</td></tr>
<tr class="memdesc:a79326338ec95f3929a34aa00e16de94e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Compile-time severity floor: statements below this level are discarded via <code>if constexpr</code>, so no emit code runs and no format call / source_location is generated for them (the compiler is free to optimize the dead branch away). The statement must still be well-formed &ndash; a bad format string or a non-formattable argument is a compile error even when the branch is discarded. Defaults to keeping everything. ICEBERG_LOG_FATAL is never gated by this floor &ndash; its abort is always compiled in. <br /></td></tr>
<tr class="separator:a79326338ec95f3929a34aa00e16de94e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a9b552e378f7354e05027af4b803750b0" id="r_a9b552e378f7354e05027af4b803750b0"><td class="memItemLeft" align="right" valign="top"><a id="a9b552e378f7354e05027af4b803750b0" name="a9b552e378f7354e05027af4b803750b0"></a>
#define&#160;</td><td class="memItemRight" valign="bottom"><b>ICEBERG_INTERNAL_LOG_MESSAGE</b>(FMT_, ...)&#160;&#160;&#160; [&amp;]() -&gt; ::std::string { return ::std::format((FMT_)__VA_OPT__(, ) __VA_ARGS__); }</td></tr>
<tr class="separator:a9b552e378f7354e05027af4b803750b0"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a8a8f79872324dbb006074cc55122b1c1" id="r_a8a8f79872324dbb006074cc55122b1c1"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="log__macros_8h.html#a8a8f79872324dbb006074cc55122b1c1">ICEBERG_INTERNAL_LOG</a>(level_, FMT_, ...)</td></tr>
<tr class="separator:a8a8f79872324dbb006074cc55122b1c1"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a2488e4504be66bb830ed602261b73a8b" id="r_a2488e4504be66bb830ed602261b73a8b"><td class="memItemLeft" align="right" valign="top"><a id="a2488e4504be66bb830ed602261b73a8b" name="a2488e4504be66bb830ed602261b73a8b"></a>
#define&#160;</td><td class="memItemRight" valign="bottom"><b>ICEBERG_LOG_TRACE</b>(...)&#160;&#160;&#160; ICEBERG_INTERNAL_LOG(::iceberg::LogLevel::kTrace, __VA_ARGS__)</td></tr>
<tr class="separator:a2488e4504be66bb830ed602261b73a8b"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a265209c77e3fa9a24221f6d63d1a7097" id="r_a265209c77e3fa9a24221f6d63d1a7097"><td class="memItemLeft" align="right" valign="top"><a id="a265209c77e3fa9a24221f6d63d1a7097" name="a265209c77e3fa9a24221f6d63d1a7097"></a>
#define&#160;</td><td class="memItemRight" valign="bottom"><b>ICEBERG_LOG_DEBUG</b>(...)&#160;&#160;&#160; ICEBERG_INTERNAL_LOG(::iceberg::LogLevel::kDebug, __VA_ARGS__)</td></tr>
<tr class="separator:a265209c77e3fa9a24221f6d63d1a7097"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a38515226daec219074f61724d1df28f6" id="r_a38515226daec219074f61724d1df28f6"><td class="memItemLeft" align="right" valign="top"><a id="a38515226daec219074f61724d1df28f6" name="a38515226daec219074f61724d1df28f6"></a>
#define&#160;</td><td class="memItemRight" valign="bottom"><b>ICEBERG_LOG_INFO</b>(...)&#160;&#160;&#160; ICEBERG_INTERNAL_LOG(::iceberg::LogLevel::kInfo, __VA_ARGS__)</td></tr>
<tr class="separator:a38515226daec219074f61724d1df28f6"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ad138243efa6766bb5a63d67f8563048e" id="r_ad138243efa6766bb5a63d67f8563048e"><td class="memItemLeft" align="right" valign="top"><a id="ad138243efa6766bb5a63d67f8563048e" name="ad138243efa6766bb5a63d67f8563048e"></a>
#define&#160;</td><td class="memItemRight" valign="bottom"><b>ICEBERG_LOG_WARN</b>(...)&#160;&#160;&#160; ICEBERG_INTERNAL_LOG(::iceberg::LogLevel::kWarn, __VA_ARGS__)</td></tr>
<tr class="separator:ad138243efa6766bb5a63d67f8563048e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a11648e4e943965676ef8706540c7619a" id="r_a11648e4e943965676ef8706540c7619a"><td class="memItemLeft" align="right" valign="top"><a id="a11648e4e943965676ef8706540c7619a" name="a11648e4e943965676ef8706540c7619a"></a>
#define&#160;</td><td class="memItemRight" valign="bottom"><b>ICEBERG_LOG_ERROR</b>(...)&#160;&#160;&#160; ICEBERG_INTERNAL_LOG(::iceberg::LogLevel::kError, __VA_ARGS__)</td></tr>
<tr class="separator:a11648e4e943965676ef8706540c7619a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a8aa2e154509953b60dc53a935239dbec" id="r_a8aa2e154509953b60dc53a935239dbec"><td class="memItemLeft" align="right" valign="top"><a id="a8aa2e154509953b60dc53a935239dbec" name="a8aa2e154509953b60dc53a935239dbec"></a>
#define&#160;</td><td class="memItemRight" valign="bottom"><b>ICEBERG_LOG_CRITICAL</b>(...)&#160;&#160;&#160; ICEBERG_INTERNAL_LOG(::iceberg::LogLevel::kCritical, __VA_ARGS__)</td></tr>
<tr class="separator:a8aa2e154509953b60dc53a935239dbec"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a3d39316a3333941bdf550d80a5364199" id="r_a3d39316a3333941bdf550d80a5364199"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="log__macros_8h.html#a3d39316a3333941bdf550d80a5364199">ICEBERG_LOG_FATAL</a>(FMT_, ...)</td></tr>
<tr class="separator:a3d39316a3333941bdf550d80a5364199"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a70dfbb4fc1e64a9d7e7e74c161ffbc3c" id="r_a70dfbb4fc1e64a9d7e7e74c161ffbc3c"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="log__macros_8h.html#a70dfbb4fc1e64a9d7e7e74c161ffbc3c">ICEBERG_LOG</a>(level_, FMT_, ...)</td></tr>
<tr class="separator:a70dfbb4fc1e64a9d7e7e74c161ffbc3c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aecf94e493238a9678e6dc41733dc6675" id="r_aecf94e493238a9678e6dc41733dc6675"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="log__macros_8h.html#aecf94e493238a9678e6dc41733dc6675">ICEBERG_LOG_TO</a>(logger_, level_, FMT_, ...)</td></tr>
<tr class="separator:aecf94e493238a9678e6dc41733dc6675"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a92d28323a5d6431a013e7119b02d7421" id="r_a92d28323a5d6431a013e7119b02d7421"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="log__macros_8h.html#a92d28323a5d6431a013e7119b02d7421">ICEBERG_LOG_RUNTIME_FMT</a>(level_, FMT_, ...)</td></tr>
<tr class="separator:a92d28323a5d6431a013e7119b02d7421"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:a885e43522698d6e2522924e9ba2a745b" id="r_a885e43522698d6e2522924e9ba2a745b"><td class="memTemplParams" colspan="2">template&lt;typename... Args&gt; </td></tr>
<tr class="memitem:a885e43522698d6e2522924e9ba2a745b"><td class="memTemplItemLeft" align="right" valign="top">std::string&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="log__macros_8h.html#a885e43522698d6e2522924e9ba2a745b">iceberg::internal::VFormat</a> (std::string_view fmt, Args &amp;&amp;... args)</td></tr>
<tr class="memdesc:a885e43522698d6e2522924e9ba2a745b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Runtime (non-literal) format-string helper for ICEBERG_LOG_RUNTIME_FMT. <br /></td></tr>
<tr class="separator:a885e43522698d6e2522924e9ba2a745b"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae1daa6f029aa6918a0731f91b039218c" id="r_ae1daa6f029aa6918a0731f91b039218c"><td class="memTemplParams" colspan="2">template&lt;typename MakeMessage &gt; </td></tr>
<tr class="memitem:ae1daa6f029aa6918a0731f91b039218c"><td class="memTemplItemLeft" align="right" valign="top">void&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="log__macros_8h.html#ae1daa6f029aa6918a0731f91b039218c">iceberg::internal::EmitIfEnabled</a> (<a class="el" href="classiceberg_1_1Logger.html">Logger</a> &amp;logger, <a class="el" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level, const std::source_location &amp;location, MakeMessage &amp;&amp;make_message) noexcept</td></tr>
<tr class="memdesc:ae1daa6f029aa6918a0731f91b039218c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Gate on <code>logger.ShouldLog</code>, then format (via <code>make_message</code>) and emit. <br /></td></tr>
<tr class="separator:ae1daa6f029aa6918a0731f91b039218c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a0c9c016dee2f0483d4f68d86181be0d9" id="r_a0c9c016dee2f0483d4f68d86181be0d9"><td class="memTemplParams" colspan="2"><a id="a0c9c016dee2f0483d4f68d86181be0d9" name="a0c9c016dee2f0483d4f68d86181be0d9"></a>
template&lt;typename MakeMessage &gt; </td></tr>
<tr class="memitem:a0c9c016dee2f0483d4f68d86181be0d9"><td class="memTemplItemLeft" align="right" valign="top">void&#160;</td><td class="memTemplItemRight" valign="bottom"><b>iceberg::internal::LogToCurrent</b> (<a class="el" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level, const std::source_location &amp;location, MakeMessage &amp;&amp;make_message) noexcept</td></tr>
<tr class="memdesc:a0c9c016dee2f0483d4f68d86181be0d9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Emit to the current (scoped-or-default) logger if enabled. <br /></td></tr>
<tr class="separator:a0c9c016dee2f0483d4f68d86181be0d9"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:af5475387a1863b836ab3cf2f6377f6f1" id="r_af5475387a1863b836ab3cf2f6377f6f1"><td class="memTemplParams" colspan="2">template&lt;typename MakeMessage &gt; </td></tr>
<tr class="memitem:af5475387a1863b836ab3cf2f6377f6f1"><td class="memTemplItemLeft" align="right" valign="top">void&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="log__macros_8h.html#af5475387a1863b836ab3cf2f6377f6f1">iceberg::internal::DispatchFatal</a> (<a class="el" href="classiceberg_1_1Logger.html">Logger</a> *logger, const std::source_location &amp;location, MakeMessage &amp;&amp;make_message) noexcept</td></tr>
<tr class="memdesc:af5475387a1863b836ab3cf2f6377f6f1"><td class="mdescLeft">&#160;</td><td class="mdescRight">Format once, emit if enabled, flush, run the fatal handler, and abort. <br /></td></tr>
<tr class="separator:af5475387a1863b836ab3cf2f6377f6f1"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a321eeff5aa4b21fa8b46783c63148555" id="r_a321eeff5aa4b21fa8b46783c63148555"><td class="memTemplParams" colspan="2"><a id="a321eeff5aa4b21fa8b46783c63148555" name="a321eeff5aa4b21fa8b46783c63148555"></a>
template&lt;typename MakeMessage &gt; </td></tr>
<tr class="memitem:a321eeff5aa4b21fa8b46783c63148555"><td class="memTemplItemLeft" align="right" valign="top">void&#160;</td><td class="memTemplItemRight" valign="bottom"><b>iceberg::internal::LogToCurrentRuntime</b> (<a class="el" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level, const std::source_location &amp;location, MakeMessage &amp;&amp;make_message) noexcept</td></tr>
<tr class="separator:a321eeff5aa4b21fa8b46783c63148555"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab3a00ea892a68afcecab1abac51e5361" id="r_ab3a00ea892a68afcecab1abac51e5361"><td class="memTemplParams" colspan="2"><a id="ab3a00ea892a68afcecab1abac51e5361" name="ab3a00ea892a68afcecab1abac51e5361"></a>
template&lt;typename MakeMessage &gt; </td></tr>
<tr class="memitem:ab3a00ea892a68afcecab1abac51e5361"><td class="memTemplItemLeft" align="right" valign="top">void&#160;</td><td class="memTemplItemRight" valign="bottom"><b>iceberg::internal::LogToExplicitRuntime</b> (<a class="el" href="classiceberg_1_1Logger.html">Logger</a> &amp;logger, <a class="el" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level, const std::source_location &amp;location, MakeMessage &amp;&amp;make_message) noexcept</td></tr>
<tr class="separator:ab3a00ea892a68afcecab1abac51e5361"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a39b498af2ff87f8fda25d4f3340b898c" id="r_a39b498af2ff87f8fda25d4f3340b898c"><td class="memTemplParams" colspan="2"><a id="a39b498af2ff87f8fda25d4f3340b898c" name="a39b498af2ff87f8fda25d4f3340b898c"></a>
template&lt;typename MakeMessage &gt; </td></tr>
<tr class="memitem:a39b498af2ff87f8fda25d4f3340b898c"><td class="memTemplItemLeft" align="right" valign="top">void&#160;</td><td class="memTemplItemRight" valign="bottom"><b>iceberg::internal::LogFatal</b> (const std::source_location &amp;location, MakeMessage &amp;&amp;make_message) noexcept</td></tr>
<tr class="separator:a39b498af2ff87f8fda25d4f3340b898c"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>Iceberg-prefixed logging macros (ICEBERG_LOG_*). </p>
<p>Kept out of <a class="el" href="logger_8h.html" title="Pluggable logging interface and the process-global default logger.">logger.h</a> so consumers of the C++ logging API (Logger, Log(), ScopedLogger) are not forced to pull in these macros or the conforming preprocessor they require. Include this header to use the macros; include <a class="el" href="short__log__macros_8h.html" title="Opt-in bare LOG_* aliases for the ICEBERG_LOG_* macros.">short_log_macros.h</a> for the bare LOG_* aliases. </p>
</div><h2 class="groupheader">Macro Definition Documentation</h2>
<a id="a8a8f79872324dbb006074cc55122b1c1" name="a8a8f79872324dbb006074cc55122b1c1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a8a8f79872324dbb006074cc55122b1c1">&#9670;&#160;</a></span>ICEBERG_INTERNAL_LOG</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ICEBERG_INTERNAL_LOG</td>
<td>(</td>
<td class="paramtype">&#160;</td>
<td class="paramname">level_, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&#160;</td>
<td class="paramname">FMT_, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&#160;</td>
<td class="paramname"><em>...</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line"> <span class="keywordflow">do</span> { \</div>
<div class="line"> <span class="keywordflow">if</span> <span class="keyword">constexpr</span> ((level_) &gt;= <a class="code hl_define" href="log__macros_8h.html#a79326338ec95f3929a34aa00e16de94e">ICEBERG_LOG_ACTIVE_LEVEL</a>) { \</div>
<div class="line"> ::iceberg::internal::LogToCurrent( \</div>
<div class="line"> (level_), ::std::source_location::current(), \</div>
<div class="line"> ICEBERG_INTERNAL_LOG_MESSAGE(FMT_ __VA_OPT__(, ) __VA_ARGS__)); \</div>
<div class="line"> } \</div>
<div class="line"> } <span class="keywordflow">while</span> (0)</div>
<div class="ttc" id="alog__macros_8h_html_a79326338ec95f3929a34aa00e16de94e"><div class="ttname"><a href="log__macros_8h.html#a79326338ec95f3929a34aa00e16de94e">ICEBERG_LOG_ACTIVE_LEVEL</a></div><div class="ttdeci">#define ICEBERG_LOG_ACTIVE_LEVEL</div><div class="ttdoc">Compile-time severity floor: statements below this level are discarded via if constexpr,...</div><div class="ttdef"><b>Definition</b> log_macros.h:184</div></div>
</div><!-- fragment -->
</div>
</div>
<a id="a70dfbb4fc1e64a9d7e7e74c161ffbc3c" name="a70dfbb4fc1e64a9d7e7e74c161ffbc3c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a70dfbb4fc1e64a9d7e7e74c161ffbc3c">&#9670;&#160;</a></span>ICEBERG_LOG</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ICEBERG_LOG</td>
<td>(</td>
<td class="paramtype">&#160;</td>
<td class="paramname">level_, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&#160;</td>
<td class="paramname">FMT_, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&#160;</td>
<td class="paramname"><em>...</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line"> ::iceberg::internal::LogToCurrentRuntime( \</div>
<div class="line"> (level_), ::std::source_location::current(), \</div>
<div class="line"> ICEBERG_INTERNAL_LOG_MESSAGE(FMT_ __VA_OPT__(, ) __VA_ARGS__))</div>
</div><!-- fragment -->
</div>
</div>
<a id="a3d39316a3333941bdf550d80a5364199" name="a3d39316a3333941bdf550d80a5364199"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a3d39316a3333941bdf550d80a5364199">&#9670;&#160;</a></span>ICEBERG_LOG_FATAL</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ICEBERG_LOG_FATAL</td>
<td>(</td>
<td class="paramtype">&#160;</td>
<td class="paramname">FMT_, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&#160;</td>
<td class="paramname"><em>...</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line"> ::iceberg::internal::LogFatal( \</div>
<div class="line"> ::std::source_location::current(), \</div>
<div class="line"> ICEBERG_INTERNAL_LOG_MESSAGE(FMT_ __VA_OPT__(, ) __VA_ARGS__))</div>
</div><!-- fragment -->
</div>
</div>
<a id="a92d28323a5d6431a013e7119b02d7421" name="a92d28323a5d6431a013e7119b02d7421"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a92d28323a5d6431a013e7119b02d7421">&#9670;&#160;</a></span>ICEBERG_LOG_RUNTIME_FMT</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ICEBERG_LOG_RUNTIME_FMT</td>
<td>(</td>
<td class="paramtype">&#160;</td>
<td class="paramname">level_, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&#160;</td>
<td class="paramname">FMT_, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&#160;</td>
<td class="paramname"><em>...</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line"> ::iceberg::internal::LogToCurrentRuntime( \</div>
<div class="line"> (level_), ::std::source_location::current(), [&amp;]() -&gt; ::std::string { \</div>
<div class="line"> return ::iceberg::internal::VFormat((FMT_)__VA_OPT__(, ) __VA_ARGS__); \</div>
<div class="line"> })</div>
</div><!-- fragment -->
</div>
</div>
<a id="aecf94e493238a9678e6dc41733dc6675" name="aecf94e493238a9678e6dc41733dc6675"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aecf94e493238a9678e6dc41733dc6675">&#9670;&#160;</a></span>ICEBERG_LOG_TO</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ICEBERG_LOG_TO</td>
<td>(</td>
<td class="paramtype">&#160;</td>
<td class="paramname">logger_, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&#160;</td>
<td class="paramname">level_, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&#160;</td>
<td class="paramname">FMT_, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&#160;</td>
<td class="paramname"><em>...</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line"> ::iceberg::internal::LogToExplicitRuntime( \</div>
<div class="line"> (logger_), (level_), ::std::source_location::current(), \</div>
<div class="line"> ICEBERG_INTERNAL_LOG_MESSAGE(FMT_ __VA_OPT__(, ) __VA_ARGS__))</div>
</div><!-- fragment -->
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a id="af5475387a1863b836ab3cf2f6377f6f1" name="af5475387a1863b836ab3cf2f6377f6f1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#af5475387a1863b836ab3cf2f6377f6f1">&#9670;&#160;</a></span>DispatchFatal()</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template&lt;typename MakeMessage &gt; </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">void iceberg::internal::DispatchFatal </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classiceberg_1_1Logger.html">Logger</a> *&#160;</td>
<td class="paramname"><em>logger</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::source_location &amp;&#160;</td>
<td class="paramname"><em>location</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">MakeMessage &amp;&amp;&#160;</td>
<td class="paramname"><em>make_message</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Format once, emit if enabled, flush, run the fatal handler, and abort. </p>
<p>Formatting is independent of ShouldLog so the handler always receives the message. <code>logger</code> may be null. </p>
</div>
</div>
<a id="ae1daa6f029aa6918a0731f91b039218c" name="ae1daa6f029aa6918a0731f91b039218c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ae1daa6f029aa6918a0731f91b039218c">&#9670;&#160;</a></span>EmitIfEnabled()</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template&lt;typename MakeMessage &gt; </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">void iceberg::internal::EmitIfEnabled </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classiceberg_1_1Logger.html">Logger</a> &amp;&#160;</td>
<td class="paramname"><em>logger</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a>&#160;</td>
<td class="paramname"><em>level</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::source_location &amp;&#160;</td>
<td class="paramname"><em>location</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">MakeMessage &amp;&amp;&#160;</td>
<td class="paramname"><em>make_message</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Gate on <code>logger.ShouldLog</code>, then format (via <code>make_message</code>) and emit. </p>
<p><code>make_message</code> is a callable returning the formatted std::string; it is invoked only after the level passes ShouldLog, so a disabled log never evaluates its format arguments. Never throws: a std::formatter that throws (any type) routes to EmitFormatError, so the noexcept logging contract holds. </p>
</div>
</div>
<a id="a885e43522698d6e2522924e9ba2a745b" name="a885e43522698d6e2522924e9ba2a745b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a885e43522698d6e2522924e9ba2a745b">&#9670;&#160;</a></span>VFormat()</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template&lt;typename... Args&gt; </div>
<table class="memname">
<tr>
<td class="memname">std::string iceberg::internal::VFormat </td>
<td>(</td>
<td class="paramtype">std::string_view&#160;</td>
<td class="paramname"><em>fmt</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">Args &amp;&amp;...&#160;</td>
<td class="paramname"><em>args</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Runtime (non-literal) format-string helper for ICEBERG_LOG_RUNTIME_FMT. </p>
<p>std::format requires a compile-time format string; this routes a runtime string through std::vformat. Args are bound as named lvalues and the arg-store is held in a named variable so it outlives the vformat call (C++23 make_format_args rejects rvalues &ndash; P2905 / LWG3631). </p>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.8
</small></address>
</body>
</html>