Return to fnmatch.3 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / gen

Annotation of 43BSDReno/lib/libc/gen/fnmatch.3, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1989 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" This code is derived from software contributed to Berkeley by
                      5: .\" Guido van Rossum.
                      6: .\"
                      7: .\" Redistribution and use in source and binary forms are permitted provided
                      8: .\" that: (1) source distributions retain this entire copyright notice and
                      9: .\" comment, and (2) distributions including binaries display the following
                     10: .\" acknowledgement:  ``This product includes software developed by the
                     11: .\" University of California, Berkeley and its contributors'' in the
                     12: .\" documentation or other materials provided with the distribution and in
                     13: .\" all advertising materials mentioning features or use of this software.
                     14: .\" Neither the name of the University nor the names of its contributors may
                     15: .\" be used to endorse or promote products derived from this software without
                     16: .\" specific prior written permission.
                     17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     18: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     19: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     20: .\"
                     21: .\"    @(#)fnmatch.3   5.2 (Berkeley) 6/23/90
                     22: .\"
                     23: .TH FNMATCH 3 "June 23, 1990"
                     24: .UC 7
                     25: .SH NAME
                     26: fnmatch \- match filename or pathname
                     27: .SH SYNOPSIS
                     28: .nf
                     29: #include <unistd.h>
                     30: 
                     31: int fnmatch(const char *pattern, const char *string, int flags);
                     32: .fi
                     33: .SH DESCRIPTION
                     34: .I Fnmatch
                     35: matches patterns according to the rules used by the shell.
                     36: It checks the string specified by the
                     37: .I string
                     38: argument to see if it matches the pattern specified by the
                     39: .I pattern
                     40: argument.
                     41: .PP
                     42: The
                     43: .I flags
                     44: argument modifies the interpretation of
                     45: .I pattern
                     46: and
                     47: .I string.
                     48: The value of
                     49: .I flags
                     50: is the bitwise inclusive OR of any of the following
                     51: constants, which are defined in the include file
                     52: .IR unistd.h .
                     53: .TP
                     54: FNM_PATHNAME
                     55: Slash characters in
                     56: .I string
                     57: must be explicitly matched by slashes in
                     58: .IR pattern .
                     59: If this flag is not set, then slashes are treated as regular characters.
                     60: .TP
                     61: FNM_QUOTE
                     62: Every occurrence of a backslash (``\e'') followed by a character in
                     63: .I pattern
                     64: is replaced by that character.
                     65: This is done to negate any special meaning for the character.
                     66: .SH RETURNS
                     67: If
                     68: .I string
                     69: matches the pattern specified by
                     70: .IR pattern ,
                     71: then
                     72: .I fnmatch
                     73: returns zero.
                     74: Otherwise,
                     75: .I fnmatch
                     76: returns nonzero.
                     77: .SH SEE ALSO
                     78: sh(1), glob(3), wordexp(3), regexp(3)
                     79: .SH BUGS
                     80: Quotes and slashes in range patterns are not handled correctly.
                     81: .PP
                     82: The pattern ``*'' matches the empty string, even if
                     83: .I FNM_PATHNAME
                     84: is specified.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.