home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 0 / 0998 / StringMatc.3 < prev    next >
Text File  |  1990-12-28  |  1KB  |  43 lines
  1. '\" Copyright 1989 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/lib/tcl/RCS/Tcl_StringMatch.man,v 1.1 89/05/15 16:15:36 ouster Exp $ SPRITE (Berkeley)
  10. '\" 
  11. .so \*(]ltmac.sprite
  12. .HS Tcl_StringMatch tcl
  13. .VS
  14. .BS
  15. .SH NAME
  16. Tcl_StringMatch \- test whether a string matches a pattern
  17. .SH SYNOPSIS
  18. .nf
  19. \fB#include <tcl.h>\fR
  20. .sp
  21. int
  22. \Tcl_StringMatch\fR(\fIstring\fR, \fIpattern\fR)
  23. .SH ARGUMENTS
  24. .AP char *string in
  25. String to test.
  26. .AP char *pattern in
  27. Pattern to match against string.  May contain special
  28. characters from the set *?\e[].
  29. .BE
  30.  
  31. .SH DESCRIPTION
  32. .PP
  33. This utility procedure determines whether a string matches
  34. a given pattern.  If it does, then \fBTcl_StringMatch\fR returns
  35. 1.  Otherwise \fBTcl_StringMatch\fR returns 0.  The algorithm
  36. used for matching is the same algorithm used in the ``string match''
  37. Tcl command and is similar to the algorithm used by the C-shell
  38. for file name matching;  see the Tcl manual entry for details.
  39.  
  40. .SH KEYWORDS
  41. match, pattern, string
  42. .VE
  43.