.\" generated by cd2nroff 0.1 from CURLOPT_FNMATCH_FUNCTION.md .TH CURLOPT_FNMATCH_FUNCTION 3 "2024-11-07" libcurl .SH NAME CURLOPT_FNMATCH_FUNCTION \- wildcard match callback .SH SYNOPSIS .nf #include int fnmatch_callback(void *ptr, const char *pattern, const char *string); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FNMATCH_FUNCTION, fnmatch_callback); .fi .SH DESCRIPTION Pass a pointer to your callback function, which should match the prototype shown above. This callback is used for wildcard matching. Return \fICURL_FNMATCHFUNC_MATCH\fP if pattern matches the string, \fICURL_FNMATCHFUNC_NOMATCH\fP if not or \fICURL_FNMATCHFUNC_FAIL\fP if an error occurred. .SH DEFAULT NULL == an internal function for wildcard matching. .SH PROTOCOLS This functionality affects ftp only .SH EXAMPLE .nf 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); } } .fi .SH AVAILABILITY Added in curl 7.21.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO .BR CURLOPT_DEBUGFUNCTION (3), .BR CURLOPT_FNMATCH_DATA (3), .BR CURLOPT_WILDCARDMATCH (3)