This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH] fnmatch.3: Describe the FNM_EXTMATCH flag and pattern syntax
- From: "Michael Kerrisk (man-pages)" <mtk dot manpages at gmail dot com>
- To: PÃdraig Brady <P at draigBrady dot com>
- Cc: mtk dot manpages at gmail dot com, linux-man at vger dot kernel dot org, libc-alpha at sourceware dot org
- Date: Sun, 27 Dec 2015 17:15:35 +0100
- Subject: Re: [PATCH] fnmatch.3: Describe the FNM_EXTMATCH flag and pattern syntax
- Authentication-results: sourceware.org; auth=none
- References: <1444899508-24394-1-git-send-email-P at draigBrady dot com>
On 10/15/2015 10:58 AM, PÃdraig Brady wrote:
> Signed-off-by: PÃdraig Brady <P@draigBrady.com>
Thanks, PÃdraig. APplied.
Cheers,
Michael
> ---
> man3/fnmatch.3 | 26 ++++++++++++++++++++++++++
> 1 file changed, 26 insertions(+)
>
> diff --git a/man3/fnmatch.3 b/man3/fnmatch.3
> index a7c55ff..3502e06 100644
> --- a/man3/fnmatch.3
> +++ b/man3/fnmatch.3
> @@ -86,6 +86,32 @@ use of glibc and is implemented only in certain cases.
> .B FNM_CASEFOLD
> If this flag (a GNU extension) is set, the pattern is matched
> case-insensitively.
> +.TP
> +.B FNM_EXTMATCH
> +If this flag (a GNU extension) is set, extended patterns are
> +supported, as introduced by \&'ksh' and now supported by other shells.
> +The extended format is as follows, with \fIpattern\-list\fR
> +being a \&'|' separated list of patterns.
> +.TP
> +\&'?(\fIpattern\-list\fR)'
> +The pattern matches if zero or one occurrences of any of the
> +patterns in the \fIpattern\-list\fR match the input \fIstring\fR.
> +.TP
> +\&'*(\fIpattern\-list\fR)'
> +The pattern matches if zero or more occurrences of any of the
> +patterns in the \fIpattern\-list\fR match the input \fIstring\fR.
> +.TP
> +\&'+(\fIpattern\-list\fR)'
> +The pattern matches if one or more occurrences of any of the
> +patterns in the \fIpattern\-list\fR match the input \fIstring\fR.
> +.TP
> +\&'@(\fIpattern\-list\fR)'
> +The pattern matches if exactly one occurrence of any of the
> +patterns in the \fIpattern\-list\fR match the input \fIstring\fR.
> +.TP
> +\&'!(\fIpattern\-list\fR)'
> +The pattern matches if the input \fIstring\fR cannot be matched with
> +any of the patterns in the \fIpattern\-list\fR.
> .SH RETURN VALUE
> Zero if
> .I string
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/