<!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 =</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 < std::string > <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 /> 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 /> 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 /> const std::string & 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 /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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 /> const char * path,<br /> <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 /> const std::string & path,<br /> <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 /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & parent,<br /> const std::string & 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 /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & parent,<br /> 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 /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & parent,<br /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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 /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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> & append(<br /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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> & assign(<br /> const std::string & 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> & assign(<br /> const std::string & path,<br /> <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> & assign(<br /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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> & assign(<br /> 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 & directory(<br /> 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 /> const std::string & 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 /> StringVec::const_iterator it,<br /> StringVec::const_iterator end,<br /> const std::string & name,<br /> <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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 /> const std::string & pathList,<br /> const std::string & name,<br /> <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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 /> const std::string & 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 /> const std::string & path,<br /> <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 & 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 & 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 & 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 /> std::vector < std::string > & 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, "/". 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> & 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> & makeAbsolute(<br /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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> & 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> & 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> & 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 & operator[] (<br /> 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> & operator = (<br /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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> & operator = (<br /> const std::string & 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> & operator = (<br /> 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> & parse(<br /> const std::string & 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> & parse(<br /> const std::string & path,<br /> <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> & parseDirectory(<br /> const std::string & 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> & parseDirectory(<br /> const std::string & path,<br /> <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 /> const std::string & 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> & resolve(<br /> const <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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 /> const std::string & 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 /> const std::string & 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 /> const std::string & 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 /> const std::string & 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 /> const std::string & 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 /> <a href="Poco.Path.html" title="class Poco::Path">Path</a> & 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 /> <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 /> const std::string & 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 /> const std::string & 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 /> const std::string & path,<br /> <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 & 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 /> const std::string & 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 /> const std::string & 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 /> const std::string & 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 /> const std::string & path<br />);</p> <div class="description"> <p></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>
