X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ce321570b08e1a2937415ef6388a1a98fd1c4b83..9379c0d752144826342fa2688a77aa5cccea3d9b:/docs/latex/wx/url.tex diff --git a/docs/latex/wx/url.tex b/docs/latex/wx/url.tex index 7452671911..cd06c6688f 100644 --- a/docs/latex/wx/url.tex +++ b/docs/latex/wx/url.tex @@ -1,13 +1,16 @@ \section{\class{wxURL}}\label{wxurl} -Parses URLs. +wxURL is a specialization of \helpref{wxURI}{wxuri} for parsing URLs. +Please look at \helpref{wxURI}{wxuri} documentation for more info about the functions +you can use to retrieve the various parts of the URL (scheme, server, port, etc). Supports standard assignment operators, copy constructors, and comparison operators. \wxheading{Derived from} -\helpref{wxURI}{wxuri} +\helpref{wxURI}{wxuri}\\ +\helpref{wxObject}{wxobject} \wxheading{Include files} @@ -25,13 +28,16 @@ and comparison operators. \membersection{wxURL::wxURL}\label{wxurlctor} -\func{}{wxURL}{\param{const wxString\&}{ url}} +\func{}{wxURL}{\param{const wxString\&}{ url = wxEmptyString}} 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. +{\tt file://hostname/path/to/file} otherwise \helpref{GetError}{wxurlgeterror} +will return a value different from {\tt wxURL\_NOERR}. + +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 +(e.g. {\tt file:///somepath/myfile}). \wxheading{Parameters} @@ -80,9 +86,9 @@ It can be one of these errors: \func{wxInputStream *}{GetInputStream}{\void} -Creates a new input stream on the 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. +Creates a new input stream on the specified URL. You can use all but seek +functionality of wxStream. Seek isn't available on all streams. For example, +HTTP or FTP streams don't deal with it. Note that this method is somewhat depreciated, all future wxWidgets applications should really use \helpref{wxFileSystem}{wxfilesystem} instead. @@ -108,6 +114,18 @@ Returns the initialized stream. You will have to delete it yourself. \helpref{wxInputStream}{wxinputstream} + +% +% IsOk +% +\membersection{wxURL::IsOk}\label{wxurlgetisok} + +\constfunc{bool}{IsOk}{\void} + +Returns \true if this object is correctly initialized, i.e. if +\helpref{GetError}{wxurlgeterror} returns {\tt wxURL\_NOERR}. + + % % SetDefaultProxy % @@ -139,3 +157,14 @@ Sets the proxy to use for this URL. \helpref{wxURL::SetDefaultProxy}{wxurlsetdefaultproxy} + +% +% SetURL +% +\membersection{wxURL::SetURL}\label{wxurlseturl} + +\func{wxURLError}{SetURL}{\param{const wxString\&}{ url}} + +Initializes this object with the given URL and returns {\tt wxURL\_NOERR} +if it's valid (see \helpref{GetError}{wxurlgeterror} for more info). +