xref: /third_party/curl/docs/examples/parseurl.c (revision 13498266)
1/***************************************************************************
2 *                                  _   _ ____  _
3 *  Project                     ___| | | |  _ \| |
4 *                             / __| | | | |_) | |
5 *                            | (__| |_| |  _ <| |___
6 *                             \___|\___/|_| \_\_____|
7 *
8 * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
9 *
10 * This software is licensed as described in the file COPYING, which
11 * you should have received as part of this distribution. The terms
12 * are also available at https://curl.se/docs/copyright.html.
13 *
14 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 * copies of the Software, and permit persons to whom the Software is
16 * furnished to do so, under the terms of the COPYING file.
17 *
18 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 * KIND, either express or implied.
20 *
21 * SPDX-License-Identifier: curl
22 *
23 ***************************************************************************/
24/* <DESC>
25 * Basic URL API use.
26 * </DESC>
27 */
28#include <stdio.h>
29#include <curl/curl.h>
30
31#if !CURL_AT_LEAST_VERSION(7, 62, 0)
32#error "this example requires curl 7.62.0 or later"
33#endif
34
35int main(void)
36{
37  CURLU *h;
38  CURLUcode uc;
39  char *host;
40  char *path;
41
42  h = curl_url(); /* get a handle to work with */
43  if(!h)
44    return 1;
45
46  /* parse a full URL */
47  uc = curl_url_set(h, CURLUPART_URL, "http://example.com/path/index.html", 0);
48  if(uc)
49    goto fail;
50
51  /* extract host name from the parsed URL */
52  uc = curl_url_get(h, CURLUPART_HOST, &host, 0);
53  if(!uc) {
54    printf("Host name: %s\n", host);
55    curl_free(host);
56  }
57
58  /* extract the path from the parsed URL */
59  uc = curl_url_get(h, CURLUPART_PATH, &path, 0);
60  if(!uc) {
61    printf("Path: %s\n", path);
62    curl_free(path);
63  }
64
65  /* redirect with a relative URL */
66  uc = curl_url_set(h, CURLUPART_URL, "../another/second.html", 0);
67  if(uc)
68    goto fail;
69
70  /* extract the new, updated path */
71  uc = curl_url_get(h, CURLUPART_PATH, &path, 0);
72  if(!uc) {
73    printf("Path: %s\n", path);
74    curl_free(path);
75  }
76
77fail:
78  curl_url_cleanup(h); /* free url handle */
79  return 0;
80}
81