Changeset 57720 in vbox for trunk/include

Timestamp:

Sep 11, 2015 2:49:21 PM (10 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

102634

Message:

RTUri: Preps for parsing the authority bits into smaller pieces for cURL proxy config.

Location:

trunk/include/iprt

Files:

• err.h (modified) (1 diff)
• mangling.h (modified) (1 diff)
• uri.h (modified) (2 diffs)

trunk/include/iprt/err.h

@@ -2496 +2496 @@
 /** @} */
 
+/** @name RTUri status codes.
+ * @{ */
+/** The URI is empty */
+#define VERR_URI_EMPTY                              (-24600)
+/** The URI is too short to be a valid URI. */
+#define VERR_URI_TOO_SHORT                          (-24601)
+/** Invalid scheme.  */
+#define VERR_URI_INVALID_SCHEME                     (-24602)
+/** Invalid port number.  */
+#define VERR_URI_INVALID_PORT_NUMBER                (-24603)
+/** @} */
+
 /* SED-END */
 

trunk/include/iprt/mangling.h

@@ -1859 +1859 @@
 # define RTUniFree                                      RT_MANGLER(RTUniFree)
 # define RTUriAuthority                                 RT_MANGLER(RTUriAuthority)
+# define RTUriAuthorityPassword                         RT_MANGLER(RTUriAuthorityPassword)
+# define RTUriAuthorityPort                             RT_MANGLER(RTUriAuthorityPort)
+# define RTUriAuthorityUsername                         RT_MANGLER(RTUriAuthorityUsername)
 # define RTUriCreate                                    RT_MANGLER(RTUriCreate)
 # define RTUriFileCreate                                RT_MANGLER(RTUriFileCreate)

trunk/include/iprt/uri.h

@@ -80 +80 @@
  * @returns the authority if the URI contains one, NULL otherwise.
  * @param   pszUri              The URI to extract from.
+ * @remarks The authority can have a zero length.
  */
 RTR3DECL(char *) RTUriAuthority(const char *pszUri);
+
+/**
+ * Extract the username out of the authority component in an URI.
+ *
+ * @returns The username if the URI contains one, otherwise NULL.
+ * @param   pszUri              The URI to extract from.
+ */
+RTR3DECL(char *) RTUriAuthorityUsername(const char *pszUri);
+
+/**
+ * Extract the password out of the authority component in an URI.
+ *
+ * @returns The password if the URI contains one, otherwise NULL.
+ * @param   pszUri              The URI to extract from.
+ */
+RTR3DECL(char *) RTUriAuthorityPassword(const char *pszUri);
+
+/**
+ * Extract the port number out of the authority component in an URI.
+ *
+ * @returns The port number if the URI contains one, otherwise UINT32_MAX.
+ * @param   pszUri              The URI to extract from.
+ */
+RTR3DECL(uint32_t) RTUriAuthorityPort(const char *pszUri);
 
 /**
@@ -121 +146 @@
 
 /**
- * Creates a file URI. The returned pointer must be freed
- * using RTStrFree().
+ * Creates a file URI.
+ *
+ * The returned pointer must be freed using RTStrFree().
  *
  * @see RTUriCreate
  *
- * @returns the new URI on success, NULL otherwise.
+ * @returns The new URI on success, NULL otherwise.  Free With RTStrFree.
  * @param   pszPath             The path of the URI.
  */