gmatch(3GEN)                                         String Pattern-Matching Library Functions                                        gmatch(3GEN)

NAME

       gmatch - shell global pattern matching

SYNOPSIS

       cc [ flag ... ] file ... -lgen [ library ... ]
       #include <libgen.h>

       int gmatch(const char *str, const char *pattern);

DESCRIPTION

       gmatch()  checks  whether  the  null-terminated string str matches the null-terminated pattern string pattern. See the sh(1), section  File
       Name Generation, for a discussion of pattern matching. A backslash () is used as an escape character in pattern strings.

RETURN VALUES

       gmatch() returns non-zero if the pattern matches the string, zero if the pattern does not.

EXAMPLES

       Example 1: Examples of gmatch() function.

       In the following example, gmatch() returns non-zero (true) for all strings with "a" or "-" as their last character.

              char *s;
              gmatch (s, "*[a-]" )

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |MT-Level                     |MT-Safe                      |
       +-----------------------------+-----------------------------+

SEE ALSO

       sh(1), attributes(5)

NOTES

       When compiling multithreaded applications, the _REENTRANT flag must be defined on the compile line.  This flag should only be used in  mul-
       tithreaded applications.

SunOS 5.10                                                          29 Dec 1996                                                       gmatch(3GEN)