These functions are part of the Globus common library. The GLOBUS_COMMON module must be activated in order to use them.
enum globus_url_scheme_t |
URL Schemes.
The Globus URL library supports a set of URL schemes (protocols). This enumeration can be used to quickly dispatch a parsed URL based on a constant value.
int globus_url_parse | ( | const char * | url_string, | |
globus_url_t * | url | |||
) |
Parse a string containing a URL into a globus_url_t.
url_string | String to parse | |
url | Pointer to globus_url_t to be filled with the fields of the url |
GLOBUS_SUCCESS | The string was successfully parsed. | |
GLOBUS_URL_ERROR_NULL_STRING | The url_string was GLOBUS_NULL. | |
GLOBUS_URL_ERROR_NULL_URL | The URL pointer was GLOBUS_NULL. | |
GLOBUS_URL_ERROR_BAD_SCHEME | The URL scheme (protocol) contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_USER | The user part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_PASSWORD | The password part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_HOST | The host part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_PORT | The port part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_PATH | The path part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_DN | -9 The DN part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_ATTRIBUTES | -10 The attributes part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_SCOPE | -11 The scope part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_FILTER | -12 The filter part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_OUT_OF_MEMORY | -13 The library was unable to allocate memory to create the the globus_url_t contents. | |
GLOBUS_URL_ERROR_INTERNAL_ERROR | -14 Some unexpected error occurred parsing the URL. |
int globus_url_parse_rfc1738 | ( | const char * | url_string, | |
globus_url_t * | url | |||
) |
Parse a string containing a URL into a globus_url_t.
url_string | String to parse | |
url | Pointer to globus_url_t to be filled with the fields of the url |
GLOBUS_SUCCESS | The string was successfully parsed. | |
GLOBUS_URL_ERROR_NULL_STRING | The url_string was GLOBUS_NULL. | |
GLOBUS_URL_ERROR_NULL_URL | The URL pointer was GLOBUS_NULL. | |
GLOBUS_URL_ERROR_BAD_SCHEME | The URL scheme (protocol) contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_USER | The user part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_PASSWORD | The password part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_HOST | The host part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_PORT | The port part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_PATH | The path part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_DN | -9 The DN part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_ATTRIBUTES | -10 The attributes part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_SCOPE | -11 The scope part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_FILTER | -12 The filter part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_OUT_OF_MEMORY | -13 The library was unable to allocate memory to create the the globus_url_t contents. | |
GLOBUS_URL_ERROR_INTERNAL_ERROR | -14 Some unexpected error occurred parsing the URL. |
int globus_url_parse_loose | ( | const char * | url_string, | |
globus_url_t * | url | |||
) |
Parse a string containing a URL into a globus_url_t Looser restrictions on characters allowed in the path part of the URL.
url_string | String to parse | |
url | Pointer to globus_url_t to be filled with the fields of the url |
GLOBUS_SUCCESS | The string was successfully parsed. | |
GLOBUS_URL_ERROR_NULL_STRING | The url_string was GLOBUS_NULL. | |
GLOBUS_URL_ERROR_NULL_URL | The URL pointer was GLOBUS_NULL. | |
GLOBUS_URL_ERROR_BAD_SCHEME | The URL scheme (protocol) contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_USER | The user part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_PASSWORD | The password part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_HOST | The host part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_PORT | The port part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_PATH | The path part of the URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_DN | -9 The DN part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_ATTRIBUTES | -10 The attributes part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_SCOPE | -11 The scope part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_BAD_FILTER | -12 The filter part of an LDAP URL contained invalid characters. | |
GLOBUS_URL_ERROR_OUT_OF_MEMORY | -13 The library was unable to allocate memory to create the the globus_url_t contents. | |
GLOBUS_URL_ERROR_INTERNAL_ERROR | -14 Some unexpected error occurred parsing the URL. |
int globus_url_destroy | ( | globus_url_t * | url | ) |
Destroy a globus_url_t structure.
This function frees all memory associated with a globus_url_t structure.
url | The url structure to destroy |
GLOBUS_SUCCESS | The URL was successfully destroyed. |
int globus_url_get_scheme | ( | const char * | url_string, | |
globus_url_scheme_t * | scheme_type | |||
) |
Get the scheme of an URL.
This function determines the scheme type of the url string, and populates the variable pointed to by second parameter with that value. This performs a less expensive parsing than globus_url_parse() and is suitable for applications which need only to choose a handler based on the URL scheme.
url_string | The string containing the URL. | |
scheme_type | A pointer to a globus_url_scheme_t which will be set to the scheme. |
GLOBUS_SUCCESS | The URL scheme was recogized, and scheme_type has been updated. | |
GLOBUS_URL_ERROR_BAD_SCHEME | The URL scheme was not recogized. |
int globus_url_copy | ( | globus_url_t * | dst, | |
const globus_url_t * | src | |||
) |
Create a copy of an URL structure.
This function copies the contents of a url structure into another.
dst | The URL structure to be populated with a copy of the contents of src. | |
src | The original URL. |
GLOBUS_SUCCESS | The URL was successfully copied. | |
GLOBUS_URL_ERROR_NULL_URL | One of the URLs was GLOBUS_NULL. | |
GLOBUS_URL_ERROR_OUT_OF_MEMORY; | The library was unable to allocate memory to create the the globus_url_t contents. |
about globus |
globus toolkit |
dev.globus
Comments? webmaster@globus.org