Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

curl_url (3)

Name

curl_url - returns a new CURLU handle

Synopsis

#include <curl/curl.h>

CURLU *curl_url();

Description

curl_url(3)                     libcurl Manual                     curl_url(3)



NAME
       curl_url - returns a new CURLU handle

SYNOPSIS
       #include <curl/curl.h>

       CURLU *curl_url();

EXPERIMENTAL
       The  URL  API  is  considered EXPERIMENTAL until further notice. Please
       test it, report bugs and help us perfect it. Once proven  to  be  reli-
       able, the experimental label will be removed.

       While  this  API is marked experimental, we reserve the right to modify
       the API slightly if we deem it necessary and it makes it notably better
       or easier to use.

DESCRIPTION
       This  function  will  allocates  and returns a pointer to a fresh CURLU
       handle, to be used for further use of the URL API.

RETURN VALUE
       Returns a CURLU * if successful, or NULL if out of memory.

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
       Added in curl 7.62.0


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       curl_url_cleanup(3), curl_url_get(3), curl_url_set(3), curl_url_dup(3),



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source   was    downloaded    from     https://github.com/curl/curl/ar-
       chive/curl-7_64_0.zip

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.



libcurl                           6 Aug 2018                       curl_url(3)