1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
<html><head><meta name="robots" content="noindex">
3
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
4
<title>log4cpp::CategoryStream class Reference</title>
5
<link href="doxygen.css" rel="stylesheet" type="text/css">
6
</head><body bgcolor="#ffffff">
7
<!-- Generated by Doxygen 1.2.6 -->
9
<a class="qindex" href="index.html">Main Page</a> <a class="qindex" href="namespaces.html">Namespace List</a> <a class="qindex" href="hierarchy.html">Class Hierarchy</a> <a class="qindex" href="annotated.html">Compound List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="namespacemembers.html">Namespace Members</a> <a class="qindex" href="functions.html">Compound Members</a> <a class="qindex" href="globals.html">File Members</a> </center>
10
<hr><h1>log4cpp::CategoryStream Class Reference</h1>This class enables streaming simple types and objects to a category.
11
<a href="#_details">More...</a>
13
<code>#include <<a class="el" href="Category_hh-source.html">Category.hh</a>></code>
15
Collaboration diagram for log4cpp::CategoryStream:<p><center><img src="class_log4cpp__CategoryStream_coll_graph.gif" border="0" usemap="#log4cpp::CategoryStream_coll_map" alt="Collaboration graph"></center>
16
<map name="log4cpp::CategoryStream_coll_map">
17
<area href="class_log4cpp__OstringStream.html" shape="rect" coords="0,166,141,184">
18
<area href="class_std__ostrstream.html" shape="rect" coords="25,83,116,102">
19
<area href="class_log4cpp__Category.html" shape="rect" coords="165,166,277,184">
20
<area href="class_log4cpp__Appender.html" shape="rect" coords="164,83,279,102">
21
<area href="class_log4cpp__Log4cppCleanup.html" shape="rect" coords="144,0,299,19">
23
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center><a href="class_log4cpp__CategoryStream-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
24
<tr><td colspan=2><br><h2>Public Types</h2></td></tr>
25
<tr><td nowrap align=right valign=top>enum </td><td valign=bottom><a class="el" href="class_log4cpp__CategoryStream.html#s1">Separator</a> { <a class="el" href="class_log4cpp__CategoryStream.html#s1s0">ENDLINE</a>
27
<tr><td> </td><td><font size=-1><em>Enumeration of special 'Separators'.</em> <a href="#s1">More...</a><em></em></font><br><br></td></tr>
28
<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
29
<tr><td nowrap align=right valign=top> </td><td valign=bottom><a class="el" href="class_log4cpp__CategoryStream.html#a0">CategoryStream</a> (<a class="el" href="class_log4cpp__Category.html">Category</a> &category, <a class="el" href="class_log4cpp__Priority.html#s0">Priority::Value</a> priority)</td></tr>
30
<tr><td> </td><td><font size=-1><em>Construct a <a class="el" href="class_log4cpp__CategoryStream.html">CategoryStream</a> for given <a class="el" href="class_log4cpp__Category.html">Category</a> with given priority.</em> <a href="#a0">More...</a><em></em></font><br><br></td></tr>
31
<tr><td nowrap align=right valign=top> </td><td valign=bottom><a class="el" href="class_log4cpp__CategoryStream.html#a1">~CategoryStream</a> ()</td></tr>
32
<tr><td> </td><td><font size=-1><em>Destructor for <a class="el" href="class_log4cpp__CategoryStream.html">CategoryStream</a>.</em></font><br><br></td></tr>
33
<tr><td nowrap align=right valign=top><a class="el" href="class_log4cpp__Category.html">Category</a>& </td><td valign=bottom><a class="el" href="class_log4cpp__CategoryStream.html#a2">getCategory</a> () const</td></tr>
34
<tr><td> </td><td><font size=-1><em>Returns the destination <a class="el" href="class_log4cpp__Category.html">Category</a> for this stream.</em> <a href="#a2">More...</a><em></em></font><br><br></td></tr>
35
<tr><td nowrap align=right valign=top><a class="el" href="class_log4cpp__Priority.html#s0">Priority::Value</a> </td><td valign=bottom><a class="el" href="class_log4cpp__CategoryStream.html#a3">getPriority</a> () const throw ()</td></tr>
36
<tr><td> </td><td><font size=-1><em>Returns the priority for this stream.</em> <a href="#a3">More...</a><em></em></font><br><br></td></tr>
37
<tr><td nowrap align=right valign=top>CategoryStream& </td><td valign=bottom><a class="el" href="class_log4cpp__CategoryStream.html#a4">operator<<</a> (<a class="el" href="class_log4cpp__CategoryStream.html#s1">Separator</a> separator)</td></tr>
38
<tr><td> </td><td><font size=-1><em>Streams in a Separator.</em> <a href="#a4">More...</a><em></em></font><br><br></td></tr>
39
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_log4cpp__CategoryStream.html#a5">flush</a> ()</td></tr>
40
<tr><td> </td><td><font size=-1><em>Flush the contents of the stream buffer to the <a class="el" href="class_log4cpp__Category.html">Category</a> and empties the buffer.</em></font><br><br></td></tr>
41
<tr><td nowrap align=right valign=top>CategoryStream& </td><td valign=bottom><a class="el" href="class_log4cpp__CategoryStream.html#a6">operator<<</a> (const T &t)</td></tr>
42
<tr><td> </td><td><font size=-1><em>Stream in arbitrary types and objects.</em> <a href="#a6">More...</a><em></em></font><br><br></td></tr>
44
<hr><a name="_details"></a><h2>Detailed Description</h2>
45
This class enables streaming simple types and objects to a category.
47
Use category.errorStream(), etc. to obtain a <a class="el" href="class_log4cpp__CategoryStream.html">CategoryStream</a> class.
49
<hr><h2>Member Enumeration Documentation</h2>
50
<a name="s1" doxytag="log4cpp::CategoryStream::Separator"></a><p>
51
<table width="100%" cellpadding="2" cellspacing="0" border="0">
54
<table cellpadding="0" cellspacing="0" border="0">
56
<td nowrap valign="top"><b>
57
enum log4cpp::CategoryStream::Separator
65
<table cellspacing=5 cellpadding=0 border=0>
73
Enumeration of special 'Separators'.
75
Currently only contains the 'ENDLINE' separator, which separates two log messages. <dl compact><dt>
76
<b>Enumeration values:</b><dd>
77
<table border=0 cellspacing=2 cellpadding=0>
78
<tr><td valign=top><a name="s1s0" doxytag="ENDLINE"></a><em>ENDLINE</em>
86
<hr><h2>Constructor & Destructor Documentation</h2>
87
<a name="a0" doxytag="log4cpp::CategoryStream::CategoryStream"></a><p>
88
<table width="100%" cellpadding="2" cellspacing="0" border="0">
91
<table cellpadding="0" cellspacing="0" border="0">
93
<td nowrap valign="top"><b>
94
log4cpp::CategoryStream::CategoryStream (
96
<td valign="bottom"><b>
97
<a class="el" href="class_log4cpp__Category.html">Category</a> & <em>category</em>,
103
<a class="el" href="class_log4cpp__Priority.html#s0">Priority::Value</a> <em>priority</em> )
111
<table cellspacing=5 cellpadding=0 border=0>
119
Construct a <a class="el" href="class_log4cpp__CategoryStream.html">CategoryStream</a> for given <a class="el" href="class_log4cpp__Category.html">Category</a> with given priority.
122
<b>Parameters: </b><dd>
123
<table border=0 cellspacing=2 cellpadding=0>
124
<tr><td valign=top><em>category</em>
126
The category this stream will send log messages to. </td></tr>
127
<tr><td valign=top><em>priority</em>
129
The priority the log messages will get or <a class="el" href="class_log4cpp__Priority.html#s11s10">Priority::NOTSET</a> to silently discard any streamed in messages. </td></tr>
134
<a name="a1" doxytag="log4cpp::CategoryStream::~CategoryStream"></a><p>
135
<table width="100%" cellpadding="2" cellspacing="0" border="0">
138
<table cellpadding="0" cellspacing="0" border="0">
140
<td nowrap valign="top"><b>
141
log4cpp::CategoryStream::~CategoryStream (
143
<td valign="bottom"><b>
152
<table cellspacing=5 cellpadding=0 border=0>
160
Destructor for <a class="el" href="class_log4cpp__CategoryStream.html">CategoryStream</a>.
165
<hr><h2>Member Function Documentation</h2>
166
<a name="a5" doxytag="log4cpp::CategoryStream::flush"></a><p>
167
<table width="100%" cellpadding="2" cellspacing="0" border="0">
170
<table cellpadding="0" cellspacing="0" border="0">
172
<td nowrap valign="top"><b>
173
void log4cpp::CategoryStream::flush (
175
<td valign="bottom"><b>
184
<table cellspacing=5 cellpadding=0 border=0>
192
Flush the contents of the stream buffer to the <a class="el" href="class_log4cpp__Category.html">Category</a> and empties the buffer.
197
<a name="a2" doxytag="log4cpp::CategoryStream::getCategory"></a><p>
198
<table width="100%" cellpadding="2" cellspacing="0" border="0">
201
<table cellpadding="0" cellspacing="0" border="0">
203
<td nowrap valign="top"><b>
204
<a class="el" href="class_log4cpp__Category.html">Category</a> & log4cpp::CategoryStream::getCategory (
206
<td valign="bottom"><b>
207
) const<code> [inline]</code>
215
<table cellspacing=5 cellpadding=0 border=0>
223
Returns the destination <a class="el" href="class_log4cpp__Category.html">Category</a> for this stream.
227
The <a class="el" href="class_log4cpp__Category.html">Category</a>. </dl> </td>
230
<a name="a3" doxytag="log4cpp::CategoryStream::getPriority"></a><p>
231
<table width="100%" cellpadding="2" cellspacing="0" border="0">
234
<table cellpadding="0" cellspacing="0" border="0">
236
<td nowrap valign="top"><b>
237
<a class="el" href="class_log4cpp__Priority.html#s0">Priority::Value</a> log4cpp::CategoryStream::getPriority (
239
<td valign="bottom"><b>
240
) const throw ()<code> [inline]</code>
248
<table cellspacing=5 cellpadding=0 border=0>
256
Returns the priority for this stream.
260
The priority. </dl> </td>
263
<a name="a6" doxytag="log4cpp::CategoryStream::operator<<"></a><p>
264
<table width="100%" cellpadding="2" cellspacing="0" border="0">
267
<table cellpadding="0" cellspacing="0" border="0">
269
<td nowrap valign="top"><b>
270
CategoryStream & log4cpp::CategoryStream::operator<< (
272
<td valign="bottom"><b>
273
const T & <em>t</em> )<code> [inline]</code>
281
<table cellspacing=5 cellpadding=0 border=0>
289
Stream in arbitrary types and objects.
292
<b>Parameters: </b><dd>
293
<table border=0 cellspacing=2 cellpadding=0>
294
<tr><td valign=top><em>t</em>
296
The value or object to stream in. </td></tr>
298
</dl><dl compact><dt>
300
A reference to itself. </dl> </td>
303
<a name="a4" doxytag="log4cpp::CategoryStream::operator<<"></a><p>
304
<table width="100%" cellpadding="2" cellspacing="0" border="0">
307
<table cellpadding="0" cellspacing="0" border="0">
309
<td nowrap valign="top"><b>
310
CategoryStream & log4cpp::CategoryStream::operator<< (
312
<td valign="bottom"><b>
313
<a class="el" href="class_log4cpp__CategoryStream.html#s1">Separator</a> <em>separator</em> )
321
<table cellspacing=5 cellpadding=0 border=0>
329
Streams in a Separator.
331
If the separator equals <a class="el" href="class_log4cpp__CategoryStream.html#s1s0">CategoryStream::ENDLINE</a> it sends the contents of the stream buffer to the <a class="el" href="class_log4cpp__Category.html">Category</a> with set priority and empties the buffer. <dl compact><dt>
332
<b>Parameters: </b><dd>
333
<table border=0 cellspacing=2 cellpadding=0>
334
<tr><td valign=top><em>Separator</em>
336
The Separator </td></tr>
338
</dl><dl compact><dt>
340
A reference to itself. </dl> </td>
343
<hr>The documentation for this class was generated from the following file:<ul>
344
<li><a class="el" href="Category_hh-source.html">Category.hh</a></ul>
345
<hr><address><small>Generated at Mon Jun 11 01:25:22 2001 for log4cpp by
346
<a href="http://www.doxygen.org/index.html">
347
<img src="doxygen.gif" alt="doxygen" align="middle" border=0
348
width=110 height=53></a>1.2.6 written by <a href="mailto:dimitri@stack.nl">Dimitri van Heesch</a>,
349
© 1997-2001</small></address>