Manpages

Manpage of Tcl_StringMatch

Tcl_StringMatch

Section: Tcl Library Procedures (3)
Updated: 8.1
Index
Return to Main Contents



 

NAME

Tcl_StringMatch, Tcl_StringCaseMatch - test whether a string matches a pattern  

SYNOPSIS

#include <tcl.h>

int
Tcl_StringMatch(string, pattern)

int
Tcl_StringCaseMatch(string, pattern, nocase)
 

ARGUMENTS

char    *string    (in)
String to test.
char    *pattern    (in)
Pattern to match against string. May contain special characters from the set *?\[].
int    nocase    (in)
Specifies whether the match should be done case-sensitive (0) or case-insensitive (1).



 

DESCRIPTION

This utility procedure determines whether a string matches a given pattern. If it does, then Tcl_StringMatch returns 1. Otherwise Tcl_StringMatch 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.

In Tcl_StringCaseMatch, the algorithm is the same, but you have the option to make the matching case-insensitive. If you choose this (by passing nocase as 1), then the string and pattern are essentially matched in the lower case.

 

KEYWORDS

match, pattern, string


 

Index

NAME
SYNOPSIS
ARGUMENTS
DESCRIPTION
KEYWORDS

This document was created by man2html, using the manual pages.
Time: 12:19:04 GMT, April 19, 2024