1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
|
<!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>
<title>Class Poco::Logger</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<meta name="author" content="Applied Informatics Software Engineering GmbH and Contributors"/>
<meta name="publisher" content="Applied Informatics Software Engineering GmbH and Contributors"/>
<meta name="copyright" content="Copyright (c) 2009, Applied Informatics Software Engineering GmbH and Contributors"/>
<meta name="language" content="en"/>
<meta name="date" content="2009-11-24"/>
<meta name="generator" content="PocoDoc"/>
<link rel="stylesheet" href="css/styles.css" type="text/css"/>
</head>
<body bgcolor="#ffffff" leftmargin="0" topmargin="0">
<div class="header">
<h1 class="namespace"><a href="Poco.html" class="namespace">Poco</a></h1>
<h1 class="symbol">class Logger</h1>
</div>
<div class="body">
<p>
<b>Library:</b> Foundation<br />
<b>Package:</b> Logging<br />
<b>Header:</b> Poco/Logger.h</p>
<h2>Description</h2>
<div class="description">
<p><a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> is a special <a href="Poco.Channel.html" title="class Poco::Channel">Channel</a> that acts as the main entry point into the logging framework. </p>
<p>An application uses instances of the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> class to generate its log messages and send them on their way to their final destination. <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> instances are organized in a hierarchical, tree-like manner and are maintained by the framework. Every <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> object has exactly one direct ancestor, with the exception of the root logger. A newly created logger inherits its properties - channel and level - from its direct ancestor. Every logger is connected to a channel, to which it passes on its messages. Furthermore, every logger has a log level, which is used for filtering messages based on their priority. Only messages with a priority equal to or higher than the specified level are passed on. For example, if the level of a logger is set to three (PRIO_ERROR), only messages with priority PRIO_ERROR, PRIO_CRITICAL and PRIO_FATAL will propagate. If the level is set to zero, the logger is effectively disabled. </p>
<p>The name of a logger determines the logger's place within the logger hierarchy. The name of the root logger is always "", the empty string. For all other loggers, the name is made up of one or more components, separated by a period. For example, the loggers with the name HTTPServer.RequestHandler and HTTPServer.Listener are descendants of the logger HTTPServer, which itself is a descendant of the root logger. There is not limit as to how deep the logger hierarchy can become. Once a logger has been created and it has inherited the channel and level from its ancestor, it loses the connection to it. So changes to the level or channel of a logger do not affect its descendants. This greatly simplifies the implementation of the framework and is no real restriction, because almost always levels and channels are set up at application startup and never changed afterwards. Nevertheless, there are methods to simultaneously change the level and channel of all loggers in a certain hierarchy. </p>
</div>
<h2>Inheritance</h2>
<p><b>Direct Base Classes: </b><a href="Poco.Channel.html" title="class Poco::Channel">Channel</a></p>
<p><b>All Base Classes: </b><a href="Poco.Channel.html" title="class Poco::Channel">Channel</a>, <a href="Poco.Configurable.html" title="class Poco::Configurable">Configurable</a>, <a href="Poco.RefCountedObject.html" title="class Poco::RefCountedObject">RefCountedObject</a></p>
<h2>Member Summary</h2>
<p><b>Member Functions: </b><a href="Poco.Logger.html#8165" title="Poco::Logger::add()">add</a>, <a href="Poco.Logger.html#8133" title="Poco::Logger::create()">create</a>, <a href="Poco.Logger.html#8072" title="Poco::Logger::critical()">critical</a>, <a href="Poco.Logger.html#8082" title="Poco::Logger::debug()">debug</a>, <a href="Poco.Logger.html#8140" title="Poco::Logger::destroy()">destroy</a>, <a href="Poco.Logger.html#8086" title="Poco::Logger::dump()">dump</a>, <a href="Poco.Logger.html#8074" title="Poco::Logger::error()">error</a>, <a href="Poco.Logger.html#8070" title="Poco::Logger::fatal()">fatal</a>, <a href="Poco.Logger.html#8167" title="Poco::Logger::find()">find</a>, <a href="Poco.Logger.html#8101" title="Poco::Logger::format()">format</a>, <a href="Poco.Logger.html#8159" title="Poco::Logger::formatDump()">formatDump</a>, <a href="Poco.Logger.html#8129" title="Poco::Logger::get()">get</a>, <a href="Poco.Logger.html#8057" title="Poco::Logger::getChannel()">getChannel</a>, <a href="Poco.Logger.html#8060" title="Poco::Logger::getLevel()">getLevel</a>, <a href="Poco.Logger.html#8138" title="Poco::Logger::has()">has</a>, <a href="Poco.Logger.html#8080" title="Poco::Logger::information()">information</a>, <a href="Poco.Logger.html#8091" title="Poco::Logger::is()">is</a>, <a href="Poco.Logger.html#8066" title="Poco::Logger::log()">log</a>, <a href="Poco.Logger.html#8054" title="Poco::Logger::name()">name</a>, <a href="Poco.Logger.html#8143" title="Poco::Logger::names()">names</a>, <a href="Poco.Logger.html#8078" title="Poco::Logger::notice()">notice</a>, <a href="Poco.Logger.html#8163" title="Poco::Logger::parent()">parent</a>, <a href="Poco.Logger.html#8137" title="Poco::Logger::root()">root</a>, <a href="Poco.Logger.html#8055" title="Poco::Logger::setChannel()">setChannel</a>, <a href="Poco.Logger.html#8058" title="Poco::Logger::setLevel()">setLevel</a>, <a href="Poco.Logger.html#8063" title="Poco::Logger::setProperty()">setProperty</a>, <a href="Poco.Logger.html#8142" title="Poco::Logger::shutdown()">shutdown</a>, <a href="Poco.Logger.html#8084" title="Poco::Logger::trace()">trace</a>, <a href="Poco.Logger.html#8131" title="Poco::Logger::unsafeGet()">unsafeGet</a>, <a href="Poco.Logger.html#8076" title="Poco::Logger::warning()">warning</a></p>
<p><b>Inherited Functions: </b><a href="Poco.Channel.html#4145" title="Poco::Channel::close()">close</a>, <a href="Poco.RefCountedObject.html#9659" title="Poco::RefCountedObject::duplicate()">duplicate</a>, <a href="Poco.Channel.html#4151" title="Poco::Channel::getProperty()">getProperty</a>, <a href="Poco.Channel.html#4146" title="Poco::Channel::log()">log</a>, <a href="Poco.Channel.html#4144" title="Poco::Channel::open()">open</a>, <a href="Poco.RefCountedObject.html#9661" title="Poco::RefCountedObject::referenceCount()">referenceCount</a>, <a href="Poco.RefCountedObject.html#9660" title="Poco::RefCountedObject::release()">release</a>, <a href="Poco.Channel.html#4148" title="Poco::Channel::setProperty()">setProperty</a></p>
<h2>Types</h2>
<h3><a name="8146">LoggerMap</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">typedef std::map < std::string, <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> * > <a href="Poco.Logger.html#8146" title="Poco::Logger::LoggerMap">LoggerMap</a>;</p>
<div class="description">
<p></p>
</div>
<h2>Constructors</h2>
<h3><a name="8147">Logger</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl"><a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>(<br /> const std::string & name,<br /> <a href="Poco.Channel.html" title="class Poco::Channel">Channel</a> * pChannel,<br /> int level<br />);</p>
<div class="description">
<p></p>
</div>
<h2>Destructor</h2>
<h3><a name="8151">~Logger</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">~<a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>();</p>
<div class="description">
<p></p>
</div>
<h2>Member Functions</h2>
<h3><a name="8133">create</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> & create(<br /> const std::string & name,<br /> <a href="Poco.Channel.html" title="class Poco::Channel">Channel</a> * pChannel,<br /> int level = Message::PRIO_INFORMATION<br />);</p>
<div class="description">
<p>Creates and returns a reference to a <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> with the given name. The <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s <a href="Poco.Channel.html" title="class Poco::Channel">Channel</a> and log level as set as specified. </p>
</div>
<h3><a name="8072">critical</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void critical(<br /> const std::string & msg<br />);</p>
<div class="description">
<p>If the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level is at least PRIO_CRITICAL, creates a <a href="Poco.Message.html" title="class Poco::Message">Message</a> with priority PRIO_CRITICAL and the given message text and sends it to the attached channel. </p>
</div>
<h3><a name="8094">critical</a></h3>
<p class="decl">bool critical() const;</p>
<div class="description">
<p>Returns true if the log level is at least PRIO_CRITICAL. </p>
</div>
<h3><a name="8082">debug</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void debug(<br /> const std::string & msg<br />);</p>
<div class="description">
<p>If the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level is at least PRIO_DEBUG, creates a <a href="Poco.Message.html" title="class Poco::Message">Message</a> with priority PRIO_DEBUG and the given message text and sends it to the attached channel. </p>
</div>
<h3><a name="8099">debug</a></h3>
<p class="decl">bool debug() const;</p>
<div class="description">
<p>Returns true if the log level is at least PRIO_DEBUG. </p>
</div>
<h3><a name="8140">destroy</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void destroy(<br /> const std::string & name<br />);</p>
<div class="description">
<p>Destroys the logger with the specified name. Does nothing if the logger is not found. </p>
<p>After a logger has been destroyed, all references to it become invalid. </p>
</div>
<h3><a name="8086">dump</a></h3>
<p class="decl">void dump(<br /> const std::string & msg,<br /> const void * buffer,<br /> std::size_t length,<br /> <a href="Poco.Message.html#8424" title="enum Poco::Message::Priority">Message::Priority</a> prio = Message::PRIO_DEBUG<br />);</p>
<div class="description">
<p>Logs the given message, followed by the data in buffer. </p>
<p>The data in buffer is written in canonical hex+ASCII form: Offset (4 bytes) in hexadecimal, followed by sixteen space-separated, two column, hexadecimal bytes, followed by the same sixteen bytes as ASCII characters. For bytes outside the range 32 .. 127, a dot is printed. </p>
</div>
<h3><a name="8074">error</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void error(<br /> const std::string & msg<br />);</p>
<div class="description">
<p>If the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level is at least PRIO_ERROR, creates a <a href="Poco.Message.html" title="class Poco::Message">Message</a> with priority PRIO_ERROR and the given message text and sends it to the attached channel. </p>
</div>
<h3><a name="8095">error</a></h3>
<p class="decl">bool error() const;</p>
<div class="description">
<p>Returns true if the log level is at least PRIO_ERROR. </p>
</div>
<h3><a name="8070">fatal</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void fatal(<br /> const std::string & msg<br />);</p>
<div class="description">
<p>If the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level is at least PRIO_FATAL, creates a <a href="Poco.Message.html" title="class Poco::Message">Message</a> with priority PRIO_FATAL and the given message text and sends it to the attached channel. </p>
</div>
<h3><a name="8093">fatal</a></h3>
<p class="decl">bool fatal() const;</p>
<div class="description">
<p>Returns true if the log level is at least PRIO_FATAL. </p>
</div>
<h3><a name="8101">format</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string format(<br /> const std::string & fmt,<br /> const std::string & arg<br />);</p>
<div class="description">
<p>Replaces all occurences of $0 in fmt with the string given in arg and returns the result. To include a dollar sign in the result string, specify two dollar signs ($$) in the format string. </p>
</div>
<h3><a name="8104">format</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string format(<br /> const std::string & fmt,<br /> const std::string & arg0,<br /> const std::string & arg1<br />);</p>
<div class="description">
<p>Replaces all occurences of $<n> in fmt with the string given in arg<n> and returns the result. To include a dollar sign in the result string, specify two dollar signs ($$) in the format string. </p>
</div>
<h3><a name="8108">format</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string format(<br /> const std::string & fmt,<br /> const std::string & arg0,<br /> const std::string & arg1,<br /> const std::string & arg2<br />);</p>
<div class="description">
<p>Replaces all occurences of $<n> in fmt with the string given in arg<n> and returns the result. To include a dollar sign in the result string, specify two dollar signs ($$) in the format string. </p>
</div>
<h3><a name="8113">format</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string format(<br /> const std::string & fmt,<br /> const std::string & arg0,<br /> const std::string & arg1,<br /> const std::string & arg2,<br /> const std::string & arg3<br />);</p>
<div class="description">
<p>Replaces all occurences of $<n> in fmt with the string given in arg<n> and returns the result. To include a dollar sign in the result string, specify two dollar signs ($$) in the format string. </p>
</div>
<h3><a name="8129">get</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> & get(<br /> const std::string & name<br />);</p>
<div class="description">
<p>Returns a reference to the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> with the given name. If the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> does not yet exist, it is created, based on its parent logger. </p>
</div>
<h3><a name="8057">getChannel</a></h3>
<p class="decl"><a href="Poco.Channel.html" title="class Poco::Channel">Channel</a> * getChannel() const;</p>
<div class="description">
<p>Returns the <a href="Poco.Channel.html" title="class Poco::Channel">Channel</a> attached to the logger. </p>
</div>
<h3><a name="8060">getLevel</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">int getLevel() const;</p>
<div class="description">
<p>Returns the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level. </p>
</div>
<h3><a name="8138">has</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> * has(<br /> const std::string & name<br />);</p>
<div class="description">
<p>Returns a pointer to the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> with the given name if it exists, or a null pointer otherwse. </p>
</div>
<h3><a name="8080">information</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void information(<br /> const std::string & msg<br />);</p>
<div class="description">
<p>If the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level is at least PRIO_INFORMATION, creates a <a href="Poco.Message.html" title="class Poco::Message">Message</a> with priority PRIO_INFORMATION and the given message text and sends it to the attached channel. </p>
</div>
<h3><a name="8098">information</a></h3>
<p class="decl">bool information() const;</p>
<div class="description">
<p>Returns true if the log level is at least PRIO_INFORMATION. </p>
</div>
<h3><a name="8091">is</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">bool is(<br /> int level<br />) const;</p>
<div class="description">
<p>Returns true if at least the given log level is set. </p>
</div>
<h3><a name="8066">log</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void log(<br /> const <a href="Poco.Message.html" title="class Poco::Message">Message</a> & msg<br />);</p>
<div class="description">
<p>Logs the given message if its priority is greater than or equal to the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level. </p>
</div>
<div class="description"><p><b>See also:</b> <a href="Poco.Channel.html#4146" title="Poco::Channel::log()">Poco::Channel::log()</a></p></div>
<h3><a name="8068">log</a></h3>
<p class="decl">void log(<br /> const <a href="Poco.Exception.html" title="class Poco::Exception">Exception</a> & exc<br />);</p>
<div class="description">
<p>Logs the given exception with priority PRIO_ERROR. </p>
</div>
<h3><a name="8054">name</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">const std::string & name() const;</p>
<div class="description">
<p>Returns the name of the logger, which is set as the message source on all messages created by the logger. </p>
</div>
<h3><a name="8143">names</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void names(<br /> std::vector < std::string > & names<br />);</p>
<div class="description">
<p>Fills the given vector with the names of all currently defined loggers. </p>
</div>
<h3><a name="8078">notice</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void notice(<br /> const std::string & msg<br />);</p>
<div class="description">
<p>If the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level is at least PRIO_NOTICE, creates a <a href="Poco.Message.html" title="class Poco::Message">Message</a> with priority PRIO_NOTICE and the given message text and sends it to the attached channel. </p>
</div>
<h3><a name="8097">notice</a></h3>
<p class="decl">bool notice() const;</p>
<div class="description">
<p>Returns true if the log level is at least PRIO_NOTICE. </p>
</div>
<h3><a name="8137">root</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> & root();</p>
<div class="description">
<p>Returns a reference to the root logger, which is the ultimate ancestor of all Loggers. </p>
</div>
<h3><a name="8055">setChannel</a></h3>
<p class="decl">void setChannel(<br /> <a href="Poco.Channel.html" title="class Poco::Channel">Channel</a> * pChannel<br />);</p>
<div class="description">
<p>Attaches the given <a href="Poco.Channel.html" title="class Poco::Channel">Channel</a> to the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>. </p>
</div>
<h3><a name="8122">setChannel</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void setChannel(<br /> const std::string & name,<br /> <a href="Poco.Channel.html" title="class Poco::Channel">Channel</a> * pChannel<br />);</p>
<div class="description">
<p>Attaches the given <a href="Poco.Channel.html" title="class Poco::Channel">Channel</a> to all loggers that are descendants of the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> with the given name. </p>
</div>
<h3><a name="8058">setLevel</a></h3>
<p class="decl">void setLevel(<br /> int level<br />);</p>
<div class="description">
<p>Sets the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level. </p>
</div>
<h3><a name="8061">setLevel</a></h3>
<p class="decl">void setLevel(<br /> const std::string & level<br />);</p>
<div class="description">
<p>Sets the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level using a symbolic value. </p>
<p>Valid values are: </p>
<ul>
<li>fatal </li>
<li>critical </li>
<li>error </li>
<li>warning </li>
<li>notice </li>
<li>information </li>
<li>debug </li>
<li>trace </li>
</ul>
</div>
<h3><a name="8119">setLevel</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void setLevel(<br /> const std::string & name,<br /> int level<br />);</p>
<div class="description">
<p>Sets the given log level on all loggers that are descendants of the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> with the given name. </p>
</div>
<h3><a name="8063">setProperty</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void setProperty(<br /> const std::string & name,<br /> const std::string & value<br />);</p>
<div class="description">
<p>Sets or changes a configuration property. </p>
<p>Only the "channel" and "level" properties are supported, which allow setting the target channel and log level, respectively, via the <a href="Poco.LoggingRegistry.html" title="class Poco::LoggingRegistry">LoggingRegistry</a>. The "channel" and "level" properties are set-only. </p>
</div>
<div class="description"><p><b>See also:</b> <a href="Poco.Channel.html#4148" title="Poco::Channel::setProperty()">Poco::Channel::setProperty()</a></p></div>
<h3><a name="8125">setProperty</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void setProperty(<br /> const std::string & loggerName,<br /> const std::string & propertyName,<br /> const std::string & value<br />);</p>
<div class="description">
<p>Sets or changes a configuration property for all loggers that are descendants of the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> with the given name. </p>
</div>
<h3><a name="8142">shutdown</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void shutdown();</p>
<div class="description">
<p>Shuts down the logging framework and releases all Loggers. </p>
</div>
<h3><a name="8084">trace</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void trace(<br /> const std::string & msg<br />);</p>
<div class="description">
<p>If the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level is at least PRIO_TRACE, creates a <a href="Poco.Message.html" title="class Poco::Message">Message</a> with priority PRIO_TRACE and the given message text and sends it to the attached channel. </p>
</div>
<h3><a name="8100">trace</a></h3>
<p class="decl">bool trace() const;</p>
<div class="description">
<p>Returns true if the log level is at least PRIO_TRACE. </p>
</div>
<h3><a name="8131">unsafeGet</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> & unsafeGet(<br /> const std::string & name<br />);</p>
<div class="description">
<p>Returns a reference to the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> with the given name. If the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> does not yet exist, it is created, based on its parent logger. </p>
<p>WARNING: This method is not thread safe. You should probably use <a href="Poco.Logger.html#8129" title="Poco::Logger::get()">get</a>() instead. The only time this method should be used is during program initialization, when only one thread is running. </p>
</div>
<h3><a name="8076">warning</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void warning(<br /> const std::string & msg<br />);</p>
<div class="description">
<p>If the <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a>'s log level is at least PRIO_WARNING, creates a <a href="Poco.Message.html" title="class Poco::Message">Message</a> with priority PRIO_WARNING and the given message text and sends it to the attached channel. </p>
</div>
<h3><a name="8096">warning</a></h3>
<p class="decl">bool warning() const;</p>
<div class="description">
<p>Returns true if the log level is at least PRIO_WARNING. </p>
</div>
<h3><a name="8165">add</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void add(<br /> <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> * pLogger<br />);</p>
<div class="description">
<p></p>
</div>
<h3><a name="8167">find</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> * find(<br /> const std::string & name<br />);</p>
<div class="description">
<p></p>
</div>
<h3><a name="8155">format</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string format(<br /> const std::string & fmt,<br /> int argc,<br /> std::string argv[]<br />);</p>
<div class="description">
<p></p>
</div>
<h3><a name="8159">formatDump</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void formatDump(<br /> std::string & message,<br /> const void * buffer,<br /> std::size_t length<br />);</p>
<div class="description">
<p></p>
</div>
<h3><a name="8152">log</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void log(<br /> const std::string & text,<br /> <a href="Poco.Message.html#8424" title="enum Poco::Message::Priority">Message::Priority</a> prio<br />);</p>
<div class="description">
<p></p>
</div>
<h3><a name="8163">parent</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.Logger.html" title="class Poco::Logger">Logger</a> & parent(<br /> const std::string & name<br />);</p>
<div class="description">
<p></p>
</div>
<h2>Variables</h2>
<h3><a name="8145">ROOT</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static const std::string <a href="Poco.Logger.html#8145" title="Poco::Logger::ROOT">ROOT</a>;</p>
<div class="description">
<p>The name of the root logger (""). </p>
</div>
<p class="footer">POCO C++ Libraries 1.3.6-all<br />
Copyright © 2009, <a href="http://pocoproject.org/" target="_blank">Applied Informatics Software Engineering GmbH and Contributors</a></p>
</div>
</body>
</html>
|
