X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/8404931e0d899429c99c0081b18703e8609eb94a..bcf576ccfe754a634034203aa133c02fb5d2f964:/docs/latex/wx/uri.tex diff --git a/docs/latex/wx/uri.tex b/docs/latex/wx/uri.tex index 5b1bfab4bb..6b06deb7f0 100644 --- a/docs/latex/wx/uri.tex +++ b/docs/latex/wx/uri.tex @@ -22,13 +22,16 @@ In short, a URL \em{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. \wxheading{Derived from} -No base class +\helpref{wxObject}{wxobject} \wxheading{Include files} @@ -36,10 +39,10 @@ No base class \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{Obtaining individual components} +\membersection{Obtaining individual components}\label{obtainingwxuricomponents} To obtain individual components you can use -one of the following methods: +one of the following methods \helpref{GetScheme}{wxurigetscheme}\\ \helpref{GetUser}{wxurigetuser}\\ @@ -50,8 +53,12 @@ one of the following methods: \helpref{GetFragment}{wxurigetfragment} However, you should check HasXXX before -calling a get method:\\ - +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 equivilent to a +NULL C string.\\ +\\ \helpref{HasScheme}{wxurihasscheme}\\ \helpref{HasUser}{wxurihasuser}\\ \helpref{HasServer}{wxurihasserver}\\ @@ -88,23 +95,39 @@ Copies this URI from another URI. \docparam{uri}{URI (Uniform Resource Identifier) to initialize with} -\membersection{wxURI::Create}\label{wxuricreate} +\membersection{wxURI::BuildURI}\label{wxuribuilduri} -\func{void}{Create}{\param{const wxChar* }{uri}} +\constfunc{wxString}{BuildURI}{\void} -Creates this URI from the string {\tt uri}. +Builds the URI from its individual components and adds proper seperators. -\docparam{uri}{string to initialize from} +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. -\membersection{wxURI::Get}\label{wxuriget} -\constfunc{wxString}{Get}{\void} +\membersection{wxURI::BuildUnescapedURI}\label{wxuribuildunescapeduri} -Obtains the full URI. +\constfunc{wxString}{BuildUnescapedURI}{\void} + +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 +\helpref{BuildUnescapedURI}{wxuribuildunescapeduri} performs some optimizations over the plain method. + + +\membersection{wxURI::Create}\label{wxuricreate} + +\func{const wxChar*}{Create}{\param{const wxChar* }{uri}} + +Creates this URI from the string \arg{uri}. + +Returns the position at which parsing stopped (there +is no such thing as an "invalid" wxURI). + +\docparam{uri}{string to initialize from} -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. \membersection{wxURI::GetFragment}\label{wxurigetfragment} @@ -217,64 +240,64 @@ that is postfixed by a '@' character. \constfunc{bool}{HasFragment}{\void} -Returns true if the Fragment component of the URI exists. +Returns \true if the Fragment component of the URI exists. \membersection{wxURI::HasPath}\label{wxurihaspath} \constfunc{bool}{HasPath}{\void} -Returns true if the Path component of the URI exists. +Returns \true if the Path component of the URI exists. \membersection{wxURI::HasPort}\label{wxurihasport} \constfunc{bool}{HasPort}{\void} -Returns true if the Port component of the URI exists. +Returns \true if the Port component of the URI exists. \membersection{wxURI::HasQuery}\label{wxurihasquery} \constfunc{bool}{HasQuery}{\void} -Returns true if the Query component of the URI exists. +Returns \true if the Query component of the URI exists. \membersection{wxURI::HasScheme}\label{wxurihasscheme} \constfunc{bool}{HasScheme}{\void} -Returns true if the Scheme component of the URI exists. +Returns \true if the Scheme component of the URI exists. \membersection{wxURI::HasServer}\label{wxurihasserver} \constfunc{bool}{HasServer}{\void} -Returns true if the Server component of the URI exists. +Returns \true if the Server component of the URI exists. \membersection{wxURI::HasUser}\label{wxurihasuser} \constfunc{bool}{HasUser}{\void} -Returns true if the User component of the URI exists. +Returns \true if the User component of the URI exists. \membersection{wxURI::IsReference}\label{wxuriisreference} \constfunc{bool}{IsReference}{\void} -Returns true if a valid [absolute] URI, otherwise this URI +Returns \true if a valid [absolute] URI, otherwise this URI is a URI reference and not a full URI, and IsReference -returns false. +returns \false. \membersection{wxURI::operator ==}\label{wxurioperatorcompare} \func{void}{operator ==}{\param{const wxURI\& }{uricomp}} -Compares this URI to another URI, and returns true if -this URI equals {\tt uricomp}, otherwise it returns false. +Compares this URI to another URI, and returns \true if +this URI equals \arg{uricomp}, otherwise it returns \false. \docparam{uricomp}{URI to compare to} @@ -300,3 +323,18 @@ of the base's is merged with this URI's path, resulting in the URI mode some compatability layers are enabled to allow loopholes from RFCs prior to 2396} +\membersection{wxURI::Unescape}\label{wxuriunescape} + +\func{wxString}{Unescape}{\param{const wxString\& }{uri}} + +Translates all escape sequences (% hex hex) of \arg{uri} into +normal characters and returns the result. + +This is the preferred over deprecated wxURL::ConvertFromURI. + +If you want to unescape an entire wxURI, use \helpref{BuildUnescapedURI}{wxuribuildunescapeduri} instead, +as it performs some optimizations over this method. + +\docparam{uri}{string with escaped characters to convert} + +