CURLOPT_WILDCARDMATCH - Man Page

directory wildcard transfers

Synopsis

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_WILDCARDMATCH, long onoff);

Description

Set onoff to 1 if you want to transfer multiple files according to a file name pattern. The pattern can be specified as part of the CURLOPT_URL(3) option, using an fnmatch-like pattern (Shell Pattern Matching) in the last part of URL (file name).

By default, libcurl uses its internal wildcard matching implementation. You can provide your own matching function by the CURLOPT_FNMATCH_FUNCTION(3) option.

A brief introduction of its syntax follows:

Protocols

This feature is only supported for FTP download.

Example

/* initialization of easy handle */
handle = curl_easy_init();

/* turn on wildcard matching */
curl_easy_setopt(handle, CURLOPT_WILDCARDMATCH, 1L);

/* callback is called before download of concrete file started */
curl_easy_setopt(handle, CURLOPT_CHUNK_BGN_FUNCTION, file_is_coming);

/* callback is called after data from the file have been transferred */
curl_easy_setopt(handle, CURLOPT_CHUNK_END_FUNCTION, file_is_downloaded);

/* See more on https://curl.se/libcurl/c/ftp-wildcard.html */

Availability

Added in 7.21.0

Return Value

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

See Also

CURLOPT_FNMATCH_FUNCTION(3), CURLOPT_URL(3),

Referenced By

curl_easy_setopt(3), CURLOPT_CHUNK_BGN_FUNCTION(3), CURLOPT_CHUNK_DATA(3), CURLOPT_CHUNK_END_FUNCTION(3), CURLOPT_DIRLISTONLY(3), CURLOPT_FNMATCH_DATA(3).

April 26, 2023 ibcurl 8.1.1 libcurl