Applied #14000 (wxRichTextXMLHandler interface fixes)

[wxWidgets.git] / interface / wx / uri.h

diff --git a/interface/wx/uri.h b/interface/wx/uri.h
index 4c36e3944570f140e5d2e922b621e77253d28721..2df4eb69544543f7890fed324b16a807bee589f7 100644 (file)
--- a/interface/wx/uri.h
+++ b/interface/wx/uri.h
@@ -3,7 +3,7 @@
 // Purpose:     interface of wxURI
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /**
@@ -19,13 +19,10 @@ enum wxURIHostType
 
 /**
     @class wxURI
-    @wxheader{uri.h}
 
-    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.
@@ -34,7 +31,7 @@ enum wxURIHostType
     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
@@ -43,13 +40,12 @@ enum wxURIHostType
     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,
@@ -57,7 +53,7 @@ enum wxURIHostType
           wxFileSystem, the old wxURL, and older url specifications.
 
     @library{wxbase}
-    @category{data}
+    @category{net}
 
     @see wxURL
 */
@@ -68,13 +64,15 @@ public:
         Creates an empty URI.
     */
     wxURI();
+
     /**
         Constructor for quick creation.
 
         @param uri
             URI (Uniform Resource Identifier) to initialize with.
     */
-    wxURI(const wxChar* uri);
+    wxURI(const wxString& uri);
+
     /**
         Copies this URI from another URI.
 
@@ -105,13 +103,12 @@ public:
     /**
         Creates this URI from the @a uri string.
 
-        Returns the position at which parsing stopped (there is no such thing
-        as an "invalid" wxURI).
+        Returns @true if this instance was correctly initialized.
 
         @param uri
             String to initialize from.
     */
-    const wxChar* Create(const wxString uri);
+    bool Create(const wxString& uri);
 
     /**
         Obtains the fragment of this URI.
@@ -126,7 +123,7 @@ public:
     /**
         Obtains the host type of this URI, which is one of wxURIHostType.
     */
-    const wxURIHostType& GetHostType() const;
+    wxURIHostType GetHostType() const;
 
     /**
         Returns the password part of the userinfo component of this URI. Note
@@ -135,7 +132,7 @@ public:
 
         @c "http://<user>:<password>@mysite.com/mypath"
     */
-    const wxString& GetPassword() const;
+    wxString GetPassword() const;
 
     /**
         Returns the (normalized) path of the URI.
@@ -200,7 +197,7 @@ public:
 
         @c "http://<user>:<password>@mysite.com/mypath"
     */
-    const wxString& GetUser() const;
+    wxString GetUser() const;
 
     /**
         Returns the UserInfo component of the URI.
@@ -276,8 +273,7 @@ public:
     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.
@@ -285,7 +281,7 @@ public:
         @param uri
             String with escaped characters to convert.
     */
-    wxString Unescape(const wxString& uri);
+    static wxString Unescape(const wxString& uri);
 
     /**
         Compares this URI to another URI, and returns @true if this URI equals
@@ -294,6 +290,6 @@ public:
         @param uricomp
             URI to compare to.
     */
-    void operator ==(const wxURI& uricomp);
+    bool operator==(const wxURI& uricomp) const;
 };