X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/b82827dd43caa489eade15cc02edef7fb79e8c20..3cdcf4d444770f7f0ff2ca64807d8699764ed8b3:/docs/latex/wx/url.tex diff --git a/docs/latex/wx/url.tex b/docs/latex/wx/url.tex index 91e6ceff73..04caeb84ed 100644 --- a/docs/latex/wx/url.tex +++ b/docs/latex/wx/url.tex @@ -1,8 +1,17 @@ \section{\class{wxURL}}\label{wxurl} +Parses URLs. + +Supports standard assignment operators, copy constructors, +and comparison operators. + \wxheading{Derived from} -\helpref{wxObject}{wxobject} +\helpref{wxURI}{wxuri} + +\wxheading{Include files} + + \wxheading{See also} @@ -12,37 +21,32 @@ % Members % ---------------------------------------------------------------------------- -\latexignore{\rtfignore{\membersection{Members}}} +\latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxURL::wxURL}\label{wxurlconstr} +\membersection{wxURL::wxURL}\label{wxurlctor} \func{}{wxURL}{\param{const wxString\&}{ url}} -Constructs an URL object from the string. +Constructs a URL object from the string. The URL must be valid according +to RFC 1738. In particular, file URLs must be of the format +'file://hostname/path/to/file'. It is valid to leave out the hostname +but slashes must remain in place-- i.e. a file URL without a hostname must +contain three consecutive slashes. \wxheading{Parameters} \docparam{url}{Url string to parse.} -\membersection{wxURL::\destruct{wxURL}} +\membersection{wxURL::\destruct{wxURL}}\label{wxurldtor} \func{}{\destruct{wxURL}}{\void} Destroys the URL object. -% -% GetProtocolName -% -\membersection{wxURL::GetProtocolName} - -\constfunc{wxString}{GetProtocolName}{\void} - -Returns the name of the protocol which will be used to get the URL. - % % GetProtocol % -\membersection{wxURL::GetProtocol} +\membersection{wxURL::GetProtocol}\label{wxurlgetprotocol} \func{wxProtocol\&}{GetProtocol}{\void} @@ -51,7 +55,7 @@ Returns a reference to the protocol which will be used to get the URL. % % GetError % -\membersection{wxURL::GetError} +\membersection{wxURL::GetError}\label{wxurlgeterror} \constfunc{wxURLError}{GetError}{\void} @@ -66,28 +70,43 @@ It can be one of these errors: \twocolitem{{\bf wxURL\_NOHOST}}{An host name is required for this protocol.} \twocolitem{{\bf wxURL\_NOPATH}}{A path is required for this protocol.} \twocolitem{{\bf wxURL\_CONNERR}}{Connection error.} -\twocolitem{{\bf wxURL\_PROTOERR}}{An error occured during negotiation.} +\twocolitem{{\bf wxURL\_PROTOERR}}{An error occurred during negotiation.} \end{twocollist}% % % GetInputStream % -\membersection{wxURL::GetInputStream} +\membersection{wxURL::GetInputStream}\label{wxurlgetinputstream} \func{wxInputStream *}{GetInputStream}{\void} -Creates a new input stream on the the specified URL. You can use all but seek -functionnality of wxStream. Seek isn't available on all stream. For example, +Creates a new input stream on the specified URL. You can use all but seek +functionality of wxStream. Seek isn't available on all stream. For example, http or ftp streams doesn't deal with it. +Note that this method is somewhat depreciated, all future wxWidgets applications +should really use \helpref{wxFileSystem}{wxfilesystem} instead. + +Example: + +\begin{verbatim} + wxURL url("http://a.host/a.dir/a.file"); + if (url.GetError() == wxURL_NOERR) + { + wxInputStream *in_stream; + + in_stream = url.GetInputStream(); + // Then, you can use all IO calls of in_stream (See wxStream) + } +\end{verbatim} + \wxheading{Return value} Returns the initialized stream. You will have to delete it yourself. \wxheading{See also} -%\helpref{wxInputStream}{wxinputstream} -wxInputStream +\helpref{wxInputStream}{wxinputstream} % % SetDefaultProxy