rubbos/app/httpd-2.0.64/srclib/apr/include/apr_fnmatch.h

   1 /*
   2  * Copyright (c) 1992, 1993
   3  *      The Regents of the University of California.  All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  * 3. All advertising materials mentioning features or use of this software
  14  *    must display the following acknowledgement:
  15  *      This product includes software developed by the University of
  16  *      California, Berkeley and its contributors.
  17  * 4. Neither the name of the University nor the names of its contributors
  18  *    may be used to endorse or promote products derived from this software
  19  *    without specific prior written permission.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31  * SUCH DAMAGE.
  32  *
  33  *      @(#)fnmatch.h   8.1 (Berkeley) 6/2/93
  34  */
  35
  36 /* This file has been modified by the Apache Software Foundation. */
  37 #ifndef _APR_FNMATCH_H_
  38 #define _APR_FNMATCH_H_
  39
  40 /**
  41  * @file apr_fnmatch.h
  42  * @brief APR FNMatch Functions
  43  */
  44
  45 #include "apr_errno.h"
  46
  47 #ifdef __cplusplus
  48 extern "C" {
  49 #endif
  50
  51 /**
  52  * @defgroup apr_fnmatch Filename Matching Functions
  53  * @ingroup APR
  54  * @{
  55  */
  56
  57 #define APR_FNM_NOMATCH     1     /**< Match failed. */
  58
  59 #define APR_FNM_NOESCAPE    0x01  /**< Disable backslash escaping. */
  60 #define APR_FNM_PATHNAME    0x02  /**< Slash must be matched by slash. */
  61 #define APR_FNM_PERIOD      0x04  /**< Period must be matched by period. */
  62 #define APR_FNM_CASE_BLIND  0x08  /**< Compare characters case-insensitively.
  63                                    * @remark This flag is an Apache addition
  64                                    */
  65
  66 #define FNM_NOMATCH    APR_FNM_NOMATCH    /**< @deprecated @see APR_FNM_NOMATCH */
  67 #define FNM_NOESCAPE   APR_FNM_NOESCAPE   /**< @deprecated @see APR_FNM_NOESCAPE */
  68 #define FNM_PATHNAME   APR_FNM_PATHNAME   /**< @deprecated @see APR_FNM_PATHNAME */
  69 #define FNM_PERIOD     APR_FNM_PERIOD     /**< @deprecated @see APR_FNM_PERIOD */
  70 #define FNM_CASE_BLIND APR_FNM_CASE_BLIND /**< @deprecated @see APR_FNM_CASE_BLIND */
  71
  72 /**
  73  * Try to match the string to the given pattern, return APR_SUCCESS if
  74  *    match, else return APR_FNM_NOMATCH.
  75  * @param pattern The pattern to match to
  76  * @param strings The string we are trying to match
  77  * @param flags flags to use in the match.  Bitwise OR of:
  78  * <PRE>
  79  *              APR_FNM_NOESCAPE       Disable backslash escaping
  80  *              APR_FNM_PATHNAME       Slash must be matched by slash
  81  *              APR_FNM_PERIOD         Period must be matched by period
  82  *              APR_FNM_CASE_BLIND     Compare characters case-insensitively.
  83  * </PRE>
  84  */
  85
  86 APR_DECLARE(apr_status_t) apr_fnmatch(const char *pattern,
  87                                       const char *strings, int flags);
  88
  89 /**
  90  * Determine if the given pattern is a regular expression.
  91  * @param pattern The pattern to search for glob characters.
  92  * @return non-zero if pattern has any glob characters in it
  93  */
  94 APR_DECLARE(int) apr_fnmatch_test(const char *pattern);
  95
  96 /** @deprecated @see apr_fnmatch_test */
  97 APR_DECLARE(int) apr_is_fnmatch(const char *pattern);
  98
  99 /** @} */
 100
 101 #ifdef __cplusplus
 102 }
 103 #endif
 104
 105 #endif /* !_APR_FNMATCH_H_ */