don't place NULL pointers in the GDK window array in GTKGetWindow()

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

diff --git a/interface/wx/uri.h b/interface/wx/uri.h
index 82b38b4bb85e2609f9cb2c3dab0208df2c1f773c..1fa0cf6ac156b2a44629659c02cd98f73434a08e 100644 (file)
--- a/interface/wx/uri.h
+++ b/interface/wx/uri.h
@@ -20,11 +20,9 @@ enum wxURIHostType
 /**
     @class wxURI
 
 /**
     @class wxURI
 

-    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.
 
     In short, a URL is a URI. In other words, URL is a subset of a URI - all
     acceptable URLs are also acceptable URIs.


@@ -42,13 +40,12 @@ enum wxURIHostType
     to a @NULL C string.
 
     Example:
     to a @NULL C string.
 
     Example:

-

     @code
     @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,
     @endcode
 
     @note On URIs with a "file" scheme wxURI does not parse the userinfo,


@@ -56,7 +53,7 @@ enum wxURIHostType
           wxFileSystem, the old wxURL, and older url specifications.
 
     @library{wxbase}
           wxFileSystem, the old wxURL, and older url specifications.
 
     @library{wxbase}

-    @category{data}
+    @category{net}

 
     @see wxURL
 */
 
     @see wxURL
 */


@@ -67,13 +64,15 @@ public:
         Creates an empty URI.
     */
     wxURI();
         Creates an empty URI.
     */
     wxURI();

+

     /**
         Constructor for quick creation.
 
         @param uri
             URI (Uniform Resource Identifier) to initialize with.
     */
     /**
         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.
 
     /**
         Copies this URI from another URI.
 


@@ -104,13 +103,12 @@ public:
     /**
         Creates this URI from the @a uri string.
 
     /**
         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.
     */
 
         @param uri
             String to initialize from.
     */

-    const wxChar* Create(const wxString uri);
+    bool Create(const wxString& uri);

 
     /**
         Obtains the fragment of this URI.
 
     /**
         Obtains the fragment of this URI.


@@ -125,7 +123,7 @@ public:
     /**
         Obtains the host type of this URI, which is one of wxURIHostType.
     */
     /**
         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
 
     /**
         Returns the password part of the userinfo component of this URI. Note


@@ -134,7 +132,7 @@ public:
 
         @c "http://<user>:<password>@mysite.com/mypath"
     */
 
         @c "http://<user>:<password>@mysite.com/mypath"
     */

-    const wxString& GetPassword() const;
+    wxString GetPassword() const;

 
     /**
         Returns the (normalized) path of the URI.
 
     /**
         Returns the (normalized) path of the URI.


@@ -199,7 +197,7 @@ public:
 
         @c "http://<user>:<password>@mysite.com/mypath"
     */
 
         @c "http://<user>:<password>@mysite.com/mypath"
     */

-    const wxString& GetUser() const;
+    wxString GetUser() const;

 
     /**
         Returns the UserInfo component of the URI.
 
     /**
         Returns the UserInfo component of the URI.


@@ -275,8 +273,7 @@ public:
     void Resolve(const wxURI& base, int flags = wxURI_STRICT);
 
     /**
     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.
 
         If you want to unescape an entire wxURI, use BuildUnescapedURI()
         instead, as it performs some optimizations over this method.


@@ -284,7 +281,7 @@ public:
         @param uri
             String with escaped characters to convert.
     */
         @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
 
     /**
         Compares this URI to another URI, and returns @true if this URI equals


@@ -293,6 +290,6 @@ public:
         @param uricomp
             URI to compare to.
     */
         @param uricomp
             URI to compare to.
     */

-    void operator ==(const wxURI& uricomp);
+    bool operator==(const wxURI& uricomp) const;

 };
 
 };