Annotation of embedaddon/pcre/pcre_info.c, revision 1.1

1.1     ! misho       1: /*************************************************
        !             2: *      Perl-Compatible Regular Expressions       *
        !             3: *************************************************/
        !             4: 
        !             5: /* PCRE is a library of functions to support regular expressions whose syntax
        !             6: and semantics are as close as possible to those of the Perl 5 language.
        !             7: 
        !             8:                        Written by Philip Hazel
        !             9:            Copyright (c) 1997-2009 University of Cambridge
        !            10: 
        !            11: -----------------------------------------------------------------------------
        !            12: Redistribution and use in source and binary forms, with or without
        !            13: modification, are permitted provided that the following conditions are met:
        !            14: 
        !            15:     * Redistributions of source code must retain the above copyright notice,
        !            16:       this list of conditions and the following disclaimer.
        !            17: 
        !            18:     * Redistributions in binary form must reproduce the above copyright
        !            19:       notice, this list of conditions and the following disclaimer in the
        !            20:       documentation and/or other materials provided with the distribution.
        !            21: 
        !            22:     * Neither the name of the University of Cambridge nor the names of its
        !            23:       contributors may be used to endorse or promote products derived from
        !            24:       this software without specific prior written permission.
        !            25: 
        !            26: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
        !            27: AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        !            28: IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        !            29: ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
        !            30: LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
        !            31: CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
        !            32: SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
        !            33: INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
        !            34: CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
        !            35: ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
        !            36: POSSIBILITY OF SUCH DAMAGE.
        !            37: -----------------------------------------------------------------------------
        !            38: */
        !            39: 
        !            40: 
        !            41: /* This module contains the external function pcre_info(), which gives some
        !            42: information about a compiled pattern. However, use of this function is now
        !            43: deprecated, as it has been superseded by pcre_fullinfo(). */
        !            44: 
        !            45: 
        !            46: #ifdef HAVE_CONFIG_H
        !            47: #include "config.h"
        !            48: #endif
        !            49: 
        !            50: #include "pcre_internal.h"
        !            51: 
        !            52: 
        !            53: /*************************************************
        !            54: * (Obsolete) Return info about compiled pattern  *
        !            55: *************************************************/
        !            56: 
        !            57: /* This is the original "info" function. It picks potentially useful data out
        !            58: of the private structure, but its interface was too rigid. It remains for
        !            59: backwards compatibility. The public options are passed back in an int - though
        !            60: the re->options field has been expanded to a long int, all the public options
        !            61: at the low end of it, and so even on 16-bit systems this will still be OK.
        !            62: Therefore, I haven't changed the API for pcre_info().
        !            63: 
        !            64: Arguments:
        !            65:   argument_re   points to compiled code
        !            66:   optptr        where to pass back the options
        !            67:   first_byte    where to pass back the first character,
        !            68:                 or -1 if multiline and all branches start ^,
        !            69:                 or -2 otherwise
        !            70: 
        !            71: Returns:        number of capturing subpatterns
        !            72:                 or negative values on error
        !            73: */
        !            74: 
        !            75: PCRE_EXP_DEFN int PCRE_CALL_CONVENTION
        !            76: pcre_info(const pcre *argument_re, int *optptr, int *first_byte)
        !            77: {
        !            78: real_pcre internal_re;
        !            79: const real_pcre *re = (const real_pcre *)argument_re;
        !            80: if (re == NULL) return PCRE_ERROR_NULL;
        !            81: if (re->magic_number != MAGIC_NUMBER)
        !            82:   {
        !            83:   re = _pcre_try_flipped(re, &internal_re, NULL, NULL);
        !            84:   if (re == NULL) return PCRE_ERROR_BADMAGIC;
        !            85:   }
        !            86: if (optptr != NULL) *optptr = (int)(re->options & PUBLIC_COMPILE_OPTIONS);
        !            87: if (first_byte != NULL)
        !            88:   *first_byte = ((re->flags & PCRE_FIRSTSET) != 0)? re->first_byte :
        !            89:      ((re->flags & PCRE_STARTLINE) != 0)? -1 : -2;
        !            90: return re->top_bracket;
        !            91: }
        !            92: 
        !            93: /* End of pcre_info.c */

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>