NAME¶

SYNOPSIS¶

CURLUcode curl_url_get(CURLU *url,
                       CURLUPart what,
                       char **part,
                       unsigned int flags)

DESCRIPTION¶

The what argument should be the particular part to extract (see list below) and part points to a 'char *' to get updated to point to a newly allocated string with the contents.

The flags argument is a bitmask with individual features.

The returned part pointer must be freed with curl_free(3) after use.

FLAGS¶

CURLU_DEFAULT_PORT

If the handle has no port stored, this option will make curl_url_get(3) return the default port for the used scheme.

CURLU_DEFAULT_SCHEME

If the handle has no scheme stored, this option will make curl_url_get(3) return the default scheme instead of error.

CURLU_NO_DEFAULT_PORT

Instructs curl_url_get(3) to not return a port number if it matches the default port for the scheme.

CURLU_URLDECODE

Asks curl_url_get(3) to URL decode the contents before returning it. It will not attempt to decode the scheme, the port number or the full URL.

The query component will also get plus-to-space conversion as a bonus when this bit is set.

Note that this URL decoding is charset unaware and you will get a zero terminated string back with data that could be intended for a particular encoding.

If there's any byte values lower than 32 in the decoded string, the get operation will return an error instead.

PARTS¶

CURLUPART_URL

When asked to return the full URL, curl_url_get(3) will return a normalized and possibly cleaned up version of what was previously parsed.

CURLUPART_SCHEME

Scheme cannot be URL decoded on get.

CURLUPART_USER

CURLUPART_PASSWORD

CURLUPART_OPTIONS

CURLUPART_HOST

CURLUPART_PORT

Port cannot be URL decoded on get.

CURLUPART_PATH

CURLUPART_QUERY

The query part will also get pluses converted to space when asked to URL decode on get with the CURLU_URLDECODE bit.

CURLUPART_FRAGMENT

RETURN VALUE¶

If this function returns an error, no URL part is returned.

EXAMPLE¶

  CURLUcode rc;
  CURLU *url = curl_url();
  rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
  if(!rc) {
    char *scheme;
    rc = curl_url_get(url, CURLUPART_SCHEME, &scheme, 0);
    if(!rc) {
      printf("the scheme is %s\n", scheme);
      curl_free(scheme);
    }
    curl_url_cleanup(url);
  }

AVAILABILITY¶

SEE ALSO¶