wu_fnmatch.3
上传用户:zibowangxu
上传日期:2007-01-04
资源大小:331k
文件大小:3k
源码类别:

Ftp客户端

开发平台:

Unix_Linux

  1. ."
  2. ." Copyright (c) 1999 WU-FTPD Development Group. 
  3. ." All rights reserved.
  4. ." 
  5. ." Portions Copyright (c) 1980, 1985, 1988, 1989, 1990, 1991, 1993, 1994 
  6. ." The Regents of the University of California.  Portions Copyright (c) 
  7. ." 1993, 1994 Washington University in Saint Louis.  Portions Copyright 
  8. ." (c) 1996, 1998 Berkeley Software Design, Inc.  Portions Copyright (c) 
  9. ." 1998 Sendmail, Inc.  Portions Copyright (c) 1983, 1995, 1996, 1997 Eric 
  10. ." P. Allman.  Portions Copyright (c) 1989 Massachusetts Institute of 
  11. ." Technology.  Portions Copyright (c) 1997 Stan Barber.  Portions 
  12. ." Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997 Free Software 
  13. ." Foundation, Inc.  Portions Copyright (c) 1997 Kent Landfield. 
  14. ."
  15. ." Use and distribution of this software and its source code are governed 
  16. ." by the terms and conditions of the WU-FTPD Software License ("LICENSE"). 
  17. ."
  18. ." $Id: wu_fnmatch.3,v 1.2 1999/08/27 15:01:24 wuftpd Exp $
  19. ."
  20. .TH WU_FNMATCH 3 "July 28, 1999"
  21. .UC 7
  22. .SH NAME
  23. wu_fnmatch - match filename or pathname
  24. .SH SYNOPSIS
  25. .nf
  26. #include "wu_fnmatch.h"
  27. int wu_fnmatch(const char *pattern, const char *string, int flags);
  28. .fi
  29. .SH DESCRIPTION
  30. .I wu_fnmatch
  31. matches patterns according to the rules used by the shell.
  32. It checks the string specified by the
  33. .I string
  34. argument to see if it matches the pattern specified by the
  35. .I pattern
  36. argument.
  37. .PP
  38. The
  39. .I flags
  40. argument modifies the interpretation of
  41. .I pattern
  42. and
  43. .I string.
  44. The value of
  45. .I flags
  46. is the bitwise inclusive OR of any of the following
  47. constants, which are defined in the include file
  48. .IR wu_fnmatch.h .
  49. .TP
  50. FNM_PATHNAME
  51. Slash characters in
  52. .I string
  53. must be explicitly matched by slashes in
  54. .IR pattern .
  55. If this flag is not set, then slashes are treated as regular characters.
  56. .TP
  57. FNM_NOESCAPE
  58. Every occurrence of a backslash (``e'') followed by a character in
  59. .I pattern
  60. is replaced by that character.
  61. This is done to negate any special meaning for the character.
  62. If this flag is set, then backslashes are treated as regular characters.
  63. .TP
  64. FNM_PERIOD
  65. If this flag is set, then a leading period in
  66. .I string
  67. must be explicity matched by a period in
  68. .IR pattern .
  69. A period is considered leading if it is the first character in
  70. .IR string ,
  71. or if both
  72. .T FNM_PATHNAME
  73. is set and the period immediately follows a slash.
  74. .TP
  75. FNM_LEADING_DIR
  76. If this flag is set, if the entire
  77. .I pattern
  78. has been matched, and there are more characters remaining in the
  79. .IR string ,
  80. and either the last character matched was a slash, or the next character in the
  81. .I string
  82. is a slash, then consider the entire
  83. .I string
  84. matched.
  85. .TP
  86. FNM_CASEFOLD
  87. Normally, upper case and lower case letters are distinct.  This flag causes
  88. them to be considered equal.
  89. .SH RETURNS
  90. If
  91. .I string
  92. matches the pattern specified by
  93. .IR pattern ,
  94. then
  95. .I wu_fnmatch
  96. returns zero.
  97. Otherwise,
  98. .I wu_fnmatch
  99. returns FNM_NOMATCH.
  100. .SH SEE ALSO
  101. sh(1), glob(3), wordexp(3), regexp(3)
  102. .SH BUGS
  103. {} alternatives are not handled.