53 lines
1.9 KiB
Groff
53 lines
1.9 KiB
Groff
'\"
|
|
'\" Copyright (c) 1989-1993 The Regents of the University of California.
|
|
'\" All rights reserved.
|
|
'\"
|
|
'\" Permission is hereby granted, without written agreement and without
|
|
'\" license or royalty fees, to use, copy, modify, and distribute this
|
|
'\" documentation for any purpose, provided that the above copyright
|
|
'\" notice and the following two paragraphs appear in all copies.
|
|
'\"
|
|
'\" IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY
|
|
'\" FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
|
|
'\" ARISING OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF THE UNIVERSITY OF
|
|
'\" CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
'\"
|
|
'\" THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
|
|
'\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
'\" AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
|
|
'\" ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATION TO
|
|
'\" PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
|
|
'\"
|
|
'\" $Header: /user6/ouster/tcl/man/RCS/StrMatch.3,v 1.7 93/04/01 09:25:35 ouster Exp $ SPRITE (Berkeley)
|
|
'\"
|
|
.so man.macros
|
|
.HS Tcl_StringMatch tclc
|
|
.BS
|
|
.SH NAME
|
|
Tcl_StringMatch \- test whether a string matches a pattern
|
|
.SH SYNOPSIS
|
|
.nf
|
|
\fB#include <tcl.h>\fR
|
|
.sp
|
|
int
|
|
\fBTcl_StringMatch\fR(\fIstring\fR, \fIpattern\fR)
|
|
.SH ARGUMENTS
|
|
.AP char *string in
|
|
String to test.
|
|
.AP char *pattern in
|
|
Pattern to match against string. May contain special
|
|
characters from the set *?\e[].
|
|
.BE
|
|
|
|
.SH DESCRIPTION
|
|
.PP
|
|
This utility procedure determines whether a string matches
|
|
a given pattern. If it does, then \fBTcl_StringMatch\fR returns
|
|
1. Otherwise \fBTcl_StringMatch\fR returns 0. The algorithm
|
|
used for matching is the same algorithm used in the ``string match''
|
|
Tcl command and is similar to the algorithm used by the C-shell
|
|
for file name matching; see the Tcl manual entry for details.
|
|
|
|
.SH KEYWORDS
|
|
match, pattern, string
|