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                 : #include "config.h"
      47                 : 
      48                 : #include "pcre_internal.h"
      49                 : 
      50                 : 
      51                 : /*************************************************
      52                 : * (Obsolete) Return info about compiled pattern  *
      53                 : *************************************************/
      54                 : 
      55                 : /* This is the original "info" function. It picks potentially useful data out
      56                 : of the private structure, but its interface was too rigid. It remains for
      57                 : backwards compatibility. The public options are passed back in an int - though
      58                 : the re->options field has been expanded to a long int, all the public options
      59                 : at the low end of it, and so even on 16-bit systems this will still be OK.
      60                 : Therefore, I haven't changed the API for pcre_info().
      61                 : 
      62                 : Arguments:
      63                 :   argument_re   points to compiled code
      64                 :   optptr        where to pass back the options
      65                 :   first_byte    where to pass back the first character,
      66                 :                 or -1 if multiline and all branches start ^,
      67                 :                 or -2 otherwise
      68                 : 
      69                 : Returns:        number of capturing subpatterns
      70                 :                 or negative values on error
      71                 : */
      72                 : 
      73                 : PCRE_EXP_DEFN int PCRE_CALL_CONVENTION
      74                 : pcre_info(const pcre *argument_re, int *optptr, int *first_byte)
      75         1274234 : {
      76                 : real_pcre internal_re;
      77         1274234 : const real_pcre *re = (const real_pcre *)argument_re;
      78         1274234 : if (re == NULL) return PCRE_ERROR_NULL;
      79         1274234 : if (re->magic_number != MAGIC_NUMBER)
      80                 :   {
      81               0 :   re = _pcre_try_flipped(re, &internal_re, NULL, NULL);
      82               0 :   if (re == NULL) return PCRE_ERROR_BADMAGIC;
      83                 :   }
      84         1274234 : if (optptr != NULL) *optptr = (int)(re->options & PUBLIC_COMPILE_OPTIONS);
      85         1274234 : if (first_byte != NULL)
      86               0 :   *first_byte = ((re->flags & PCRE_FIRSTSET) != 0)? re->first_byte :
      87                 :      ((re->flags & PCRE_STARTLINE) != 0)? -1 : -2;
      88         1274234 : return re->top_bracket;
      89                 : }
      90                 : 
      91                 : /* End of pcre_info.c */