CURLOPT_CURLU(3)           curl_easy_setopt options           CURLOPT_CURLU(3)

NAME
       CURLOPT_CURLU - set URL with CURLU *

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CURLU, void *pointer);

DESCRIPTION
       Pass in a pointer to the URL to work with. The parameter should be a
       CURLU *. Setting _CURLU&section=3">CURLOPT_CURLU(3) will explicitly override
       _URL&section=3">CURLOPT_URL(3).

       _URL&section=3">CURLOPT_URL(3) or _CURLU&section=3">CURLOPT_CURLU(3) must be set before a transfer is
       started.

       libcurl will use this handle and its contents read-only and will not
       change its contents. An application can very well update the contents
       of the URL handle after a transfer is done and if the same handle is
       then used in a subsequent request the updated contents will then be
       used.

DEFAULT
       The default value of this parameter is NULL.

PROTOCOLS
       All

EXAMPLE
       CURL *handle = curl_easy_init();
       CURLU *urlp = curl_url();
       int res = 0;
       if(curl) {

         res = curl_url_set(urlp, CURLUPART_URL, "https://example.com", 0);

         curl_easy_setopt(handle, CURLOPT_CURLU, urlp);

         ret = curl_easy_perform(handle);

         curl_url_cleanup(urlp);
         curl_easy_cleanup(handle);
       }

AVAILABILITY
       Added in 7.63.0.

RETURN VALUE
       Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION
       if not.

SEE ALSO
       CURLOPT_URL(3),  curl_url(3), curl_url_get(3), curl_url_set(3),
       curl_url_dup(3), curl_url_cleanup(3),

libcurl 7.77.0                 February 21, 2021              CURLOPT_CURLU(3)