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
|
<!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::Net::NameValueCollection</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.Net.html" class="namespace">Poco::Net</a></h1>
<h1 class="symbol">class NameValueCollection</h1>
</div>
<div class="body">
<p>
<b>Library:</b> Net<br />
<b>Package:</b> Messages<br />
<b>Header:</b> Poco/Net/NameValueCollection.h</p>
<h2>Description</h2>
<div class="description">
<p>A collection of name-value pairs that are used in various internet protocols like HTTP and SMTP. </p>
<p>The name is case-insensitive. </p>
<p>There can be more than one name-value pair with the same name. </p>
</div>
<h2>Inheritance</h2>
<p><b>Known Derived Classes: </b><a href="Poco.Net.HTMLForm.html" title="class Poco::Net::HTMLForm">HTMLForm</a>, <a href="Poco.Net.HTTPMessage.html" title="class Poco::Net::HTTPMessage">HTTPMessage</a>, <a href="Poco.Net.HTTPRequest.html" title="class Poco::Net::HTTPRequest">HTTPRequest</a>, <a href="Poco.Net.HTTPResponse.html" title="class Poco::Net::HTTPResponse">HTTPResponse</a>, <a href="Poco.Net.HTTPServerRequest.html" title="class Poco::Net::HTTPServerRequest">HTTPServerRequest</a>, <a href="Poco.Net.HTTPServerRequestImpl.html" title="class Poco::Net::HTTPServerRequestImpl">HTTPServerRequestImpl</a>, <a href="Poco.Net.HTTPServerResponse.html" title="class Poco::Net::HTTPServerResponse">HTTPServerResponse</a>, <a href="Poco.Net.HTTPServerResponseImpl.html" title="class Poco::Net::HTTPServerResponseImpl">HTTPServerResponseImpl</a>, <a href="Poco.Net.MailMessage.html" title="class Poco::Net::MailMessage">MailMessage</a>, <a href="Poco.Net.MessageHeader.html" title="class Poco::Net::MessageHeader">MessageHeader</a></p>
<h2>Member Summary</h2>
<p><b>Member Functions: </b><a href="Poco.Net.NameValueCollection.html#14067" title="Poco::Net::NameValueCollection::add()">add</a>, <a href="Poco.Net.NameValueCollection.html#14079" title="Poco::Net::NameValueCollection::begin()">begin</a>, <a href="Poco.Net.NameValueCollection.html#14085" title="Poco::Net::NameValueCollection::clear()">clear</a>, <a href="Poco.Net.NameValueCollection.html#14081" title="Poco::Net::NameValueCollection::empty()">empty</a>, <a href="Poco.Net.NameValueCollection.html#14080" title="Poco::Net::NameValueCollection::end()">end</a>, <a href="Poco.Net.NameValueCollection.html#14083" title="Poco::Net::NameValueCollection::erase()">erase</a>, <a href="Poco.Net.NameValueCollection.html#14077" title="Poco::Net::NameValueCollection::find()">find</a>, <a href="Poco.Net.NameValueCollection.html#14070" title="Poco::Net::NameValueCollection::get()">get</a>, <a href="Poco.Net.NameValueCollection.html#14075" title="Poco::Net::NameValueCollection::has()">has</a>, <a href="Poco.Net.NameValueCollection.html#14062" title="Poco::Net::NameValueCollection::operator()">operator</a>, <a href="Poco.Net.NameValueCollection.html#14058" title="Poco::Net::NameValueCollection::operator =()">operator =</a>, <a href="Poco.Net.NameValueCollection.html#14064" title="Poco::Net::NameValueCollection::set()">set</a>, <a href="Poco.Net.NameValueCollection.html#14082" title="Poco::Net::NameValueCollection::size()">size</a>, <a href="Poco.Net.NameValueCollection.html#14060" title="Poco::Net::NameValueCollection::swap()">swap</a></p>
<h2>Nested Classes</h2>
<h3><a href="Poco.Net.NameValueCollection.ILT.html" class="class">struct ILT</a></h3>
<p> <a href="Poco.Net.NameValueCollection.ILT.html"><img src="images/arrow.gif" alt="more..." style="vertical-align:baseline;" border="0" /> </a></p>
<h2>Types</h2>
<h3><a name="14053">ConstIterator</a></h3>
<p class="decl">typedef HeaderMap::const_iterator <a href="Poco.Net.NameValueCollection.html#14053" title="Poco::Net::NameValueCollection::ConstIterator">ConstIterator</a>;</p>
<div class="description">
<p></p>
</div>
<h3><a name="14051">HeaderMap</a></h3>
<p class="decl">typedef std::multimap < std::string, std::string, <a href="Poco.Net.NameValueCollection.ILT.html" title="struct Poco::Net::NameValueCollection::ILT">ILT</a> > <a href="Poco.Net.NameValueCollection.html#14051" title="Poco::Net::NameValueCollection::HeaderMap">HeaderMap</a>;</p>
<div class="description">
<p></p>
</div>
<h3><a name="14052">Iterator</a></h3>
<p class="decl">typedef HeaderMap::iterator <a href="Poco.Net.NameValueCollection.html#14052" title="Poco::Net::NameValueCollection::Iterator">Iterator</a>;</p>
<div class="description">
<p></p>
</div>
<h2>Constructors</h2>
<h3><a name="14054">NameValueCollection</a></h3>
<p class="decl"><a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a>();</p>
<div class="description">
<p>Creates an empty <a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a>. </p>
</div>
<h3><a name="14055">NameValueCollection</a></h3>
<p class="decl"><a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a>(<br /> const <a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a> & nvc<br />);</p>
<div class="description">
<p>Creates a <a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a> by copying another one. </p>
</div>
<h2>Destructor</h2>
<h3><a name="14057">~NameValueCollection</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">virtual ~<a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a>();</p>
<div class="description">
<p>Destroys the <a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a>. </p>
</div>
<h2>Member Functions</h2>
<h3><a name="14067">add</a></h3>
<p class="decl">void add(<br /> const std::string & name,<br /> const std::string & value<br />);</p>
<div class="description">
<p>Adds a new name-value pair with the given name and value. </p>
</div>
<h3><a name="14079">begin</a></h3>
<p class="decl"><a href="Poco.Net.NameValueCollection.html#14053" title="Poco::Net::NameValueCollection::ConstIterator">ConstIterator</a> begin() const;</p>
<div class="description">
<p>Returns an iterator pointing to the begin of the name-value pair collection. </p>
</div>
<h3><a name="14085">clear</a></h3>
<p class="decl">void clear();</p>
<div class="description">
<p>Removes all name-value pairs and their values. </p>
</div>
<h3><a name="14081">empty</a></h3>
<p class="decl">bool empty() const;</p>
<div class="description">
<p>Returns true if and only if the header does not have any content. </p>
</div>
<h3><a name="14080">end</a></h3>
<p class="decl"><a href="Poco.Net.NameValueCollection.html#14053" title="Poco::Net::NameValueCollection::ConstIterator">ConstIterator</a> end() const;</p>
<div class="description">
<p>Returns an iterator pointing to the end of the name-value pair collection. </p>
</div>
<h3><a name="14083">erase</a></h3>
<p class="decl">void erase(<br /> const std::string & name<br />);</p>
<div class="description">
<p>Removes all name-value pairs with the given name. </p>
</div>
<h3><a name="14077">find</a></h3>
<p class="decl"><a href="Poco.Net.NameValueCollection.html#14053" title="Poco::Net::NameValueCollection::ConstIterator">ConstIterator</a> find(<br /> const std::string & name<br />) const;</p>
<div class="description">
<p>Returns an iterator pointing to the first name-value pair with the given name. </p>
</div>
<h3><a name="14070">get</a></h3>
<p class="decl">const std::string & get(<br /> const std::string & name<br />) const;</p>
<div class="description">
<p>Returns the value of the first name-value pair with the given name. </p>
<p>Throws a <a href="Poco.NotFoundException.html" title="class Poco::NotFoundException">NotFoundException</a> if the name-value pair does not exist. </p>
</div>
<h3><a name="14072">get</a></h3>
<p class="decl">const std::string & get(<br /> const std::string & name,<br /> const std::string & defaultValue<br />) const;</p>
<div class="description">
<p>Returns the value of the first name-value pair with the given name. If no value with the given name has been found, the defaultValue is returned. </p>
</div>
<h3><a name="14075">has</a></h3>
<p class="decl">bool has(<br /> const std::string & name<br />) const;</p>
<div class="description">
<p>Returns true if there is at least one name-value pair with the given name. </p>
</div>
<h3><a name="14062">operator</a></h3>
<p class="decl">const std::string & operator[] (<br /> const std::string & name<br />) const;</p>
<div class="description">
<p>Returns the value of the (first) name-value pair with the given name. </p>
<p>Throws a <a href="Poco.NotFoundException.html" title="class Poco::NotFoundException">NotFoundException</a> if the name-value pair does not exist. </p>
</div>
<h3><a name="14058">operator =</a></h3>
<p class="decl"><a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a> & operator = (<br /> const <a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a> & nvc<br />);</p>
<div class="description">
<p>Assigns the name-value pairs of another <a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a> to this one. </p>
</div>
<h3><a name="14064">set</a></h3>
<p class="decl">void set(<br /> const std::string & name,<br /> const std::string & value<br />);</p>
<div class="description">
<p>Sets the value of the (first) name-value pair with the given name. </p>
</div>
<h3><a name="14082">size</a></h3>
<p class="decl">int size() const;</p>
<div class="description">
<p>Returns the number of name-value pairs in the collection. </p>
</div>
<h3><a name="14060">swap</a></h3>
<p class="decl">void swap(<br /> <a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a> & nvc<br />);</p>
<div class="description">
<p>Swaps the <a href="Poco.Net.NameValueCollection.html" title="class Poco::Net::NameValueCollection">NameValueCollection</a> with another one. </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>
|
