<!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::URI</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 URI</h1> </div> <div class="body"> <p> <b>Library:</b> Foundation<br /> <b>Package:</b> URI<br /> <b>Header:</b> Poco/URI.h</p> <h2>Description</h2> <div class="description"> <p>A Uniform Resource Identifier, as specified in <a href="http://www.ietf.org/rfc/rfc3986.txt" target="_blank">RFC 3986</a>. </p> <p>The <a href="Poco.URI.html" title="class Poco::URI">URI</a> class provides methods for building URIs from their parts, as well as for splitting URIs into their parts. Furthermore, the class provides methods for resolving relative URIs against base URIs. </p> <p>The class automatically performs a few normalizations on all URIs and <a href="Poco.URI.html" title="class Poco::URI">URI</a> parts passed to it: </p> <ul> <li>scheme identifiers are converted to lower case. </li> <li>percent-encoded characters are decoded </li> <li>optionally, dot segments are removed from paths (see <a href="Poco.URI.html#11444" title="Poco::URI::normalize()">normalize</a>()) </li> </ul> </div> <h2>Member Summary</h2> <p><b>Member Functions: </b><a href="Poco.URI.html#11485" title="Poco::URI::buildPath()">buildPath</a>, <a href="Poco.URI.html#11397" title="Poco::URI::clear()">clear</a>, <a href="Poco.URI.html#11451" title="Poco::URI::decode()">decode</a>, <a href="Poco.URI.html#11435" title="Poco::URI::empty()">empty</a>, <a href="Poco.URI.html#11447" title="Poco::URI::encode()">encode</a>, <a href="Poco.URI.html#11454" title="Poco::URI::equals()">equals</a>, <a href="Poco.URI.html#11411" title="Poco::URI::getAuthority()">getAuthority</a>, <a href="Poco.URI.html#11423" title="Poco::URI::getFragment()">getFragment</a>, <a href="Poco.URI.html#11405" title="Poco::URI::getHost()">getHost</a>, <a href="Poco.URI.html#11414" title="Poco::URI::getPath()">getPath</a>, <a href="Poco.URI.html#11429" title="Poco::URI::getPathAndQuery()">getPathAndQuery</a>, <a href="Poco.URI.html#11428" title="Poco::URI::getPathEtc()">getPathEtc</a>, <a href="Poco.URI.html#11445" title="Poco::URI::getPathSegments()">getPathSegments</a>, <a href="Poco.URI.html#11408" title="Poco::URI::getPort()">getPort</a>, <a href="Poco.URI.html#11417" title="Poco::URI::getQuery()">getQuery</a>, <a href="Poco.URI.html#11420" title="Poco::URI::getRawQuery()">getRawQuery</a>, <a href="Poco.URI.html#11399" title="Poco::URI::getScheme()">getScheme</a>, <a href="Poco.URI.html#11402" title="Poco::URI::getUserInfo()">getUserInfo</a>, <a href="Poco.URI.html#11457" title="Poco::URI::getWellKnownPort()">getWellKnownPort</a>, <a href="Poco.URI.html#11434" title="Poco::URI::isRelative()">isRelative</a>, <a href="Poco.URI.html#11456" title="Poco::URI::isWellKnownPort()">isWellKnownPort</a>, <a href="Poco.URI.html#11478" title="Poco::URI::mergePath()">mergePath</a>, <a href="Poco.URI.html#11444" title="Poco::URI::normalize()">normalize</a>, <a href="Poco.URI.html#11440" title="Poco::URI::operator !=()">operator !=</a>, <a href="Poco.URI.html#11389" title="Poco::URI::operator =()">operator =</a>, <a href="Poco.URI.html#11436" title="Poco::URI::operator ==()">operator ==</a>, <a href="Poco.URI.html#11458" title="Poco::URI::parse()">parse</a>, <a href="Poco.URI.html#11460" title="Poco::URI::parseAuthority()">parseAuthority</a>, <a href="Poco.URI.html#11475" title="Poco::URI::parseFragment()">parseFragment</a>, <a href="Poco.URI.html#11463" title="Poco::URI::parseHostAndPort()">parseHostAndPort</a>, <a href="Poco.URI.html#11466" title="Poco::URI::parsePath()">parsePath</a>, <a href="Poco.URI.html#11469" title="Poco::URI::parsePathEtc()">parsePathEtc</a>, <a href="Poco.URI.html#11472" title="Poco::URI::parseQuery()">parseQuery</a>, <a href="Poco.URI.html#11480" title="Poco::URI::removeDotSegments()">removeDotSegments</a>, <a href="Poco.URI.html#11430" title="Poco::URI::resolve()">resolve</a>, <a href="Poco.URI.html#11412" title="Poco::URI::setAuthority()">setAuthority</a>, <a href="Poco.URI.html#11424" title="Poco::URI::setFragment()">setFragment</a>, <a href="Poco.URI.html#11406" title="Poco::URI::setHost()">setHost</a>, <a href="Poco.URI.html#11415" title="Poco::URI::setPath()">setPath</a>, <a href="Poco.URI.html#11426" title="Poco::URI::setPathEtc()">setPathEtc</a>, <a href="Poco.URI.html#11409" title="Poco::URI::setPort()">setPort</a>, <a href="Poco.URI.html#11418" title="Poco::URI::setQuery()">setQuery</a>, <a href="Poco.URI.html#11421" title="Poco::URI::setRawQuery()">setRawQuery</a>, <a href="Poco.URI.html#11400" title="Poco::URI::setScheme()">setScheme</a>, <a href="Poco.URI.html#11403" title="Poco::URI::setUserInfo()">setUserInfo</a>, <a href="Poco.URI.html#11395" title="Poco::URI::swap()">swap</a>, <a href="Poco.URI.html#11398" title="Poco::URI::toString()">toString</a></p> <h2>Constructors</h2> <h3><a name="11360">URI</a></h3> <p class="decl"><a href="Poco.URI.html" title="class Poco::URI">URI</a>();</p> <div class="description"> <p>Creates an empty <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11361">URI</a></h3> <p class="decl">explicit <a href="Poco.URI.html" title="class Poco::URI">URI</a>(<br /> const std::string & uri<br />);</p> <div class="description"> <p>Parses an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from the given string. Throws a <a href="Poco.SyntaxException.html" title="class Poco::SyntaxException">SyntaxException</a> if the uri is not valid. </p> </div> <h3><a name="11363">URI</a></h3> <p class="decl">explicit <a href="Poco.URI.html" title="class Poco::URI">URI</a>(<br /> const char * uri<br />);</p> <div class="description"> <p>Parses an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from the given string. Throws a <a href="Poco.SyntaxException.html" title="class Poco::SyntaxException">SyntaxException</a> if the uri is not valid. </p> </div> <h3><a name="11383">URI</a></h3> <p class="decl"><a href="Poco.URI.html" title="class Poco::URI">URI</a>(<br /> const <a href="Poco.URI.html" title="class Poco::URI">URI</a> & uri<br />);</p> <div class="description"> <p>Copy constructor. Creates an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from another one. </p> </div> <h3><a name="11365">URI</a></h3> <p class="decl"><a href="Poco.URI.html" title="class Poco::URI">URI</a>(<br /> const std::string & scheme,<br /> const std::string & pathEtc<br />);</p> <div class="description"> <p>Creates an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from its parts. </p> </div> <h3><a name="11385">URI</a></h3> <p class="decl"><a href="Poco.URI.html" title="class Poco::URI">URI</a>(<br /> const <a href="Poco.URI.html" title="class Poco::URI">URI</a> & baseURI,<br /> const std::string & relativeURI<br />);</p> <div class="description"> <p>Creates an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from a base <a href="Poco.URI.html" title="class Poco::URI">URI</a> and a relative <a href="Poco.URI.html" title="class Poco::URI">URI</a>, according to the algorithm in section 5.2 of <a href="http://www.ietf.org/rfc/rfc3986.txt" target="_blank">RFC 3986</a>. </p> </div> <h3><a name="11368">URI</a></h3> <p class="decl"><a href="Poco.URI.html" title="class Poco::URI">URI</a>(<br /> const std::string & scheme,<br /> const std::string & authority,<br /> const std::string & pathEtc<br />);</p> <div class="description"> <p>Creates an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from its parts. </p> </div> <h3><a name="11372">URI</a></h3> <p class="decl"><a href="Poco.URI.html" title="class Poco::URI">URI</a>(<br /> const std::string & scheme,<br /> const std::string & authority,<br /> const std::string & path,<br /> const std::string & query<br />);</p> <div class="description"> <p>Creates an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from its parts. </p> </div> <h3><a name="11377">URI</a></h3> <p class="decl"><a href="Poco.URI.html" title="class Poco::URI">URI</a>(<br /> const std::string & scheme,<br /> const std::string & authority,<br /> const std::string & path,<br /> const std::string & query,<br /> const std::string & fragment<br />);</p> <div class="description"> <p>Creates an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from its parts. </p> </div> <h2>Destructor</h2> <h3><a name="11388">~URI</a></h3> <p class="decl">~<a href="Poco.URI.html" title="class Poco::URI">URI</a>();</p> <div class="description"> <p>Destroys the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h2>Member Functions</h2> <h3><a name="11397">clear</a></h3> <p class="decl">void clear();</p> <div class="description"> <p>Clears all parts of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11451">decode</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">static void decode(<br /> const std::string & str,<br /> std::string & decodedStr<br />);</p> <div class="description"> <p><a href="Poco.URI.html" title="class Poco::URI">URI</a>-decodes the given string by replacing percent-encoded characters with the actual character. The decoded string is appended to decodedStr. </p> </div> <h3><a name="11435">empty</a></h3> <p class="decl">bool empty() const;</p> <div class="description"> <p>Returns true if the <a href="Poco.URI.html" title="class Poco::URI">URI</a> is empty, false otherwise. </p> </div> <h3><a name="11447">encode</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">static void encode(<br /> const std::string & str,<br /> const std::string & reserved,<br /> std::string & encodedStr<br />);</p> <div class="description"> <p><a href="Poco.URI.html" title="class Poco::URI">URI</a>-encodes the given string by escaping reserved and non-ASCII characters. The encoded string is appended to encodedStr. </p> </div> <h3><a name="11411">getAuthority</a></h3> <p class="decl">std::string getAuthority() const;</p> <div class="description"> <p>Returns the authority part (userInfo, host and port) of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> <p>If the port number is a well-known port number for the given scheme (e.g., 80 for http), it is not included in the authority. </p> </div> <h3><a name="11423">getFragment</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">const std::string & getFragment() const;</p> <div class="description"> <p>Returns the fragment part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11405">getHost</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">const std::string & getHost() const;</p> <div class="description"> <p>Returns the host part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11414">getPath</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">const std::string & getPath() const;</p> <div class="description"> <p>Returns the path part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11429">getPathAndQuery</a></h3> <p class="decl">std::string getPathAndQuery() const;</p> <div class="description"> <p>Returns the path and query parts of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11428">getPathEtc</a></h3> <p class="decl">std::string getPathEtc() const;</p> <div class="description"> <p>Returns the path, query and fragment parts of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11445">getPathSegments</a></h3> <p class="decl">void getPathSegments(<br /> std::vector < std::string > & segments<br />);</p> <div class="description"> <p>Places the single path segments (delimited by slashes) into the given vector. </p> </div> <h3><a name="11408">getPort</a></h3> <p class="decl">unsigned short getPort() const;</p> <div class="description"> <p>Returns the port number part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> <p>If no port number (0) has been specified, the well-known port number (e.g., 80 for http) for the given scheme is returned if it is known. Otherwise, 0 is returned. </p> </div> <h3><a name="11417">getQuery</a></h3> <p class="decl">std::string getQuery() const;</p> <div class="description"> <p>Returns the query part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11420">getRawQuery</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">const std::string & getRawQuery() const;</p> <div class="description"> <p>Returns the unencoded query part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11399">getScheme</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">const std::string & getScheme() const;</p> <div class="description"> <p>Returns the scheme part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11402">getUserInfo</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">const std::string & getUserInfo() const;</p> <div class="description"> <p>Returns the user-info part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11434">isRelative</a></h3> <p class="decl">bool isRelative() const;</p> <div class="description"> <p>Returns true if the <a href="Poco.URI.html" title="class Poco::URI">URI</a> is a relative reference, false otherwise. </p> <p>A relative reference does not contain a scheme identifier. Relative references are usually resolved against an absolute base reference. </p> </div> <h3><a name="11444">normalize</a></h3> <p class="decl">void normalize();</p> <div class="description"> <p>Normalizes the <a href="Poco.URI.html" title="class Poco::URI">URI</a> by removing all but leading . and .. segments from the path. </p> <p>If the first path segment in a relative path contains a colon (:), such as in a Windows path containing a drive letter, a dot segment (./) is prepended in accordance with section 3.3 of <a href="http://www.ietf.org/rfc/rfc3986.txt" target="_blank">RFC 3986</a>. </p> </div> <h3><a name="11440">operator !=</a></h3> <p class="decl">bool operator != (<br /> const <a href="Poco.URI.html" title="class Poco::URI">URI</a> & uri<br />) const;</p> <div class="description"> <p>Returns true if both URIs are identical, false otherwise. </p> </div> <h3><a name="11442">operator !=</a></h3> <p class="decl">bool operator != (<br /> const std::string & uri<br />) const;</p> <div class="description"> <p>Parses the given <a href="Poco.URI.html" title="class Poco::URI">URI</a> and returns true if both URIs are identical, false otherwise. </p> </div> <h3><a name="11389">operator =</a></h3> <p class="decl"><a href="Poco.URI.html" title="class Poco::URI">URI</a> & operator = (<br /> const <a href="Poco.URI.html" title="class Poco::URI">URI</a> & uri<br />);</p> <div class="description"> <p>Assignment operator. </p> </div> <h3><a name="11391">operator =</a></h3> <p class="decl"><a href="Poco.URI.html" title="class Poco::URI">URI</a> & operator = (<br /> const std::string & uri<br />);</p> <div class="description"> <p>Parses and assigns an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from the given string. Throws a <a href="Poco.SyntaxException.html" title="class Poco::SyntaxException">SyntaxException</a> if the uri is not valid. </p> </div> <h3><a name="11393">operator =</a></h3> <p class="decl"><a href="Poco.URI.html" title="class Poco::URI">URI</a> & operator = (<br /> const char * uri<br />);</p> <div class="description"> <p>Parses and assigns an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from the given string. Throws a <a href="Poco.SyntaxException.html" title="class Poco::SyntaxException">SyntaxException</a> if the uri is not valid. </p> </div> <h3><a name="11436">operator ==</a></h3> <p class="decl">bool operator == (<br /> const <a href="Poco.URI.html" title="class Poco::URI">URI</a> & uri<br />) const;</p> <div class="description"> <p>Returns true if both URIs are identical, false otherwise. </p> <p>Two URIs are identical if their scheme, authority, path, query and fragment part are identical. </p> </div> <h3><a name="11438">operator ==</a></h3> <p class="decl">bool operator == (<br /> const std::string & uri<br />) const;</p> <div class="description"> <p>Parses the given <a href="Poco.URI.html" title="class Poco::URI">URI</a> and returns true if both URIs are identical, false otherwise. </p> </div> <h3><a name="11430">resolve</a></h3> <p class="decl">void resolve(<br /> const std::string & relativeURI<br />);</p> <div class="description"> <p>Resolves the given relative <a href="Poco.URI.html" title="class Poco::URI">URI</a> against the base <a href="Poco.URI.html" title="class Poco::URI">URI</a>. See section 5.2 of <a href="http://www.ietf.org/rfc/rfc3986.txt" target="_blank">RFC 3986</a> for the algorithm used. </p> </div> <h3><a name="11432">resolve</a></h3> <p class="decl">void resolve(<br /> const <a href="Poco.URI.html" title="class Poco::URI">URI</a> & relativeURI<br />);</p> <div class="description"> <p>Resolves the given relative <a href="Poco.URI.html" title="class Poco::URI">URI</a> against the base <a href="Poco.URI.html" title="class Poco::URI">URI</a>. See section 5.2 of <a href="http://www.ietf.org/rfc/rfc3986.txt" target="_blank">RFC 3986</a> for the algorithm used. </p> </div> <h3><a name="11412">setAuthority</a></h3> <p class="decl">void setAuthority(<br /> const std::string & authority<br />);</p> <div class="description"> <p>Parses the given authority part for the <a href="Poco.URI.html" title="class Poco::URI">URI</a> and sets the user-info, host, port components accordingly. </p> </div> <h3><a name="11424">setFragment</a></h3> <p class="decl">void setFragment(<br /> const std::string & fragment<br />);</p> <div class="description"> <p>Sets the fragment part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11406">setHost</a></h3> <p class="decl">void setHost(<br /> const std::string & host<br />);</p> <div class="description"> <p>Sets the host part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11415">setPath</a></h3> <p class="decl">void setPath(<br /> const std::string & path<br />);</p> <div class="description"> <p>Sets the path part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11426">setPathEtc</a></h3> <p class="decl">void setPathEtc(<br /> const std::string & pathEtc<br />);</p> <div class="description"> <p>Sets the path, query and fragment parts of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11409">setPort</a></h3> <p class="decl">void setPort(<br /> unsigned short port<br />);</p> <div class="description"> <p>Sets the port number part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11418">setQuery</a></h3> <p class="decl">void setQuery(<br /> const std::string & query<br />);</p> <div class="description"> <p>Sets the query part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11421">setRawQuery</a></h3> <p class="decl">void setRawQuery(<br /> const std::string & query<br />);</p> <div class="description"> <p>Sets the query part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11400">setScheme</a></h3> <p class="decl">void setScheme(<br /> const std::string & scheme<br />);</p> <div class="description"> <p>Sets the scheme part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. The given scheme is converted to lower-case. </p> <p>A list of registered <a href="Poco.URI.html" title="class Poco::URI">URI</a> schemes can be found at <<a href="http://www.iana.org/assignments/uri-schemes" target="_blank">http://www.iana.org/assignments/uri-schemes</a>>. </p> </div> <h3><a name="11403">setUserInfo</a></h3> <p class="decl">void setUserInfo(<br /> const std::string & userInfo<br />);</p> <div class="description"> <p>Sets the user-info part of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> </div> <h3><a name="11395">swap</a></h3> <p class="decl">void swap(<br /> <a href="Poco.URI.html" title="class Poco::URI">URI</a> & uri<br />);</p> <div class="description"> <p>Swaps the <a href="Poco.URI.html" title="class Poco::URI">URI</a> with another one. </p> </div> <h3><a name="11398">toString</a></h3> <p class="decl">std::string toString() const;</p> <div class="description"> <p>Returns a string representation of the <a href="Poco.URI.html" title="class Poco::URI">URI</a>. </p> <p>Characters in the path, query and fragment parts will be percent-encoded as necessary. </p> </div> <h3><a name="11485">buildPath</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void buildPath(<br /> const std::vector < std::string > & segments,<br /> bool leadingSlash,<br /> bool trailingSlash<br />);</p> <div class="description"> <p>Builds the path from the given segments. </p> </div> <h3><a name="11454">equals</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">bool equals(<br /> const <a href="Poco.URI.html" title="class Poco::URI">URI</a> & uri<br />) const;</p> <div class="description"> <p>Returns true if both uri's are equivalent. </p> </div> <h3><a name="11482">getPathSegments</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 getPathSegments(<br /> const std::string & path,<br /> std::vector < std::string > & segments<br />);</p> <div class="description"> <p>Places the single path segments (delimited by slashes) into the given vector. </p> </div> <h3><a name="11457">getWellKnownPort</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">unsigned short getWellKnownPort() const;</p> <div class="description"> <p>Returns the well-known port number for the <a href="Poco.URI.html" title="class Poco::URI">URI</a>'s scheme, or 0 if the port number is not known. </p> </div> <h3><a name="11456">isWellKnownPort</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">bool isWellKnownPort() const;</p> <div class="description"> <p>Returns true if the <a href="Poco.URI.html" title="class Poco::URI">URI</a>'s port number is a well-known one (for example, 80, if the scheme is http). </p> </div> <h3><a name="11478">mergePath</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void mergePath(<br /> const std::string & path<br />);</p> <div class="description"> <p>Appends a path to the <a href="Poco.URI.html" title="class Poco::URI">URI</a>'s path. </p> </div> <h3><a name="11458">parse</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void parse(<br /> const std::string & uri<br />);</p> <div class="description"> <p>Parses and assigns an <a href="Poco.URI.html" title="class Poco::URI">URI</a> from the given string. Throws a <a href="Poco.SyntaxException.html" title="class Poco::SyntaxException">SyntaxException</a> if the uri is not valid. </p> </div> <h3><a name="11460">parseAuthority</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void parseAuthority(<br /> std::string::const_iterator & it,<br /> const std::string::const_iterator & end<br />);</p> <div class="description"> <p>Parses and sets the user-info, host and port from the given data. </p> </div> <h3><a name="11475">parseFragment</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void parseFragment(<br /> std::string::const_iterator & it,<br /> const std::string::const_iterator & end<br />);</p> <div class="description"> <p>Parses and sets the fragment from the given data. </p> </div> <h3><a name="11463">parseHostAndPort</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void parseHostAndPort(<br /> std::string::const_iterator & it,<br /> const std::string::const_iterator & end<br />);</p> <div class="description"> <p>Parses and sets the host and port from the given data. </p> </div> <h3><a name="11466">parsePath</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void parsePath(<br /> std::string::const_iterator & it,<br /> const std::string::const_iterator & end<br />);</p> <div class="description"> <p>Parses and sets the path from the given data. </p> </div> <h3><a name="11469">parsePathEtc</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void parsePathEtc(<br /> std::string::const_iterator & it,<br /> const std::string::const_iterator & end<br />);</p> <div class="description"> <p>Parses and sets the path, query and fragment from the given data. </p> </div> <h3><a name="11472">parseQuery</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void parseQuery(<br /> std::string::const_iterator & it,<br /> const std::string::const_iterator & end<br />);</p> <div class="description"> <p>Parses and sets the query from the given data. </p> </div> <h3><a name="11480">removeDotSegments</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void removeDotSegments(<br /> bool removeLeading = true<br />);</p> <div class="description"> <p>Removes all dot segments from the path. </p> </div> <h2>Variables</h2> <h3><a name="11492">ILLEGAL</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 const std::string <a href="Poco.URI.html#11492" title="Poco::URI::ILLEGAL">ILLEGAL</a>;</p> <div class="description"> <p></p> </div> <h3><a name="11491">RESERVED_FRAGMENT</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 const std::string <a href="Poco.URI.html#11491" title="Poco::URI::RESERVED_FRAGMENT">RESERVED_FRAGMENT</a>;</p> <div class="description"> <p></p> </div> <h3><a name="11489">RESERVED_PATH</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 const std::string <a href="Poco.URI.html#11489" title="Poco::URI::RESERVED_PATH">RESERVED_PATH</a>;</p> <div class="description"> <p></p> </div> <h3><a name="11490">RESERVED_QUERY</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 const std::string <a href="Poco.URI.html#11490" title="Poco::URI::RESERVED_QUERY">RESERVED_QUERY</a>;</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>