File: Poco.Path.html

package info (click to toggle)
poco-doc 1.3.6-1
  • links: PTS
  • area: main
  • in suites: buster, jessie, jessie-kfreebsd, squeeze, stretch, wheezy
  • size: 10,076 kB
  • ctags: 9,611
  • sloc: makefile: 31
file content (467 lines) | stat: -rw-r--r-- 32,806 bytes parent folder | download | duplicates (2)
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
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
<!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::Path</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 Path</h1>
</div>
<div class="body">
<p>
<b>Library:</b> Foundation<br />
<b>Package:</b> Filesystem<br />
<b>Header:</b> Poco/Path.h</p>
<h2>Description</h2>
<div class="description">
<p>This class represents filesystem paths in a  platform-independent manner. Unix, Windows and OpenVMS all use a different syntax for filesystem paths. This class can work with all three formats. A path is made up of an optional node name (only Windows and OpenVMS), an optional device name (also only Windows and OpenVMS), a list of directory names and an optional filename. </p>
</div>
<h2>Member Summary</h2>
<p><b>Member Functions: </b><a href="Poco.Path.html#9266" title="Poco::Path::absolute()">absolute</a>, <a href="Poco.Path.html#9232" title="Poco::Path::append()">append</a>, <a href="Poco.Path.html#9199" title="Poco::Path::assign()">assign</a>, <a href="Poco.Path.html#9303" title="Poco::Path::buildUnix()">buildUnix</a>, <a href="Poco.Path.html#9305" title="Poco::Path::buildVMS()">buildVMS</a>, <a href="Poco.Path.html#9304" title="Poco::Path::buildWindows()">buildWindows</a>, <a href="Poco.Path.html#9264" title="Poco::Path::clear()">clear</a>, <a href="Poco.Path.html#9276" title="Poco::Path::current()">current</a>, <a href="Poco.Path.html#9246" title="Poco::Path::depth()">depth</a>, <a href="Poco.Path.html#9247" title="Poco::Path::directory()">directory</a>, <a href="Poco.Path.html#9280" title="Poco::Path::expand()">expand</a>, <a href="Poco.Path.html#9284" title="Poco::Path::find()">find</a>, <a href="Poco.Path.html#9269" title="Poco::Path::forDirectory()">forDirectory</a>, <a href="Poco.Path.html#9259" title="Poco::Path::getBaseName()">getBaseName</a>, <a href="Poco.Path.html#9245" title="Poco::Path::getDevice()">getDevice</a>, <a href="Poco.Path.html#9262" title="Poco::Path::getExtension()">getExtension</a>, <a href="Poco.Path.html#9256" title="Poco::Path::getFileName()">getFileName</a>, <a href="Poco.Path.html#9242" title="Poco::Path::getNode()">getNode</a>, <a href="Poco.Path.html#9277" title="Poco::Path::home()">home</a>, <a href="Poco.Path.html#9236" title="Poco::Path::isAbsolute()">isAbsolute</a>, <a href="Poco.Path.html#9238" title="Poco::Path::isDirectory()">isDirectory</a>, <a href="Poco.Path.html#9239" title="Poco::Path::isFile()">isFile</a>, <a href="Poco.Path.html#9237" title="Poco::Path::isRelative()">isRelative</a>, <a href="Poco.Path.html#9282" title="Poco::Path::listRoots()">listRoots</a>, <a href="Poco.Path.html#9229" title="Poco::Path::makeAbsolute()">makeAbsolute</a>, <a href="Poco.Path.html#9226" title="Poco::Path::makeDirectory()">makeDirectory</a>, <a href="Poco.Path.html#9227" title="Poco::Path::makeFile()">makeFile</a>, <a href="Poco.Path.html#9228" title="Poco::Path::makeParent()">makeParent</a>, <a href="Poco.Path.html#9279" title="Poco::Path::null()">null</a>, <a href="Poco.Path.html#9249" title="Poco::Path::operator()">operator</a>, <a href="Poco.Path.html#9191" title="Poco::Path::operator =()">operator&nbsp;=</a>, <a href="Poco.Path.html#9265" title="Poco::Path::parent()">parent</a>, <a href="Poco.Path.html#9211" title="Poco::Path::parse()">parse</a>, <a href="Poco.Path.html#9221" title="Poco::Path::parseDirectory()">parseDirectory</a>, <a href="Poco.Path.html#9301" title="Poco::Path::parseGuess()">parseGuess</a>, <a href="Poco.Path.html#9295" title="Poco::Path::parseUnix()">parseUnix</a>, <a href="Poco.Path.html#9299" title="Poco::Path::parseVMS()">parseVMS</a>, <a href="Poco.Path.html#9297" title="Poco::Path::parseWindows()">parseWindows</a>, <a href="Poco.Path.html#9275" title="Poco::Path::pathSeparator()">pathSeparator</a>, <a href="Poco.Path.html#9253" title="Poco::Path::popDirectory()">popDirectory</a>, <a href="Poco.Path.html#9251" title="Poco::Path::pushDirectory()">pushDirectory</a>, <a href="Poco.Path.html#9234" title="Poco::Path::resolve()">resolve</a>, <a href="Poco.Path.html#9274" title="Poco::Path::separator()">separator</a>, <a href="Poco.Path.html#9257" title="Poco::Path::setBaseName()">setBaseName</a>, <a href="Poco.Path.html#9243" title="Poco::Path::setDevice()">setDevice</a>, <a href="Poco.Path.html#9260" title="Poco::Path::setExtension()">setExtension</a>, <a href="Poco.Path.html#9254" title="Poco::Path::setFileName()">setFileName</a>, <a href="Poco.Path.html#9240" title="Poco::Path::setNode()">setNode</a>, <a href="Poco.Path.html#9197" title="Poco::Path::swap()">swap</a>, <a href="Poco.Path.html#9278" title="Poco::Path::temp()">temp</a>, <a href="Poco.Path.html#9208" title="Poco::Path::toString()">toString</a>, <a href="Poco.Path.html#9293" title="Poco::Path::transcode()">transcode</a>, <a href="Poco.Path.html#9216" title="Poco::Path::tryParse()">tryParse</a>, <a href="Poco.Path.html#9263" title="Poco::Path::version()">version</a></p>
<h2>Types</h2>
<h3><a name="9165">StringVec</a></h3>
<p class="decl">typedef std::vector &lt; std::string &gt; <a href="Poco.Path.html#9165" title="Poco::Path::StringVec">StringVec</a>;</p>
<div class="description">
<p></p>
</div>
<h2>Enumerations</h2>
<h3><a name="9159">Style</a></h3>
<div class="description">
<p></p>
</div>
<p class="decl"><a name="9160">PATH_UNIX</a></p>
<div class="description">
<p>Unix-style path </p>
</div>
<p class="decl"><a name="9161">PATH_WINDOWS</a></p>
<div class="description">
<p>Windows-style path </p>
</div>
<p class="decl"><a name="9162">PATH_VMS</a></p>
<div class="description">
<p>VMS-style path </p>
</div>
<p class="decl"><a name="9163">PATH_NATIVE</a></p>
<div class="description">
<p>The current platform's native style </p>
</div>
<p class="decl"><a name="9164">PATH_GUESS</a></p>
<div class="description">
<p>Guess the style by examining the path </p>
</div>
<h2>Constructors</h2>
<h3><a name="9166">Path</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a>();</p>
<div class="description">
<p>Creates an empty relative path. </p>
</div>
<h3><a name="9167">Path</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a>(<br />&nbsp;&nbsp;&nbsp;&nbsp;bool absolute<br />);</p>
<div class="description">
<p>Creates an empty absolute or relative path. </p>
</div>
<h3><a name="9169">Path</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a>(<br />&nbsp;&nbsp;&nbsp;&nbsp;const char * path<br />);</p>
<div class="description">
<p>Creates a path from a string. </p>
</div>
<h3><a name="9174">Path</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a>(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p>Creates a path from a string. </p>
</div>
<h3><a name="9179">Path</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a>(<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; path<br />);</p>
<div class="description">
<p>Copy constructor </p>
</div>
<h3><a name="9171">Path</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a>(<br />&nbsp;&nbsp;&nbsp;&nbsp;const char * path,<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html#9159" title="enum  Poco::Path::Style">Style</a> style<br />);</p>
<div class="description">
<p>Creates a path from a string. </p>
</div>
<h3><a name="9176">Path</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a>(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path,<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html#9159" title="enum  Poco::Path::Style">Style</a> style<br />);</p>
<div class="description">
<p>Creates a path from a string. </p>
</div>
<h3><a name="9181">Path</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a>(<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; parent,<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; fileName<br />);</p>
<div class="description">
<p>Creates a path from a parent path and a filename. The parent path is expected to reference a directory. </p>
</div>
<h3><a name="9184">Path</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a>(<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; parent,<br />&nbsp;&nbsp;&nbsp;&nbsp;const char * fileName<br />);</p>
<div class="description">
<p>Creates a path from a parent path and a filename. The parent path is expected to reference a directory. </p>
</div>
<h3><a name="9187">Path</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a>(<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; parent,<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; relative<br />);</p>
<div class="description">
<p>Creates a path from a parent path and a relative path. The parent path is expected to reference a directory. The relative path is appended to the parent path. </p>
</div>
<h2>Destructor</h2>
<h3><a name="9190">~Path</a></h3>
<p class="decl">~<a href="Poco.Path.html" title="class Poco::Path">Path</a>();</p>
<div class="description">
<p>Destroys the <a href="Poco.Path.html" title="class Poco::Path">Path</a>. </p>
</div>
<h2>Member Functions</h2>
<h3><a name="9266">absolute</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> absolute() const;</p>
<div class="description">
<p>Returns an absolute variant of the path, taking the current working directory as base. </p>
</div>
<h3><a name="9267">absolute</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> absolute(<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; base<br />) const;</p>
<div class="description">
<p>Returns an absolute variant of the path, taking the given path as base. </p>
</div>
<h3><a name="9232">append</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; append(<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; path<br />);</p>
<div class="description">
<p>Appends the given path. </p>
</div>
<h3><a name="9199">assign</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; assign(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p>Assigns a string containing a path in native format. </p>
</div>
<h3><a name="9201">assign</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; assign(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path,<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html#9159" title="enum  Poco::Path::Style">Style</a> style<br />);</p>
<div class="description">
<p>Assigns a string containing a path. </p>
</div>
<h3><a name="9204">assign</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; assign(<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; path<br />);</p>
<div class="description">
<p>Assigns the given path. </p>
</div>
<h3><a name="9206">assign</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; assign(<br />&nbsp;&nbsp;&nbsp;&nbsp;const char * path<br />);</p>
<div class="description">
<p>Assigns a string containing a path. </p>
</div>
<h3><a name="9264">clear</a></h3>
<p class="decl">void clear();</p>
<div class="description">
<p>Clears all components. </p>
</div>
<h3><a name="9276">current</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string current();</p>
<div class="description">
<p>Returns the current working directory. </p>
</div>
<h3><a name="9246">depth</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">int depth() const;</p>
<div class="description">
<p>Returns the number of directories in the directory list. </p>
</div>
<h3><a name="9247">directory</a></h3>
<p class="decl">const std::string &amp; directory(<br />&nbsp;&nbsp;&nbsp;&nbsp;int n<br />) const;</p>
<div class="description">
<p>Returns the n'th directory in the directory list. If n == <a href="Poco.Path.html#9246" title="Poco::Path::depth()">depth</a>(), returns the filename. </p>
</div>
<h3><a name="9280">expand</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string expand(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p>Expands all environment variables contained in the path. </p>
<p>On Unix, a tilde as first character in the path is replaced with the path to user's home directory. </p>
</div>
<h3><a name="9284">find</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static bool find(<br />&nbsp;&nbsp;&nbsp;&nbsp;StringVec::const_iterator it,<br />&nbsp;&nbsp;&nbsp;&nbsp;StringVec::const_iterator end,<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; name,<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; path<br />);</p>
<div class="description">
<p>Searches the file with the given name in the locations (paths) specified by it and end. A relative path may be given in name. </p>
<p>If the file is found in one of the locations, the complete path of the file is stored in the path given as argument and true is returned.  Otherwise false is returned and the path argument remains unchanged. </p>
</div>
<h3><a name="9289">find</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static bool find(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; pathList,<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; name,<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; path<br />);</p>
<div class="description">
<p>Searches the file with the given name in the locations (paths) specified in pathList. The paths in pathList must be delimited by the platform's path separator (see <a href="Poco.Path.html#9275" title="Poco::Path::pathSeparator()">pathSeparator</a>()). A relative path may be given in name. </p>
<p>If the file is found in one of the locations, the complete path of the file is stored in the path given as argument and true is returned.  Otherwise false is returned and the path argument remains unchanged. </p>
</div>
<h3><a name="9269">forDirectory</a> <img src="images/static.gif" alt="static" title="static" 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">static <a href="Poco.Path.html" title="class Poco::Path">Path</a> forDirectory(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p>Creates a path referring to a directory. </p>
</div>
<h3><a name="9271">forDirectory</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.Path.html" title="class Poco::Path">Path</a> forDirectory(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path,<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html#9159" title="enum  Poco::Path::Style">Style</a> style<br />);</p>
<div class="description">
<p>Creates a path referring to a directory. </p>
</div>
<h3><a name="9259">getBaseName</a></h3>
<p class="decl">std::string getBaseName() const;</p>
<div class="description">
<p>Returns the basename (the filename sans extension) of the path. </p>
</div>
<h3><a name="9245">getDevice</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">const std::string &amp; getDevice() const;</p>
<div class="description">
<p>Returns the device name. </p>
</div>
<h3><a name="9262">getExtension</a></h3>
<p class="decl">std::string getExtension() const;</p>
<div class="description">
<p>Returns the filename extension. </p>
</div>
<h3><a name="9256">getFileName</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">const std::string &amp; getFileName() const;</p>
<div class="description">
<p>Returns the filename. </p>
</div>
<h3><a name="9242">getNode</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">const std::string &amp; getNode() const;</p>
<div class="description">
<p>Returns the node name. </p>
</div>
<h3><a name="9277">home</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string home();</p>
<div class="description">
<p>Returns the user's home directory. </p>
</div>
<h3><a name="9236">isAbsolute</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">bool isAbsolute() const;</p>
<div class="description">
<p>Returns true if and only if the path is absolute. </p>
</div>
<h3><a name="9238">isDirectory</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">bool isDirectory() const;</p>
<div class="description">
<p>Returns true if and only if the path references a directory (the filename part is empty). </p>
</div>
<h3><a name="9239">isFile</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">bool isFile() const;</p>
<div class="description">
<p>Returns true if and only if the path references a file (the filename part is not empty). </p>
</div>
<h3><a name="9237">isRelative</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">bool isRelative() const;</p>
<div class="description">
<p>Returns true if and only if the path is relative. </p>
</div>
<h3><a name="9282">listRoots</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void listRoots(<br />&nbsp;&nbsp;&nbsp;&nbsp;std::vector &lt; std::string &gt; &amp; roots<br />);</p>
<div class="description">
<p>Fills the vector with all filesystem roots available on the system. On Unix, there is exactly one root, &quot;/&quot;. On Windows, the roots are the drive letters. On OpenVMS, the roots are the mounted disks. </p>
</div>
<h3><a name="9229">makeAbsolute</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; makeAbsolute();</p>
<div class="description">
<p>Makes the path absolute if it is relative. The current working directory is taken as base directory. </p>
</div>
<h3><a name="9230">makeAbsolute</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; makeAbsolute(<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; base<br />);</p>
<div class="description">
<p>Makes the path absolute if it is relative. The given path is taken as base.  </p>
</div>
<h3><a name="9226">makeDirectory</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; makeDirectory();</p>
<div class="description">
<p>If the path contains a filename, the filename is appended to the directory list and cleared. Thus the resulting path always refers to a directory. </p>
</div>
<h3><a name="9227">makeFile</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; makeFile();</p>
<div class="description">
<p>If the path contains no filename, the last directory becomes the filename. </p>
</div>
<h3><a name="9228">makeParent</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; makeParent();</p>
<div class="description">
<p>Makes the path refer to its parent. </p>
</div>
<h3><a name="9279">null</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string null();</p>
<div class="description">
<p>Returns the name of the null device. </p>
</div>
<h3><a name="9249">operator</a></h3>
<p class="decl">const std::string &amp; operator[] (<br />&nbsp;&nbsp;&nbsp;&nbsp;int n<br />) const;</p>
<div class="description">
<p>Returns the n'th directory in the directory list. If n == <a href="Poco.Path.html#9246" title="Poco::Path::depth()">depth</a>(), returns the filename. </p>
</div>
<h3><a name="9191">operator =</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; operator = (<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; path<br />);</p>
<div class="description">
<p>Assignment operator. </p>
</div>
<h3><a name="9193">operator =</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; operator = (<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p>Assigns a string containing a path in native format. </p>
</div>
<h3><a name="9195">operator =</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; operator = (<br />&nbsp;&nbsp;&nbsp;&nbsp;const char * path<br />);</p>
<div class="description">
<p>Assigns a string containing a path in native format. </p>
</div>
<h3><a name="9265">parent</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> parent() const;</p>
<div class="description">
<p>Returns a path referring to the path's directory. </p>
</div>
<h3><a name="9211">parse</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; parse(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p>Same as <a href="Poco.Path.html#9199" title="Poco::Path::assign()">assign</a>(). </p>
</div>
<h3><a name="9213">parse</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; parse(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path,<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html#9159" title="enum  Poco::Path::Style">Style</a> style<br />);</p>
<div class="description">
<p>Assigns a string containing a path. </p>
</div>
<h3><a name="9221">parseDirectory</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; parseDirectory(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p>The resulting path always refers to a directory and the filename part is empty. </p>
</div>
<h3><a name="9223">parseDirectory</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; parseDirectory(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path,<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html#9159" title="enum  Poco::Path::Style">Style</a> style<br />);</p>
<div class="description">
<p>The resulting path always refers to a directory and the filename part is empty. </p>
</div>
<h3><a name="9275">pathSeparator</a> <img src="images/static.gif" alt="static" title="static" 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">static char pathSeparator();</p>
<div class="description">
<p>Returns the platform's path separator, which separates single paths in a list of paths. </p>
<p>On Unix systems, this is the colon ':'. On Windows systems, this is the semicolon ';'. On OpenVMS systems, this is the comma ','. </p>
</div>
<h3><a name="9253">popDirectory</a></h3>
<p class="decl">void popDirectory();</p>
<div class="description">
<p>Removes the last directory from the directory list. </p>
</div>
<h3><a name="9251">pushDirectory</a></h3>
<p class="decl">void pushDirectory(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; dir<br />);</p>
<div class="description">
<p>Adds a directory to the directory list. </p>
</div>
<h3><a name="9234">resolve</a></h3>
<p class="decl"><a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; resolve(<br />&nbsp;&nbsp;&nbsp;&nbsp;const <a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; path<br />);</p>
<div class="description">
<p>Resolves the given path agains the current one. </p>
<p>If the given path is absolute, it replaces the current one. Otherwise, the relative path is appended to the current path. </p>
</div>
<h3><a name="9274">separator</a> <img src="images/static.gif" alt="static" title="static" 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">static char separator();</p>
<div class="description">
<p>Returns the platform's path name separator, which separates the components (names) in a path.  </p>
<p>On Unix systems, this is the slash '/'. On Windows systems,  this is the backslash '\'. On OpenVMS systems, this is the period '.'. </p>
</div>
<h3><a name="9257">setBaseName</a></h3>
<p class="decl">void setBaseName(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; name<br />);</p>
<div class="description">
<p>Sets the basename part of the filename and does not change the extension. </p>
</div>
<h3><a name="9243">setDevice</a></h3>
<p class="decl">void setDevice(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; device<br />);</p>
<div class="description">
<p>Sets the device name. Setting a non-empty device automatically makes the path an absolute one. </p>
</div>
<h3><a name="9260">setExtension</a></h3>
<p class="decl">void setExtension(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; extension<br />);</p>
<div class="description">
<p>Sets the filename extension. </p>
</div>
<h3><a name="9254">setFileName</a></h3>
<p class="decl">void setFileName(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; name<br />);</p>
<div class="description">
<p>Sets the filename. </p>
</div>
<h3><a name="9240">setNode</a></h3>
<p class="decl">void setNode(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; node<br />);</p>
<div class="description">
<p>Sets the node name. Setting a non-empty node automatically makes the path an absolute one. </p>
</div>
<h3><a name="9197">swap</a></h3>
<p class="decl">void swap(<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html" title="class Poco::Path">Path</a> &amp; path<br />);</p>
<div class="description">
<p>Swaps the path with another one. </p>
</div>
<h3><a name="9278">temp</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string temp();</p>
<div class="description">
<p>Returns the temporary directory. </p>
</div>
<h3><a name="9208">toString</a></h3>
<p class="decl">std::string toString() const;</p>
<div class="description">
<p>Returns a string containing the path in native format. </p>
</div>
<h3><a name="9209">toString</a></h3>
<p class="decl">std::string toString(<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html#9159" title="enum  Poco::Path::Style">Style</a> style<br />) const;</p>
<div class="description">
<p>Returns a string containing the path in the given format. </p>
</div>
<h3><a name="9293">transcode</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static std::string transcode(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p>On Windows, if POCO has been compiled with Windows UTF-8 support  (POCO_WIN32_UTF8), this function converts a string (usually containing a path)  encoded in UTF-8 into a string encoded in the current Windows code page. </p>
<p>This function should be used for every string passed as a file name to a string stream or fopen(). </p>
<p>On all other platforms, or if POCO has not been compiled with Windows UTF-8 support, this function returns the string unchanged. </p>
</div>
<h3><a name="9216">tryParse</a></h3>
<p class="decl">bool tryParse(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p>Tries to interpret the given string as a path in native format. If the path is syntactically valid, assigns the path and returns true. Otherwise leaves the  object unchanged and returns false. </p>
</div>
<h3><a name="9218">tryParse</a></h3>
<p class="decl">bool tryParse(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path,<br />&nbsp;&nbsp;&nbsp;&nbsp;<a href="Poco.Path.html#9159" title="enum  Poco::Path::Style">Style</a> style<br />);</p>
<div class="description">
<p>Tries to interpret the given string as a path, according to the given style. If the path is syntactically valid, assigns the path and returns true. Otherwise leaves the object unchanged and returns false. </p>
</div>
<h3><a name="9263">version</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">const std::string &amp; version() const;</p>
<div class="description">
<p>Returns the file version. VMS only. </p>
</div>
<h3><a name="9303">buildUnix</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">std::string buildUnix() const;</p>
<div class="description">
<p></p>
</div>
<h3><a name="9305">buildVMS</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">std::string buildVMS() const;</p>
<div class="description">
<p></p>
</div>
<h3><a name="9304">buildWindows</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">std::string buildWindows() const;</p>
<div class="description">
<p></p>
</div>
<h3><a name="9301">parseGuess</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void parseGuess(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p></p>
</div>
<h3><a name="9295">parseUnix</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void parseUnix(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p></p>
</div>
<h3><a name="9299">parseVMS</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void parseVMS(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p></p>
</div>
<h3><a name="9297">parseWindows</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void parseWindows(<br />&nbsp;&nbsp;&nbsp;&nbsp;const std::string &amp; path<br />);</p>
<div class="description">
<p></p>
</div>
<p class="footer">POCO C++ Libraries 1.3.6-all<br />
Copyright &copy; 2009, <a href="http://pocoproject.org/" target="_blank">Applied Informatics Software Engineering GmbH and Contributors</a></p>

</div>
</body>
</html>