Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_WILDCARDMATCH(3)   curl_easy_setopt options   CURLOPT_WILDCARDMATCH(3)

NAME
       CURLOPT_WILDCARDMATCH - enable 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 CUR-
       LOPT_URL(3) option, using an fnmatch-like pattern (Shell	Pattern	Match-
       ing) 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_FUNC-
       TION(3) option.

       A brief introduction of its syntax follows:

	      *	- ASTERISK
		     ftp://example.com/some/path/*.txt (for all	txt's from the
		     root directory). Only two asterisks  are  allowed	within
		     the same pattern string.

	      ?	- QUESTION MARK
		     Question mark matches any (exactly	one) character.

		     ftp://example.com/some/path/photo?.jpeg

	      [	- BRACKET EXPRESSION
		     The left bracket opens a bracket expression. The question
		     mark and asterisk have no special meaning	in  a  bracket
		     expression.  Each	bracket	 expression  ends by the right
		     bracket and matches exactly one character.	Some  examples
		     follow:

		     [a-zA-Z0-9] or [f-gF-G] - character interval

		     [abc] - character enumeration

		     [^abc] or [!abc] -	negation

		     [[:name:]]	 class	expression.  Supported classes are al-
		     num,lower,	space,	alpha,	digit,	print,	upper,	blank,
		     graph, xdigit.

		     [][-!^]  -	special	case - matches only '-', ']', '[', '!'
		     or	'^'. These characters have no special purpose.

		     [\[\]\\] -	escape syntax. Matches '[', ']'	or '\'.

		     Using the rules above, a file name	pattern	 can  be  con-
		     structed:

		     ftp://example.com/some/path/[a-z[:upper:]\\].jpeg

PROTOCOLS
       This feature is only supported for FTP download.

EXAMPLE
       See https://curl.haxx.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),

libcurl	7.72.0			 May 18, 2018	      CURLOPT_WILDCARDMATCH(3)

NAME | SYNOPSIS | DESCRIPTION | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLOPT_WILDCARDMATCH&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help