// Name: uri.h
// Purpose: interface of wxURI
// Author: wxWidgets team
-// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
/**
@class wxURI
- wxURI is used to extract information from a URI (Uniform Resource
- Identifier).
+ wxURI is used to extract information from a URI (Uniform Resource Identifier).
- For information about URIs, see RFC 3986
- <http://www.ietf.org/rfc/rfc3986.txt>.
+ For information about URIs, see RFC 3986 (http://www.ietf.org/rfc/rfc3986.txt).
In short, a URL is a URI. In other words, URL is a subset of a URI - all
acceptable URLs are also acceptable URIs.
chance of wxURI "failing" on construction/creation.
wxURI supports copy construction and standard assignment operators. wxURI
- can also be inherited from to provide furthur functionality.
+ can also be inherited from to provide further functionality.
To obtain individual components you can use one of the GetXXX() methods.
However, you should check HasXXX() before calling a get method, which
to a @NULL C string.
Example:
-
@code
- //protocol will hold the http protocol (i.e. "http")
- wxString protocol;
- wxURI myuri("http://mysite.com");
- if( myuri.HasScheme() )
- protocol = myuri.GetScheme();
+ // protocol will hold the http protocol (i.e. "http")
+ wxString protocol;
+ wxURI myuri("http://mysite.com");
+ if( myuri.HasScheme() )
+ protocol = myuri.GetScheme();
@endcode
@note On URIs with a "file" scheme wxURI does not parse the userinfo,
- server, or port portion. This is to keep compatability with
+ server, or port portion. This is to keep compatibility with
wxFileSystem, the old wxURL, and older url specifications.
@library{wxbase}
- @category{data}
+ @category{net}
@see wxURL
*/
/**
Returns @true if the User component of the URI exists.
*/
- bool HasUser() const;
+ bool HasUserInfo() const;
/**
Returns @true if a valid [absolute] URI, otherwise this URI is a URI
void Resolve(const wxURI& base, int flags = wxURI_STRICT);
/**
- Translates all escape sequences (normal characters and returns the
- result.
+ Translates all escape sequences (normal characters and returns the result.
If you want to unescape an entire wxURI, use BuildUnescapedURI()
instead, as it performs some optimizations over this method.