wxURI is used to extract information from a URI (Uniform Resource Identifier).
For information about URIs, see
RFC 3986 (
In short, a URL is a URI. In other words, URL is a subset of a URI - all acceptable URLs are also acceptable URIs.
wxURI automatically escapes invalid characters in a string, so there is no 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.
To obtain individual components you can use one of the following methods
However, you should check HasXXX before calling a get method, which determines whether or not the component referred to by the method is defined according to RFC 2396.
Consider an undefined component equivalent to a
NULL C string.
//protocol will hold the http protocol (i.e. "http") wxString protocol; wxURI myuri(wxT("http://mysite.com")); if(myuri.HasScheme()) protocol = myuri.GetScheme();
Creates an empty URI.
Constructor for quick creation.
Copies this URI from another URI.
wxString BuildURI(void) const
Builds the URI from its individual components and adds proper seperators.
If the URI is not a reference or is not resolved, the URI that is returned from Get is the same one passed to Create.
wxString BuildUnescapedURI(void) const
Builds the URI from its individual components, adds proper seperators, and returns escape sequences to normal characters.
Note that it is preferred to call this over Unescape(BuildURI()) since BuildUnescapedURI performs some optimizations over the plain method.
Creates this URI from the string uri.
Returns the position at which parsing stopped (there is no such thing as an "invalid" wxURI).
const wxString& GetFragment(void) const
Obtains the fragment of this URI.
The fragment of a URI is the last value of the URI, and is the value after a '#' character after the path of the URI.
const HostType& GetHostType(void) const
Obtains the host type of this URI, which is of type wxURI::HostType:
|wxURI_REGNAME||Server is a host name, or the Server component itself is undefined.|
|wxURI_IPV4ADDRESS||Server is a IP version 4 address (XXX.XXX.XXX.XXX)|
|wxURI_IPV6ADDRESS||Server is a IP version 6 address ((XXX:)XXX::(XXX)XXX:XXX|
|wxURI_IPVFUTURE||Server is an IP address, but not versions 4 or 6|
const wxString& GetPassword(void) const
Returns the password part of the userinfo component of this URI. Note that this is explicitly depreciated by RFC 1396 and should generally be avoided if possible.
const wxString& GetPath(void) const
Returns the (normalized) path of the URI.
The path component of a URI comes directly after the scheme component if followed by zero or one slashes ('/'), or after the server/port component.
Absolute paths include the leading '/' character.
const wxString& GetPort(void) const
Returns a string representation of the URI's port.
The Port of a URI is a value after the server, and must come after a colon (:).
Note that you can easily get the numeric value of the port by using wxAtoi or wxString::Format.
const wxString& GetQuery(void) const
Returns the Query component of the URI.
The query component is what is commonly passed to a cgi application, and must come after the path component, and after a '?' character.
const wxString& GetScheme(void) const
Returns the Scheme component of the URI.
The first part of the uri.
const wxString& GetServer(void) const
Returns the Server component of the URI.
The server of the uri can be a server name or a type of ip address. See GetHostType for the possible values for the host type of the server component.
const wxString& GetUser(void) const
Returns the username part of the userinfo component of this URI. Note that this is explicitly depreciated by RFC 1396 and should generally be avoided if possible.
const wxString& GetUserInfo(void) const
Returns the UserInfo component of the URI.
The component of a URI before the server component that is postfixed by a '@' character.
bool HasFragment(void) const
Returns TRUEif the Fragment component of the URI exists.
bool HasPath(void) const
Returns TRUEif the Path component of the URI exists.
bool HasPort(void) const
Returns TRUEif the Port component of the URI exists.
bool HasQuery(void) const
Returns TRUEif the Query component of the URI exists.
bool HasScheme(void) const
Returns TRUEif the Scheme component of the URI exists.
bool HasServer(void) const
Returns TRUEif the Server component of the URI exists.
bool HasUser(void) const
Returns TRUEif the User component of the URI exists.
bool IsReference(void) const
Returns TRUEif a valid [absolute] URI, otherwise this URI is a URI reference and not a full URI, and IsReference returns FALSE.
Compares this URI to another URI, and returns TRUEif this URI equals uricomp, otherwise it returns FALSE.
Inherits this URI from a base URI - components that do not exist in this URI are copied from the base, and if this URI's path is not an absolute path (prefixed by a '/'), then this URI's path is merged with the base's path.
For instance, resolving "../mydir" from "http://mysite.com/john/doe" results in the scheme (http) and server (mysite.com) being copied into this URI, since they do not exist. In addition, since the path of this URI is not absolute (does not begin with '/'), the path of the base's is merged with this URI's path, resulting in the URI "http://mysite.com/john/mydir".
Translates all escape sequences (normal characters and returns the result.
This is the preferred over deprecated wxURL::ConvertFromURI.
If you want to unescape an entire wxURI, use BuildUnescapedURI instead, as it performs some optimizations over this method.