| <!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/logger.h Source File</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&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&dn=expat.txt MIT */ |
| $(function() { |
| initMenu('',true,false,'search.php','Search'); |
| $(document).ready(function() { init_search(); }); |
| }); |
| /* @license-end */ |
| </script> |
| <div id="main-nav"></div> |
| <script type="text/javascript"> |
| /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */ |
| $(document).ready(function() { init_codefold(0); }); |
| /* @license-end */ |
| </script> |
| <!-- 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="headertitle"><div class="title">logger.h</div></div> |
| </div><!--header--> |
| <div class="contents"> |
| <a href="logger_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno"> 1</span><span class="comment">/*</span></div> |
| <div class="line"><a id="l00002" name="l00002"></a><span class="lineno"> 2</span><span class="comment"> * Licensed to the Apache Software Foundation (ASF) under one</span></div> |
| <div class="line"><a id="l00003" name="l00003"></a><span class="lineno"> 3</span><span class="comment"> * or more contributor license agreements. See the NOTICE file</span></div> |
| <div class="line"><a id="l00004" name="l00004"></a><span class="lineno"> 4</span><span class="comment"> * distributed with this work for additional information</span></div> |
| <div class="line"><a id="l00005" name="l00005"></a><span class="lineno"> 5</span><span class="comment"> * regarding copyright ownership. The ASF licenses this file</span></div> |
| <div class="line"><a id="l00006" name="l00006"></a><span class="lineno"> 6</span><span class="comment"> * to you under the Apache License, Version 2.0 (the</span></div> |
| <div class="line"><a id="l00007" name="l00007"></a><span class="lineno"> 7</span><span class="comment"> * "License"); you may not use this file except in compliance</span></div> |
| <div class="line"><a id="l00008" name="l00008"></a><span class="lineno"> 8</span><span class="comment"> * with the License. You may obtain a copy of the License at</span></div> |
| <div class="line"><a id="l00009" name="l00009"></a><span class="lineno"> 9</span><span class="comment"> *</span></div> |
| <div class="line"><a id="l00010" name="l00010"></a><span class="lineno"> 10</span><span class="comment"> * http://www.apache.org/licenses/LICENSE-2.0</span></div> |
| <div class="line"><a id="l00011" name="l00011"></a><span class="lineno"> 11</span><span class="comment"> *</span></div> |
| <div class="line"><a id="l00012" name="l00012"></a><span class="lineno"> 12</span><span class="comment"> * Unless required by applicable law or agreed to in writing,</span></div> |
| <div class="line"><a id="l00013" name="l00013"></a><span class="lineno"> 13</span><span class="comment"> * software distributed under the License is distributed on an</span></div> |
| <div class="line"><a id="l00014" name="l00014"></a><span class="lineno"> 14</span><span class="comment"> * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span></div> |
| <div class="line"><a id="l00015" name="l00015"></a><span class="lineno"> 15</span><span class="comment"> * KIND, either express or implied. See the License for the</span></div> |
| <div class="line"><a id="l00016" name="l00016"></a><span class="lineno"> 16</span><span class="comment"> * specific language governing permissions and limitations</span></div> |
| <div class="line"><a id="l00017" name="l00017"></a><span class="lineno"> 17</span><span class="comment"> * under the License.</span></div> |
| <div class="line"><a id="l00018" name="l00018"></a><span class="lineno"> 18</span><span class="comment"> */</span></div> |
| <div class="line"><a id="l00019" name="l00019"></a><span class="lineno"> 19</span> </div> |
| <div class="line"><a id="l00020" name="l00020"></a><span class="lineno"> 20</span><span class="preprocessor">#pragma once</span></div> |
| <div class="line"><a id="l00021" name="l00021"></a><span class="lineno"> 21</span> </div> |
| <div class="line"><a id="l00028" name="l00028"></a><span class="lineno"> 28</span> </div> |
| <div class="line"><a id="l00029" name="l00029"></a><span class="lineno"> 29</span><span class="preprocessor">#include <concepts></span></div> |
| <div class="line"><a id="l00030" name="l00030"></a><span class="lineno"> 30</span><span class="preprocessor">#include <cstdlib></span></div> |
| <div class="line"><a id="l00031" name="l00031"></a><span class="lineno"> 31</span><span class="preprocessor">#include <format></span></div> |
| <div class="line"><a id="l00032" name="l00032"></a><span class="lineno"> 32</span><span class="preprocessor">#include <functional></span></div> |
| <div class="line"><a id="l00033" name="l00033"></a><span class="lineno"> 33</span><span class="preprocessor">#include <memory></span></div> |
| <div class="line"><a id="l00034" name="l00034"></a><span class="lineno"> 34</span><span class="preprocessor">#include <source_location></span></div> |
| <div class="line"><a id="l00035" name="l00035"></a><span class="lineno"> 35</span><span class="preprocessor">#include <string></span></div> |
| <div class="line"><a id="l00036" name="l00036"></a><span class="lineno"> 36</span><span class="preprocessor">#include <string_view></span></div> |
| <div class="line"><a id="l00037" name="l00037"></a><span class="lineno"> 37</span><span class="preprocessor">#include <type_traits></span></div> |
| <div class="line"><a id="l00038" name="l00038"></a><span class="lineno"> 38</span><span class="preprocessor">#include <unordered_map></span></div> |
| <div class="line"><a id="l00039" name="l00039"></a><span class="lineno"> 39</span><span class="preprocessor">#include <utility></span></div> |
| <div class="line"><a id="l00040" name="l00040"></a><span class="lineno"> 40</span><span class="preprocessor">#include <vector></span></div> |
| <div class="line"><a id="l00041" name="l00041"></a><span class="lineno"> 41</span> </div> |
| <div class="line"><a id="l00042" name="l00042"></a><span class="lineno"> 42</span><span class="preprocessor">#include "<a class="code" href="iceberg__export_8h.html">iceberg/iceberg_export.h</a>"</span></div> |
| <div class="line"><a id="l00043" name="l00043"></a><span class="lineno"> 43</span><span class="preprocessor">#include "<a class="code" href="log__level_8h.html">iceberg/logging/log_level.h</a>"</span></div> |
| <div class="line"><a id="l00044" name="l00044"></a><span class="lineno"> 44</span><span class="preprocessor">#include "<a class="code" href="result_8h.html">iceberg/result.h</a>"</span></div> |
| <div class="line"><a id="l00045" name="l00045"></a><span class="lineno"> 45</span> </div> |
| <div class="line"><a id="l00046" name="l00046"></a><span class="lineno"> 46</span><span class="keyword">namespace </span><a class="code hl_namespace" href="namespaceiceberg.html">iceberg</a> {</div> |
| <div class="line"><a id="l00047" name="l00047"></a><span class="lineno"> 47</span> </div> |
| <div class="foldopen" id="foldopen00053" data-start="{" data-end="};"> |
| <div class="line"><a id="l00053" name="l00053"></a><span class="lineno"><a class="line" href="structiceberg_1_1LogAttribute.html"> 53</a></span><span class="keyword">struct </span>ICEBERG_EXPORT <a class="code hl_struct" href="structiceberg_1_1LogAttribute.html">LogAttribute</a> {</div> |
| <div class="line"><a id="l00054" name="l00054"></a><span class="lineno"> 54</span> std::string key;</div> |
| <div class="line"><a id="l00055" name="l00055"></a><span class="lineno"> 55</span> std::string value;</div> |
| <div class="line"><a id="l00056" name="l00056"></a><span class="lineno"> 56</span>};</div> |
| </div> |
| <div class="line"><a id="l00057" name="l00057"></a><span class="lineno"> 57</span> </div> |
| <div class="foldopen" id="foldopen00065" data-start="{" data-end="};"> |
| <div class="line"><a id="l00065" name="l00065"></a><span class="lineno"><a class="line" href="structiceberg_1_1LogMessage.html"> 65</a></span><span class="keyword">struct </span>ICEBERG_EXPORT <a class="code hl_class" href="structiceberg_1_1LogMessage.html">LogMessage</a> {</div> |
| <div class="line"><a id="l00066" name="l00066"></a><span class="lineno"> 66</span> <a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level = LogLevel::kOff;</div> |
| <div class="line"><a id="l00067" name="l00067"></a><span class="lineno"> 67</span> std::string message;</div> |
| <div class="line"><a id="l00068" name="l00068"></a><span class="lineno"> 68</span> std::source_location location = std::source_location::current();</div> |
| <div class="line"><a id="l00069" name="l00069"></a><span class="lineno"> 69</span> std::vector<LogAttribute> attributes;</div> |
| <div class="line"><a id="l00070" name="l00070"></a><span class="lineno"> 70</span> </div> |
| <div class="line"><a id="l00071" name="l00071"></a><span class="lineno"> 71</span> <span class="keyword">class </span>Builder;</div> |
| <div class="line"><a id="l00072" name="l00072"></a><span class="lineno"> 72</span>};</div> |
| </div> |
| <div class="line"><a id="l00073" name="l00073"></a><span class="lineno"> 73</span> </div> |
| <div class="line"><a id="l00088" name="l00088"></a><span class="lineno"> 88</span><span class="keyword">class </span>ICEBERG_EXPORT <a class="code hl_class" href="structiceberg_1_1LogMessage.html">LogMessage</a>::Builder {</div> |
| <div class="line"><a id="l00089" name="l00089"></a><span class="lineno"> 89</span> <span class="keyword">public</span>:</div> |
| <div class="line"><a id="l00090" name="l00090"></a><span class="lineno"> 90</span> <span class="keyword">explicit</span> Builder(<a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level,</div> |
| <div class="line"><a id="l00091" name="l00091"></a><span class="lineno"> 91</span> std::source_location location = std::source_location::current())</div> |
| <div class="line"><a id="l00092" name="l00092"></a><span class="lineno"> 92</span> : level_(level), location_(location) {}</div> |
| <div class="line"><a id="l00093" name="l00093"></a><span class="lineno"> 93</span> </div> |
| <div class="foldopen" id="foldopen00095" data-start="{" data-end="}"> |
| <div class="line"><a id="l00095" name="l00095"></a><span class="lineno"><a class="line" href="structiceberg_1_1LogMessage.html#ae4dc68fcc2d7a4f560519a970c473544"> 95</a></span> Builder& <a class="code hl_function" href="structiceberg_1_1LogMessage.html#ae4dc68fcc2d7a4f560519a970c473544">Message</a>(std::string message) {</div> |
| <div class="line"><a id="l00096" name="l00096"></a><span class="lineno"> 96</span> message_ = std::move(message);</div> |
| <div class="line"><a id="l00097" name="l00097"></a><span class="lineno"> 97</span> <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div> |
| <div class="line"><a id="l00098" name="l00098"></a><span class="lineno"> 98</span> }</div> |
| </div> |
| <div class="line"><a id="l00099" name="l00099"></a><span class="lineno"> 99</span> </div> |
| <div class="foldopen" id="foldopen00101" data-start="{" data-end="}"> |
| <div class="line"><a id="l00101" name="l00101"></a><span class="lineno"><a class="line" href="structiceberg_1_1LogMessage.html#ac07aa97063a1e2d64edbdeaa7024b3e9"> 101</a></span> Builder& <a class="code hl_function" href="structiceberg_1_1LogMessage.html#ac07aa97063a1e2d64edbdeaa7024b3e9">Attribute</a>(std::string key, std::string value) {</div> |
| <div class="line"><a id="l00102" name="l00102"></a><span class="lineno"> 102</span> attributes_.push_back(<a class="code hl_struct" href="structiceberg_1_1LogAttribute.html">LogAttribute</a>{.key = std::move(key), .value = std::move(value)});</div> |
| <div class="line"><a id="l00103" name="l00103"></a><span class="lineno"> 103</span> <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div> |
| <div class="line"><a id="l00104" name="l00104"></a><span class="lineno"> 104</span> }</div> |
| </div> |
| <div class="line"><a id="l00105" name="l00105"></a><span class="lineno"> 105</span> </div> |
| <div class="foldopen" id="foldopen00107" data-start="{" data-end="}"> |
| <div class="line"><a id="l00107" name="l00107"></a><span class="lineno"><a class="line" href="structiceberg_1_1LogMessage.html#a0af92d415ebac01e9af51071c039c2a6"> 107</a></span> Builder& <a class="code hl_function" href="structiceberg_1_1LogMessage.html#a0af92d415ebac01e9af51071c039c2a6">Location</a>(std::source_location location) {</div> |
| <div class="line"><a id="l00108" name="l00108"></a><span class="lineno"> 108</span> location_ = location;</div> |
| <div class="line"><a id="l00109" name="l00109"></a><span class="lineno"> 109</span> <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div> |
| <div class="line"><a id="l00110" name="l00110"></a><span class="lineno"> 110</span> }</div> |
| </div> |
| <div class="line"><a id="l00111" name="l00111"></a><span class="lineno"> 111</span> </div> |
| <div class="foldopen" id="foldopen00113" data-start="{" data-end="}"> |
| <div class="line"><a id="l00113" name="l00113"></a><span class="lineno"><a class="line" href="structiceberg_1_1LogMessage.html#a2409e275f406fd2cc0f3764dfc0da150"> 113</a></span> <a class="code hl_class" href="structiceberg_1_1LogMessage.html">LogMessage</a> <a class="code hl_function" href="structiceberg_1_1LogMessage.html#a2409e275f406fd2cc0f3764dfc0da150">Build</a>() {</div> |
| <div class="line"><a id="l00114" name="l00114"></a><span class="lineno"> 114</span> <span class="keywordflow">return</span> <a class="code hl_class" href="structiceberg_1_1LogMessage.html">LogMessage</a>{.level = level_,</div> |
| <div class="line"><a id="l00115" name="l00115"></a><span class="lineno"> 115</span> .message = std::move(message_),</div> |
| <div class="line"><a id="l00116" name="l00116"></a><span class="lineno"> 116</span> .location = location_,</div> |
| <div class="line"><a id="l00117" name="l00117"></a><span class="lineno"> 117</span> .attributes = std::move(attributes_)};</div> |
| <div class="line"><a id="l00118" name="l00118"></a><span class="lineno"> 118</span> }</div> |
| </div> |
| <div class="line"><a id="l00119" name="l00119"></a><span class="lineno"> 119</span> </div> |
| <div class="line"><a id="l00120" name="l00120"></a><span class="lineno"> 120</span> <span class="keyword">private</span>:</div> |
| <div class="line"><a id="l00121" name="l00121"></a><span class="lineno"> 121</span> <a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level_;</div> |
| <div class="line"><a id="l00122" name="l00122"></a><span class="lineno"> 122</span> std::string message_;</div> |
| <div class="line"><a id="l00123" name="l00123"></a><span class="lineno"> 123</span> <span class="comment">// `location_` is a trivially copyable members no need to move.</span></div> |
| <div class="line"><a id="l00124" name="l00124"></a><span class="lineno"> 124</span> std::source_location location_;</div> |
| <div class="line"><a id="l00125" name="l00125"></a><span class="lineno"> 125</span> std::vector<LogAttribute> attributes_;</div> |
| <div class="line"><a id="l00126" name="l00126"></a><span class="lineno"> 126</span>};</div> |
| <div class="line"><a id="l00127" name="l00127"></a><span class="lineno"> 127</span> </div> |
| <div class="line"><a id="l00133" name="l00133"></a><span class="lineno"><a class="line" href="namespaceiceberg.html#a50de3c8be4e894522604dd11f33dbf92"> 133</a></span><span class="keyword">inline</span> <span class="keyword">constexpr</span> std::string_view <a class="code hl_variable" href="namespaceiceberg.html#a50de3c8be4e894522604dd11f33dbf92">kLevelProperty</a> = <span class="stringliteral">"level"</span>;</div> |
| <div class="line"><a id="l00134" name="l00134"></a><span class="lineno"> 134</span><span class="keyword">inline</span> <span class="keyword">constexpr</span> std::string_view kPatternProperty = <span class="stringliteral">"pattern"</span>;</div> |
| <div class="line"><a id="l00135" name="l00135"></a><span class="lineno"> 135</span> </div> |
| <div class="foldopen" id="foldopen00146" data-start="{" data-end="};"> |
| <div class="line"><a id="l00146" name="l00146"></a><span class="lineno"><a class="line" href="classiceberg_1_1Logger.html"> 146</a></span><span class="keyword">class </span>ICEBERG_EXPORT <a class="code hl_class" href="classiceberg_1_1Logger.html">Logger</a> {</div> |
| <div class="line"><a id="l00147" name="l00147"></a><span class="lineno"> 147</span> <span class="keyword">public</span>:</div> |
| <div class="line"><a id="l00148" name="l00148"></a><span class="lineno"> 148</span> <span class="keyword">virtual</span> <a class="code hl_class" href="classiceberg_1_1Logger.html">~Logger</a>() = <span class="keywordflow">default</span>;</div> |
| <div class="line"><a id="l00149" name="l00149"></a><span class="lineno"> 149</span> </div> |
| <div class="foldopen" id="foldopen00156" data-start="{" data-end="}"> |
| <div class="line"><a id="l00156" name="l00156"></a><span class="lineno"><a class="line" href="classiceberg_1_1Logger.html#afb2309f921f8ebb7aa88ada353f37877"> 156</a></span> <span class="keyword">virtual</span> Status <a class="code hl_function" href="classiceberg_1_1Logger.html#afb2309f921f8ebb7aa88ada353f37877">Initialize</a>(</div> |
| <div class="line"><a id="l00157" name="l00157"></a><span class="lineno"> 157</span> <span class="keyword">const</span> std::unordered_map<std::string, std::string>& properties) {</div> |
| <div class="line"><a id="l00158" name="l00158"></a><span class="lineno"> 158</span> <span class="keywordflow">if</span> (<span class="keyword">auto</span> it = properties.find(std::string(<a class="code hl_variable" href="namespaceiceberg.html#a50de3c8be4e894522604dd11f33dbf92">kLevelProperty</a>)); it != properties.end()) {</div> |
| <div class="line"><a id="l00159" name="l00159"></a><span class="lineno"> 159</span> <span class="keyword">auto</span> parsed = <a class="code hl_function" href="namespaceiceberg.html#aaea6a2e5653e5da40a93d0d855c1836e">LogLevelFromString</a>(it->second);</div> |
| <div class="line"><a id="l00160" name="l00160"></a><span class="lineno"> 160</span> <span class="keywordflow">if</span> (!parsed) <span class="keywordflow">return</span> std::unexpected(parsed.error());</div> |
| <div class="line"><a id="l00161" name="l00161"></a><span class="lineno"> 161</span> SetLevel(*parsed);</div> |
| <div class="line"><a id="l00162" name="l00162"></a><span class="lineno"> 162</span> }</div> |
| <div class="line"><a id="l00163" name="l00163"></a><span class="lineno"> 163</span> <span class="keywordflow">return</span> {};</div> |
| <div class="line"><a id="l00164" name="l00164"></a><span class="lineno"> 164</span> }</div> |
| </div> |
| <div class="line"><a id="l00165" name="l00165"></a><span class="lineno"> 165</span> </div> |
| <div class="line"><a id="l00167" name="l00167"></a><span class="lineno"><a class="line" href="classiceberg_1_1Logger.html#ae94e42dfc0fe122f056c54049f6b751f"> 167</a></span> <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code hl_function" href="classiceberg_1_1Logger.html#ae94e42dfc0fe122f056c54049f6b751f">ShouldLog</a>(<a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level) <span class="keyword">const</span> <span class="keyword">noexcept</span> = 0;</div> |
| <div class="line"><a id="l00168" name="l00168"></a><span class="lineno"> 168</span> </div> |
| <div class="line"><a id="l00170" name="l00170"></a><span class="lineno"><a class="line" href="classiceberg_1_1Logger.html#a2cea7121351c84e8fe25a4fb2a1e52a3"> 170</a></span> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code hl_function" href="classiceberg_1_1Logger.html#a2cea7121351c84e8fe25a4fb2a1e52a3">Log</a>(<a class="code hl_class" href="structiceberg_1_1LogMessage.html">LogMessage</a>&& message) <span class="keyword">noexcept</span> = 0;</div> |
| <div class="line"><a id="l00171" name="l00171"></a><span class="lineno"> 171</span> </div> |
| <div class="line"><a id="l00173" name="l00173"></a><span class="lineno"><a class="line" href="classiceberg_1_1Logger.html#a929efd366d31507b1d0fb0f20cc981ac"> 173</a></span> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code hl_function" href="classiceberg_1_1Logger.html#a929efd366d31507b1d0fb0f20cc981ac">SetLevel</a>(<a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level) <span class="keyword">noexcept</span> = 0;</div> |
| <div class="line"><a id="l00174" name="l00174"></a><span class="lineno"> 174</span> </div> |
| <div class="line"><a id="l00176" name="l00176"></a><span class="lineno"><a class="line" href="classiceberg_1_1Logger.html#a8d7d6a59ecbb0a1ba0ca79cbbb079540"> 176</a></span> <span class="keyword">virtual</span> <a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> <a class="code hl_function" href="classiceberg_1_1Logger.html#a8d7d6a59ecbb0a1ba0ca79cbbb079540">level</a>() const noexcept = 0;</div> |
| <div class="line"><a id="l00177" name="l00177"></a><span class="lineno"> 177</span> </div> |
| <div class="line"><a id="l00179" name="l00179"></a><span class="lineno"><a class="line" href="classiceberg_1_1Logger.html#a2a1b632c1d153e90cf3faef8a29e6419"> 179</a></span> virtual <span class="keywordtype">void</span> Flush() noexcept {}</div> |
| <div class="line"><a id="l00180" name="l00180"></a><span class="lineno"> 180</span> </div> |
| <div class="line"><a id="l00182" name="l00182"></a><span class="lineno"><a class="line" href="classiceberg_1_1Logger.html#af869669496ecfff9c7de9b737bdbb404"> 182</a></span> <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code hl_function" href="classiceberg_1_1Logger.html#af869669496ecfff9c7de9b737bdbb404">IsNoop</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <span class="keyword">false</span>; }</div> |
| <div class="line"><a id="l00183" name="l00183"></a><span class="lineno"> 183</span> </div> |
| <div class="line"><a id="l00185" name="l00185"></a><span class="lineno"><a class="line" href="classiceberg_1_1Logger.html#a8f82381c82fb655b0441d2292787630b"> 185</a></span> <span class="keyword">static</span> std::shared_ptr<Logger> <a class="code hl_function" href="classiceberg_1_1Logger.html#a8f82381c82fb655b0441d2292787630b">Noop</a>();</div> |
| <div class="line"><a id="l00186" name="l00186"></a><span class="lineno"> 186</span>};</div> |
| </div> |
| <div class="line"><a id="l00187" name="l00187"></a><span class="lineno"> 187</span> </div> |
| <div class="line"><a id="l00192" name="l00192"></a><span class="lineno"><a class="line" href="namespaceiceberg.html#ae57e7ff8b112264aeee1c3f1a3699368"> 192</a></span>ICEBERG_EXPORT std::shared_ptr<Logger> <a class="code hl_function" href="namespaceiceberg.html#ae57e7ff8b112264aeee1c3f1a3699368">GetDefaultLogger</a>();</div> |
| <div class="line"><a id="l00193" name="l00193"></a><span class="lineno"> 193</span> </div> |
| <div class="line"><a id="l00200" name="l00200"></a><span class="lineno"><a class="line" href="namespaceiceberg.html#a71a0404fee81a92cc327ce2cec8c4290"> 200</a></span>ICEBERG_EXPORT std::shared_ptr<Logger> <a class="code hl_function" href="namespaceiceberg.html#a71a0404fee81a92cc327ce2cec8c4290">GetCurrentLogger</a>();</div> |
| <div class="line"><a id="l00201" name="l00201"></a><span class="lineno"> 201</span> </div> |
| <div class="line"><a id="l00206" name="l00206"></a><span class="lineno"><a class="line" href="namespaceiceberg.html#a35cc2730ee5d98264ab5d13080f8ad85"> 206</a></span>ICEBERG_EXPORT <span class="keywordtype">void</span> <a class="code hl_function" href="namespaceiceberg.html#a35cc2730ee5d98264ab5d13080f8ad85">SetDefaultLogger</a>(std::shared_ptr<Logger> logger);</div> |
| <div class="line"><a id="l00207" name="l00207"></a><span class="lineno"> 207</span> </div> |
| <div class="line"><a id="l00213" name="l00213"></a><span class="lineno"><a class="line" href="namespaceiceberg.html#a0b81ed84855eb9cd54fff60b220a6f01"> 213</a></span>ICEBERG_EXPORT <span class="keywordtype">void</span> <a class="code hl_function" href="namespaceiceberg.html#a0b81ed84855eb9cd54fff60b220a6f01">SetDefaultLevel</a>(<a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level);</div> |
| <div class="line"><a id="l00214" name="l00214"></a><span class="lineno"> 214</span> </div> |
| <div class="line"><a id="l00223" name="l00223"></a><span class="lineno"><a class="line" href="namespaceiceberg.html#a5fa767a899da421ad16b1fd321c5cb23"> 223</a></span><span class="keyword">using </span><a class="code hl_typedef" href="namespaceiceberg.html#a5fa767a899da421ad16b1fd321c5cb23">FatalHandler</a> =</div> |
| <div class="line"><a id="l00224" name="l00224"></a><span class="lineno"> 224</span> std::function<void(<span class="keyword">const</span> std::source_location&, std::string_view message)>;</div> |
| <div class="line"><a id="l00225" name="l00225"></a><span class="lineno"> 225</span> </div> |
| <div class="line"><a id="l00229" name="l00229"></a><span class="lineno"><a class="line" href="namespaceiceberg.html#a537acb53df4906ad2c82c396806ba477"> 229</a></span>ICEBERG_EXPORT <span class="keywordtype">void</span> <a class="code hl_function" href="namespaceiceberg.html#a537acb53df4906ad2c82c396806ba477">SetFatalHandler</a>(<a class="code hl_typedef" href="namespaceiceberg.html#a5fa767a899da421ad16b1fd321c5cb23">FatalHandler</a> handler);</div> |
| <div class="line"><a id="l00230" name="l00230"></a><span class="lineno"> 230</span> </div> |
| <div class="line"><a id="l00233" name="l00233"></a><span class="lineno"><a class="line" href="namespaceiceberg.html#a02c78b12379222b1535bd2531e40b89b"> 233</a></span>ICEBERG_EXPORT <a class="code hl_typedef" href="namespaceiceberg.html#a5fa767a899da421ad16b1fd321c5cb23">FatalHandler</a> <a class="code hl_function" href="namespaceiceberg.html#a02c78b12379222b1535bd2531e40b89b">GetFatalHandler</a>();</div> |
| <div class="line"><a id="l00234" name="l00234"></a><span class="lineno"> 234</span> </div> |
| <div class="foldopen" id="foldopen00256" data-start="{" data-end="};"> |
| <div class="line"><a id="l00256" name="l00256"></a><span class="lineno"><a class="line" href="classiceberg_1_1ScopedLogger.html"> 256</a></span><span class="keyword">class </span>ICEBERG_EXPORT <a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">ScopedLogger</a> {</div> |
| <div class="line"><a id="l00257" name="l00257"></a><span class="lineno"> 257</span> <span class="keyword">public</span>:</div> |
| <div class="line"><a id="l00258" name="l00258"></a><span class="lineno"> 258</span> <span class="keyword">explicit</span> <a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">ScopedLogger</a>(std::shared_ptr<Logger> logger) <span class="keyword">noexcept</span>;</div> |
| <div class="line"><a id="l00259" name="l00259"></a><span class="lineno"> 259</span> <a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">~ScopedLogger</a>();</div> |
| <div class="line"><a id="l00260" name="l00260"></a><span class="lineno"> 260</span> </div> |
| <div class="line"><a id="l00261" name="l00261"></a><span class="lineno"> 261</span> <a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">ScopedLogger</a>(<span class="keyword">const</span> <a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">ScopedLogger</a>&) = <span class="keyword">delete</span>;</div> |
| <div class="line"><a id="l00262" name="l00262"></a><span class="lineno"> 262</span> <a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">ScopedLogger</a>& operator=(<span class="keyword">const</span> <a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">ScopedLogger</a>&) = <span class="keyword">delete</span>;</div> |
| <div class="line"><a id="l00263" name="l00263"></a><span class="lineno"> 263</span> <a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">ScopedLogger</a>(<a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">ScopedLogger</a>&&) = <span class="keyword">delete</span>;</div> |
| <div class="line"><a id="l00264" name="l00264"></a><span class="lineno"> 264</span> <a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">ScopedLogger</a>& operator=(<a class="code hl_class" href="classiceberg_1_1ScopedLogger.html">ScopedLogger</a>&&) = <span class="keyword">delete</span>;</div> |
| <div class="line"><a id="l00265" name="l00265"></a><span class="lineno"> 265</span> </div> |
| <div class="line"><a id="l00266" name="l00266"></a><span class="lineno"> 266</span> <span class="keyword">private</span>:</div> |
| <div class="line"><a id="l00267" name="l00267"></a><span class="lineno"> 267</span> std::shared_ptr<Logger> previous_;</div> |
| <div class="line"><a id="l00268" name="l00268"></a><span class="lineno"> 268</span>};</div> |
| </div> |
| <div class="line"><a id="l00269" name="l00269"></a><span class="lineno"> 269</span> </div> |
| <div class="line"><a id="l00270" name="l00270"></a><span class="lineno"> 270</span><span class="comment">// ---------------------------------------------------------------------------</span></div> |
| <div class="line"><a id="l00271" name="l00271"></a><span class="lineno"> 271</span><span class="comment">// Using the API directly (the ICEBERG_LOG_* macros that wrap this live in</span></div> |
| <div class="line"><a id="l00272" name="l00272"></a><span class="lineno"> 272</span><span class="comment">// log_macros.h). Example: a custom sink, installed as the process default.</span></div> |
| <div class="line"><a id="l00273" name="l00273"></a><span class="lineno"> 273</span><span class="comment">//</span></div> |
| <div class="line"><a id="l00274" name="l00274"></a><span class="lineno"> 274</span><span class="comment">// class MySink : public Logger {</span></div> |
| <div class="line"><a id="l00275" name="l00275"></a><span class="lineno"> 275</span><span class="comment">// public:</span></div> |
| <div class="line"><a id="l00276" name="l00276"></a><span class="lineno"> 276</span><span class="comment">// bool ShouldLog(LogLevel level) const noexcept override { return level >= level_; }</span></div> |
| <div class="line"><a id="l00277" name="l00277"></a><span class="lineno"> 277</span><span class="comment">// void Log(LogMessage&& m) noexcept override { write_line(m.message); }</span></div> |
| <div class="line"><a id="l00278" name="l00278"></a><span class="lineno"> 278</span><span class="comment">// void SetLevel(LogLevel level) noexcept override { level_ = level; }</span></div> |
| <div class="line"><a id="l00279" name="l00279"></a><span class="lineno"> 279</span><span class="comment">// LogLevel level() const noexcept override { return level_; }</span></div> |
| <div class="line"><a id="l00280" name="l00280"></a><span class="lineno"> 280</span><span class="comment">// private:</span></div> |
| <div class="line"><a id="l00281" name="l00281"></a><span class="lineno"> 281</span><span class="comment">// std::atomic<LogLevel> level_{LogLevel::kInfo};</span></div> |
| <div class="line"><a id="l00282" name="l00282"></a><span class="lineno"> 282</span><span class="comment">// };</span></div> |
| <div class="line"><a id="l00283" name="l00283"></a><span class="lineno"> 283</span><span class="comment">//</span></div> |
| <div class="line"><a id="l00284" name="l00284"></a><span class="lineno"> 284</span><span class="comment">// SetDefaultLogger(std::make_shared<MySink>()); // install process-wide</span></div> |
| <div class="line"><a id="l00285" name="l00285"></a><span class="lineno"> 285</span><span class="comment">// SetDefaultLevel(LogLevel::kDebug); // adjust the threshold</span></div> |
| <div class="line"><a id="l00286" name="l00286"></a><span class="lineno"> 286</span><span class="comment">//</span></div> |
| <div class="line"><a id="l00287" name="l00287"></a><span class="lineno"> 287</span><span class="comment">// auto logger = GetDefaultLogger(); // borrow the current default</span></div> |
| <div class="line"><a id="l00288" name="l00288"></a><span class="lineno"> 288</span><span class="comment">// if (logger->ShouldLog(LogLevel::kInfo)) {</span></div> |
| <div class="line"><a id="l00289" name="l00289"></a><span class="lineno"> 289</span><span class="comment">// logger->Log(LogMessage{.level = LogLevel::kInfo, .message = "scan ready"});</span></div> |
| <div class="line"><a id="l00290" name="l00290"></a><span class="lineno"> 290</span><span class="comment">// }</span></div> |
| <div class="line"><a id="l00291" name="l00291"></a><span class="lineno"> 291</span><span class="comment">//</span></div> |
| <div class="line"><a id="l00292" name="l00292"></a><span class="lineno"> 292</span><span class="comment">// // Or configure from catalog-style properties (applies the "level" key):</span></div> |
| <div class="line"><a id="l00293" name="l00293"></a><span class="lineno"> 293</span><span class="comment">// auto sink = std::make_shared<MySink>();</span></div> |
| <div class="line"><a id="l00294" name="l00294"></a><span class="lineno"> 294</span><span class="comment">// auto status = sink->Initialize({{std::string(kLevelProperty), "warn"}}); // -> kWarn</span></div> |
| <div class="line"><a id="l00295" name="l00295"></a><span class="lineno"> 295</span><span class="comment">// ---------------------------------------------------------------------------</span></div> |
| <div class="line"><a id="l00296" name="l00296"></a><span class="lineno"> 296</span> </div> |
| <div class="line"><a id="l00297" name="l00297"></a><span class="lineno"> 297</span><span class="keyword">namespace </span>internal {</div> |
| <div class="line"><a id="l00298" name="l00298"></a><span class="lineno"> 298</span> </div> |
| <div class="line"><a id="l00301" name="l00301"></a><span class="lineno"> 301</span>ICEBERG_EXPORT std::unique_ptr<Logger> MakeNoopLogger();</div> |
| <div class="line"><a id="l00302" name="l00302"></a><span class="lineno"> 302</span> </div> |
| <div class="line"><a id="l00309" name="l00309"></a><span class="lineno"> 309</span>ICEBERG_EXPORT <span class="keyword">const</span> std::shared_ptr<Logger>& CurrentLogger() noexcept;</div> |
| <div class="line"><a id="l00310" name="l00310"></a><span class="lineno"> 310</span> </div> |
| <div class="line"><a id="l00315" name="l00315"></a><span class="lineno"> 315</span>ICEBERG_EXPORT <span class="keywordtype">void</span> Emit(<a class="code hl_class" href="classiceberg_1_1Logger.html">Logger</a>& logger, <a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level,</div> |
| <div class="line"><a id="l00316" name="l00316"></a><span class="lineno"> 316</span> const <a class="code hl_namespace" href="namespacestd.html">std</a>::source_location& location, <a class="code hl_namespace" href="namespacestd.html">std</a>::<span class="keywordtype">string</span>&& message);</div> |
| <div class="line"><a id="l00317" name="l00317"></a><span class="lineno"> 317</span> </div> |
| <div class="line"><a id="l00323" name="l00323"></a><span class="lineno"> 323</span>ICEBERG_EXPORT <span class="keywordtype">void</span> EmitFormatError(<a class="code hl_class" href="classiceberg_1_1Logger.html">Logger</a>& logger, <a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level,</div> |
| <div class="line"><a id="l00324" name="l00324"></a><span class="lineno"> 324</span> const <a class="code hl_namespace" href="namespacestd.html">std</a>::source_location& location) noexcept;</div> |
| <div class="line"><a id="l00325" name="l00325"></a><span class="lineno"> 325</span> </div> |
| <div class="line"><a id="l00332" name="l00332"></a><span class="lineno"> 332</span>template <typename... Args></div> |
| <div class="line"><a id="l00333" name="l00333"></a><span class="lineno"> 333</span>struct FmtWithLoc {</div> |
| <div class="line"><a id="l00334" name="l00334"></a><span class="lineno"> 334</span> std::format_string<Args...> fmt;</div> |
| <div class="line"><a id="l00335" name="l00335"></a><span class="lineno"> 335</span> std::source_location loc;</div> |
| <div class="line"><a id="l00336" name="l00336"></a><span class="lineno"> 336</span> </div> |
| <div class="line"><a id="l00337" name="l00337"></a><span class="lineno"> 337</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T></div> |
| <div class="line"><a id="l00338" name="l00338"></a><span class="lineno"> 338</span> <span class="keyword">requires</span> std::convertible_to<<span class="keyword">const</span> T&, std::format_string<Args...>></div> |
| <div class="line"><a id="l00339" name="l00339"></a><span class="lineno"> 339</span> <span class="keyword">consteval</span> FmtWithLoc( <span class="comment">// NOLINT(google-explicit-constructor): mirrors</span></div> |
| <div class="line"><a id="l00340" name="l00340"></a><span class="lineno"> 340</span> <span class="comment">// std::format_string</span></div> |
| <div class="line"><a id="l00341" name="l00341"></a><span class="lineno"> 341</span> <span class="keyword">const</span> T& s, std::source_location loc = std::source_location::current())</div> |
| <div class="line"><a id="l00342" name="l00342"></a><span class="lineno"> 342</span> : fmt(s), loc(loc) {}</div> |
| <div class="line"><a id="l00343" name="l00343"></a><span class="lineno"> 343</span>};</div> |
| <div class="line"><a id="l00344" name="l00344"></a><span class="lineno"> 344</span> </div> |
| <div class="line"><a id="l00349" name="l00349"></a><span class="lineno"> 349</span><span class="keyword">template</span> <<span class="keyword">typename</span>... Args></div> |
| <div class="line"><a id="l00350" name="l00350"></a><span class="lineno"> 350</span><span class="keywordtype">void</span> FormatAndEmit(Logger& logger, <a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level, <span class="keyword">const</span> std::source_location& loc,</div> |
| <div class="line"><a id="l00351" name="l00351"></a><span class="lineno"> 351</span> std::format_string<Args...> fmt, Args&&... args) <span class="keyword">noexcept</span> {</div> |
| <div class="line"><a id="l00352" name="l00352"></a><span class="lineno"> 352</span> <span class="keywordflow">if</span> (!logger.ShouldLog(level)) <span class="keywordflow">return</span>;</div> |
| <div class="line"><a id="l00353" name="l00353"></a><span class="lineno"> 353</span> <span class="keywordflow">try</span> {</div> |
| <div class="line"><a id="l00354" name="l00354"></a><span class="lineno"> 354</span> Emit(logger, level, loc, std::format(fmt, std::forward<Args>(args)...));</div> |
| <div class="line"><a id="l00355" name="l00355"></a><span class="lineno"> 355</span> } <span class="keywordflow">catch</span> (...) {</div> |
| <div class="line"><a id="l00356" name="l00356"></a><span class="lineno"> 356</span> <span class="comment">// Catch-all upholds the noexcept "logging never throws" guarantee: a</span></div> |
| <div class="line"><a id="l00357" name="l00357"></a><span class="lineno"> 357</span> <span class="comment">// user-defined std::formatter may throw a non-std::exception type, and this</span></div> |
| <div class="line"><a id="l00358" name="l00358"></a><span class="lineno"> 358</span> <span class="comment">// function is noexcept, so anything escaping here would call std::terminate.</span></div> |
| <div class="line"><a id="l00359" name="l00359"></a><span class="lineno"> 359</span> EmitFormatError(logger, level, loc);</div> |
| <div class="line"><a id="l00360" name="l00360"></a><span class="lineno"> 360</span> }</div> |
| <div class="line"><a id="l00361" name="l00361"></a><span class="lineno"> 361</span>}</div> |
| <div class="line"><a id="l00362" name="l00362"></a><span class="lineno"> 362</span> </div> |
| <div class="line"><a id="l00363" name="l00363"></a><span class="lineno"> 363</span>} <span class="comment">// namespace internal</span></div> |
| <div class="line"><a id="l00364" name="l00364"></a><span class="lineno"> 364</span> </div> |
| <div class="line"><a id="l00369" name="l00369"></a><span class="lineno"> 369</span><span class="keyword">template</span> <<span class="keyword">typename</span>... Args></div> |
| <div class="foldopen" id="foldopen00370" data-start="{" data-end="}"> |
| <div class="line"><a id="l00370" name="l00370"></a><span class="lineno"><a class="line" href="namespaceiceberg.html#a1aaf619fc9dbd574aa84dea9e41d3288"> 370</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="namespaceiceberg.html#a1aaf619fc9dbd574aa84dea9e41d3288">Log</a>(<a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level, internal::FmtWithLoc<std::type_identity_t<Args>...> fmt,</div> |
| <div class="line"><a id="l00371" name="l00371"></a><span class="lineno"> 371</span> Args&&... args) <span class="keyword">noexcept</span> {</div> |
| <div class="line"><a id="l00372" name="l00372"></a><span class="lineno"> 372</span> <span class="keyword">const</span> std::shared_ptr<Logger>& logger = internal::CurrentLogger();</div> |
| <div class="line"><a id="l00373" name="l00373"></a><span class="lineno"> 373</span> <span class="keywordflow">if</span> (logger) {</div> |
| <div class="line"><a id="l00374" name="l00374"></a><span class="lineno"> 374</span> internal::FormatAndEmit(*logger, level, fmt.loc, fmt.fmt,</div> |
| <div class="line"><a id="l00375" name="l00375"></a><span class="lineno"> 375</span> std::forward<Args>(args)...);</div> |
| <div class="line"><a id="l00376" name="l00376"></a><span class="lineno"> 376</span> }</div> |
| <div class="line"><a id="l00377" name="l00377"></a><span class="lineno"> 377</span>}</div> |
| </div> |
| <div class="line"><a id="l00378" name="l00378"></a><span class="lineno"> 378</span> </div> |
| <div class="line"><a id="l00382" name="l00382"></a><span class="lineno"> 382</span><span class="keyword">template</span> <<span class="keyword">typename</span>... Args></div> |
| <div class="foldopen" id="foldopen00383" data-start="{" data-end="}"> |
| <div class="line"><a id="l00383" name="l00383"></a><span class="lineno"><a class="line" href="namespaceiceberg.html#a74836705d924a88e5ce67dbfcd88a048"> 383</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="namespaceiceberg.html#a1aaf619fc9dbd574aa84dea9e41d3288">Log</a>(<a class="code hl_class" href="classiceberg_1_1Logger.html">Logger</a>& logger, <a class="code hl_enumeration" href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">LogLevel</a> level,</div> |
| <div class="line"><a id="l00384" name="l00384"></a><span class="lineno"> 384</span> internal::FmtWithLoc<std::type_identity_t<Args>...> fmt,</div> |
| <div class="line"><a id="l00385" name="l00385"></a><span class="lineno"> 385</span> Args&&... args) <span class="keyword">noexcept</span> {</div> |
| <div class="line"><a id="l00386" name="l00386"></a><span class="lineno"> 386</span> internal::FormatAndEmit(logger, level, fmt.loc, fmt.fmt, std::forward<Args>(args)...);</div> |
| <div class="line"><a id="l00387" name="l00387"></a><span class="lineno"> 387</span>}</div> |
| </div> |
| <div class="line"><a id="l00388" name="l00388"></a><span class="lineno"> 388</span> </div> |
| <div class="line"><a id="l00389" name="l00389"></a><span class="lineno"> 389</span>} <span class="comment">// namespace iceberg</span></div> |
| <div class="ttc" id="aclassiceberg_1_1Logger_html"><div class="ttname"><a href="classiceberg_1_1Logger.html">iceberg::Logger</a></div><div class="ttdoc">Pluggable logging sink.</div><div class="ttdef"><b>Definition</b> logger.h:146</div></div> |
| <div class="ttc" id="aclassiceberg_1_1Logger_html_a2cea7121351c84e8fe25a4fb2a1e52a3"><div class="ttname"><a href="classiceberg_1_1Logger.html#a2cea7121351c84e8fe25a4fb2a1e52a3">iceberg::Logger::Log</a></div><div class="ttdeci">virtual void Log(LogMessage &&message) noexcept=0</div><div class="ttdoc">Emit one (already-formatted) record, taking ownership. Must not throw.</div></div> |
| <div class="ttc" id="aclassiceberg_1_1Logger_html_a8d7d6a59ecbb0a1ba0ca79cbbb079540"><div class="ttname"><a href="classiceberg_1_1Logger.html#a8d7d6a59ecbb0a1ba0ca79cbbb079540">iceberg::Logger::level</a></div><div class="ttdeci">virtual LogLevel level() const noexcept=0</div><div class="ttdoc">Return the minimum level this logger emits.</div></div> |
| <div class="ttc" id="aclassiceberg_1_1Logger_html_a8f82381c82fb655b0441d2292787630b"><div class="ttname"><a href="classiceberg_1_1Logger.html#a8f82381c82fb655b0441d2292787630b">iceberg::Logger::Noop</a></div><div class="ttdeci">static std::shared_ptr< Logger > Noop()</div><div class="ttdoc">Return a shared, immortal no-op logger singleton.</div></div> |
| <div class="ttc" id="aclassiceberg_1_1Logger_html_a929efd366d31507b1d0fb0f20cc981ac"><div class="ttname"><a href="classiceberg_1_1Logger.html#a929efd366d31507b1d0fb0f20cc981ac">iceberg::Logger::SetLevel</a></div><div class="ttdeci">virtual void SetLevel(LogLevel level) noexcept=0</div><div class="ttdoc">Set the minimum level this logger emits.</div></div> |
| <div class="ttc" id="aclassiceberg_1_1Logger_html_ae94e42dfc0fe122f056c54049f6b751f"><div class="ttname"><a href="classiceberg_1_1Logger.html#ae94e42dfc0fe122f056c54049f6b751f">iceberg::Logger::ShouldLog</a></div><div class="ttdeci">virtual bool ShouldLog(LogLevel level) const noexcept=0</div><div class="ttdoc">Cheap check whether a record at level would be emitted.</div></div> |
| <div class="ttc" id="aclassiceberg_1_1Logger_html_af869669496ecfff9c7de9b737bdbb404"><div class="ttname"><a href="classiceberg_1_1Logger.html#af869669496ecfff9c7de9b737bdbb404">iceberg::Logger::IsNoop</a></div><div class="ttdeci">virtual bool IsNoop() const</div><div class="ttdoc">Return true if this logger is a no-op.</div><div class="ttdef"><b>Definition</b> logger.h:182</div></div> |
| <div class="ttc" id="aclassiceberg_1_1Logger_html_afb2309f921f8ebb7aa88ada353f37877"><div class="ttname"><a href="classiceberg_1_1Logger.html#afb2309f921f8ebb7aa88ada353f37877">iceberg::Logger::Initialize</a></div><div class="ttdeci">virtual Status Initialize(const std::unordered_map< std::string, std::string > &properties)</div><div class="ttdoc">Property-based setup, called by Loggers::Load() before first use.</div><div class="ttdef"><b>Definition</b> logger.h:156</div></div> |
| <div class="ttc" id="aclassiceberg_1_1ScopedLogger_html"><div class="ttname"><a href="classiceberg_1_1ScopedLogger.html">iceberg::ScopedLogger</a></div><div class="ttdoc">Bind a logger for the current thread until this object leaves scope.</div><div class="ttdef"><b>Definition</b> logger.h:256</div></div> |
| <div class="ttc" id="aiceberg__export_8h_html"><div class="ttname"><a href="iceberg__export_8h.html">iceberg_export.h</a></div><div class="ttdoc">Define symbol visibility macros for core Iceberg APIs.</div></div> |
| <div class="ttc" id="alog__level_8h_html"><div class="ttname"><a href="log__level_8h.html">log_level.h</a></div><div class="ttdoc">Severity levels for the logging system.</div></div> |
| <div class="ttc" id="anamespaceiceberg_html"><div class="ttname"><a href="namespaceiceberg.html">iceberg</a></div><div class="ttdoc">Core Apache Iceberg C++ APIs.</div><div class="ttdef"><b>Definition</b> arrow_io_util.h:33</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_a02c78b12379222b1535bd2531e40b89b"><div class="ttname"><a href="namespaceiceberg.html#a02c78b12379222b1535bd2531e40b89b">iceberg::GetFatalHandler</a></div><div class="ttdeci">ICEBERG_EXPORT FatalHandler GetFatalHandler()</div><div class="ttdoc">Return the installed fatal handler (empty if none). Used by the fatal logging path; thread-safe.</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_a0b81ed84855eb9cd54fff60b220a6f01"><div class="ttname"><a href="namespaceiceberg.html#a0b81ed84855eb9cd54fff60b220a6f01">iceberg::SetDefaultLevel</a></div><div class="ttdeci">ICEBERG_EXPORT void SetDefaultLevel(LogLevel level)</div><div class="ttdoc">Set the minimum level of the current default logger.</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_a1aaf619fc9dbd574aa84dea9e41d3288"><div class="ttname"><a href="namespaceiceberg.html#a1aaf619fc9dbd574aa84dea9e41d3288">iceberg::Log</a></div><div class="ttdeci">void Log(LogLevel level, internal::FmtWithLoc< std::type_identity_t< Args >... > fmt, Args &&... args) noexcept</div><div class="ttdoc">Log to the process-default logger, std::format style. Formats only if the level is enabled; never thr...</div><div class="ttdef"><b>Definition</b> logger.h:370</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_a35cc2730ee5d98264ab5d13080f8ad85"><div class="ttname"><a href="namespaceiceberg.html#a35cc2730ee5d98264ab5d13080f8ad85">iceberg::SetDefaultLogger</a></div><div class="ttdeci">ICEBERG_EXPORT void SetDefaultLogger(std::shared_ptr< Logger > logger)</div><div class="ttdoc">Install a new process-global default logger.</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_a50de3c8be4e894522604dd11f33dbf92"><div class="ttname"><a href="namespaceiceberg.html#a50de3c8be4e894522604dd11f33dbf92">iceberg::kLevelProperty</a></div><div class="ttdeci">constexpr std::string_view kLevelProperty</div><div class="ttdoc">Well-known Logger::Initialize() property keys.</div><div class="ttdef"><b>Definition</b> logger.h:133</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_a537acb53df4906ad2c82c396806ba477"><div class="ttname"><a href="namespaceiceberg.html#a537acb53df4906ad2c82c396806ba477">iceberg::SetFatalHandler</a></div><div class="ttdeci">ICEBERG_EXPORT void SetFatalHandler(FatalHandler handler)</div><div class="ttdoc">Install (or clear, with nullptr) the process-global fatal handler.</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_a5fa767a899da421ad16b1fd321c5cb23"><div class="ttname"><a href="namespaceiceberg.html#a5fa767a899da421ad16b1fd321c5cb23">iceberg::FatalHandler</a></div><div class="ttdeci">std::function< void(const std::source_location &, std::string_view message)> FatalHandler</div><div class="ttdoc">A hook invoked on the fatal-log path just before std::abort().</div><div class="ttdef"><b>Definition</b> logger.h:224</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_a71a0404fee81a92cc327ce2cec8c4290"><div class="ttname"><a href="namespaceiceberg.html#a71a0404fee81a92cc327ce2cec8c4290">iceberg::GetCurrentLogger</a></div><div class="ttdeci">ICEBERG_EXPORT std::shared_ptr< Logger > GetCurrentLogger()</div><div class="ttdoc">Return the effective logger for this thread (never null): the active ScopedLogger binding if any,...</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_aaea6a2e5653e5da40a93d0d855c1836e"><div class="ttname"><a href="namespaceiceberg.html#aaea6a2e5653e5da40a93d0d855c1836e">iceberg::LogLevelFromString</a></div><div class="ttdeci">Result< LogLevel > LogLevelFromString(std::string_view s)</div><div class="ttdoc">Parse a LogLevel from a string (case-insensitive).</div><div class="ttdef"><b>Definition</b> log_level.h:77</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_ab9922ae0d07dc85678a1a86c872e387b"><div class="ttname"><a href="namespaceiceberg.html#ab9922ae0d07dc85678a1a86c872e387b">iceberg::LogLevel</a></div><div class="ttdeci">LogLevel</div><div class="ttdoc">Logging severity level, ordered from most to least verbose.</div><div class="ttdef"><b>Definition</b> log_level.h:38</div></div> |
| <div class="ttc" id="anamespaceiceberg_html_ae57e7ff8b112264aeee1c3f1a3699368"><div class="ttname"><a href="namespaceiceberg.html#ae57e7ff8b112264aeee1c3f1a3699368">iceberg::GetDefaultLogger</a></div><div class="ttdeci">ICEBERG_EXPORT std::shared_ptr< Logger > GetDefaultLogger()</div><div class="ttdoc">Return the process-global default logger (never null).</div></div> |
| <div class="ttc" id="anamespacestd_html"><div class="ttname"><a href="namespacestd.html">std</a></div><div class="ttdoc">STL namespace.</div></div> |
| <div class="ttc" id="aresult_8h_html"><div class="ttname"><a href="result_8h.html">result.h</a></div><div class="ttdoc">Define Result, Status, and error helpers.</div></div> |
| <div class="ttc" id="astructiceberg_1_1LogAttribute_html"><div class="ttname"><a href="structiceberg_1_1LogAttribute.html">iceberg::LogAttribute</a></div><div class="ttdoc">A structured key/value attribute attached to a log record.</div><div class="ttdef"><b>Definition</b> logger.h:53</div></div> |
| <div class="ttc" id="astructiceberg_1_1LogMessage_html"><div class="ttname"><a href="structiceberg_1_1LogMessage.html">iceberg::LogMessage</a></div><div class="ttdoc">A single log record handed to a Logger.</div><div class="ttdef"><b>Definition</b> logger.h:65</div></div> |
| <div class="ttc" id="astructiceberg_1_1LogMessage_html_a0af92d415ebac01e9af51071c039c2a6"><div class="ttname"><a href="structiceberg_1_1LogMessage.html#a0af92d415ebac01e9af51071c039c2a6">iceberg::LogMessage::Location</a></div><div class="ttdeci">Builder & Location(std::source_location location)</div><div class="ttdoc">Override the record's source location (defaults to the build site).</div><div class="ttdef"><b>Definition</b> logger.h:107</div></div> |
| <div class="ttc" id="astructiceberg_1_1LogMessage_html_a2409e275f406fd2cc0f3764dfc0da150"><div class="ttname"><a href="structiceberg_1_1LogMessage.html#a2409e275f406fd2cc0f3764dfc0da150">iceberg::LogMessage::Build</a></div><div class="ttdeci">LogMessage Build()</div><div class="ttdoc">Materialize the LogMessage, moving the accumulated state out.</div><div class="ttdef"><b>Definition</b> logger.h:113</div></div> |
| <div class="ttc" id="astructiceberg_1_1LogMessage_html_ac07aa97063a1e2d64edbdeaa7024b3e9"><div class="ttname"><a href="structiceberg_1_1LogMessage.html#ac07aa97063a1e2d64edbdeaa7024b3e9">iceberg::LogMessage::Attribute</a></div><div class="ttdeci">Builder & Attribute(std::string key, std::string value)</div><div class="ttdoc">Append a structured key/value attribute.</div><div class="ttdef"><b>Definition</b> logger.h:101</div></div> |
| <div class="ttc" id="astructiceberg_1_1LogMessage_html_ae4dc68fcc2d7a4f560519a970c473544"><div class="ttname"><a href="structiceberg_1_1LogMessage.html#ae4dc68fcc2d7a4f560519a970c473544">iceberg::LogMessage::Message</a></div><div class="ttdeci">Builder & Message(std::string message)</div><div class="ttdoc">Set the already-formatted message text.</div><div class="ttdef"><b>Definition</b> logger.h:95</div></div> |
| </div><!-- fragment --></div><!-- contents --> |
| <!-- start footer part --> |
| <hr class="footer"/><address class="footer"><small> |
| Generated by <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> |
