CURLOPT_FNMATCH_FUNCTION(3) Library Functions Manual NAME CURLOPT_FNMATCH_FUNCTION - wildcard match callback SYNOPSIS #include int fnmatch_callback(void *ptr, const char *pattern, const char *string); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FNMATCH_FUNCTION, fnmatch_callback); DESCRIPTION Pass a pointer to your callback function, which should match the prototype shown above. This callback is used for wildcard matching. Return CURL_FNMATCHFUNC_MATCH if pattern matches the string, CURL_FNMATCHFUNC_NOMATCH if not or CURL_FNMATCHFUNC_FAIL if an error occurred. DEFAULT NULL == an internal function for wildcard matching. PROTOCOLS This functionality affects ftp only EXAMPLE extern int string_match(const char *s1, const char *s2); struct local_stuff { void *custom; }; static int my_fnmatch(void *clientp, const char *pattern, const char *string) { struct local_stuff *data = clientp; printf("my pointer: %p\n", data->custom); if(string_match(pattern, string)) return CURL_FNMATCHFUNC_MATCH; else return CURL_FNMATCHFUNC_NOMATCH; } int main(void) { struct local_stuff local_data; CURL *curl = curl_easy_init(); if(curl) { curl_easy_setopt(curl, CURLOPT_URL, "ftp://ftp.example.com/file*"); curl_easy_setopt(curl, CURLOPT_WILDCARDMATCH, 1L); curl_easy_setopt(curl, CURLOPT_FNMATCH_FUNCTION, my_fnmatch); curl_easy_setopt(curl, CURLOPT_FNMATCH_DATA, &local_data); curl_easy_perform(curl); } } AVAILABILITY Added in curl 7.21.0 RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. SEE ALSO CURLOPT_DEBUGFUNCTION(3), CURLOPT_FNMATCH_DATA(3), CURLOPT_WILDCARDMATCH(3) libcurl 2024-11-07 CURLOPT_FNMATCH_FUNCTION(3)