code/trunk/pcre_fullinfo.c

/*************************************************
*      Perl-Compatible Regular Expressions       *
*************************************************/

/* PCRE is a library of functions to support regular expressions whose syntax
and semantics are as close as possible to those of the Perl 5 language.

                       Written by Philip Hazel
           Copyright (c) 1997-2012 University of Cambridge

-----------------------------------------------------------------------------
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

    * Redistributions of source code must retain the above copyright notice,
      this list of conditions and the following disclaimer.

    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.

    * Neither the name of the University of Cambridge nor the names of its
      contributors may be used to endorse or promote products derived from
      this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
-----------------------------------------------------------------------------
*/


/* This module contains the external function pcre_fullinfo(), which returns
information about a compiled pattern. */


#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include "pcre_internal.h"


/*************************************************
*        Return info about compiled pattern      *
*************************************************/

/* This is a newer "info" function which has an extensible interface so
that additional items can be added compatibly.

Arguments:
  argument_re      points to compiled code
  extra_data       points extra data, or NULL
  what             what information is required
  where            where to put the information

Returns:           0 if data returned, negative on error
*/

#ifdef COMPILE_PCRE8
PCRE_EXP_DEFN int PCRE_CALL_CONVENTION
pcre_fullinfo(const pcre *argument_re, const pcre_extra *extra_data,
  int what, void *where)
#else
PCRE_EXP_DEFN int PCRE_CALL_CONVENTION
pcre16_fullinfo(const pcre16 *argument_re, const pcre16_extra *extra_data,
  int what, void *where)
#endif
{
const REAL_PCRE *re = (const REAL_PCRE *)argument_re;
const pcre_study_data *study = NULL;

if (re == NULL || where == NULL) return PCRE_ERROR_NULL;

if (extra_data != NULL && (extra_data->flags & PCRE_EXTRA_STUDY_DATA) != 0)
  study = (const pcre_study_data *)extra_data->study_data;

/* Check that the first field in the block is the magic number. If it is not,
return with PCRE_ERROR_BADMAGIC. However, if the magic number is equal to
REVERSED_MAGIC_NUMBER we return with PCRE_ERROR_BADENDIANNESS, which
means that the pattern is likely compiled with different endianness. */

if (re->magic_number != MAGIC_NUMBER)
  return re->magic_number == REVERSED_MAGIC_NUMBER?
    PCRE_ERROR_BADENDIANNESS:PCRE_ERROR_BADMAGIC;

/* Check that this pattern was compiled in the correct bit mode */

if ((re->flags & PCRE_MODE) == 0) return PCRE_ERROR_BADMODE;

switch (what)
  {
  case PCRE_INFO_OPTIONS:
  *((unsigned long int *)where) = re->options & PUBLIC_COMPILE_OPTIONS;
  break;

  case PCRE_INFO_SIZE:
  *((size_t *)where) = re->size;
  break;

  case PCRE_INFO_STUDYSIZE:
  *((size_t *)where) = (study == NULL)? 0 : study->size;
  break;

  case PCRE_INFO_JITSIZE:
#ifdef SUPPORT_JIT
  *((size_t *)where) =
      (extra_data != NULL &&
      (extra_data->flags & PCRE_EXTRA_EXECUTABLE_JIT) != 0 &&
      extra_data->executable_jit != NULL)?
    PRIV(jit_get_size)(extra_data->executable_jit) : 0;
#else
  *((size_t *)where) = 0;
#endif
  break;

  case PCRE_INFO_CAPTURECOUNT:
  *((int *)where) = re->top_bracket;
  break;

  case PCRE_INFO_BACKREFMAX:
  *((int *)where) = re->top_backref;
  break;

  case PCRE_INFO_FIRSTBYTE:
  *((int *)where) =
    ((re->flags & PCRE_FIRSTSET) != 0)? re->first_char :
    ((re->flags & PCRE_STARTLINE) != 0)? -1 : -2;
  break;

  /* Make sure we pass back the pointer to the bit vector in the external
  block, not the internal copy (with flipped integer fields). */

  case PCRE_INFO_FIRSTTABLE:
  *((const pcre_uint8 **)where) =
    (study != NULL && (study->flags & PCRE_STUDY_MAPPED) != 0)?
      ((const pcre_study_data *)extra_data->study_data)->start_bits : NULL;
  break;

  case PCRE_INFO_MINLENGTH:
  *((int *)where) =
    (study != NULL && (study->flags & PCRE_STUDY_MINLEN) != 0)?
      (int)(study->minlength) : -1;
  break;

  case PCRE_INFO_JIT:
  *((int *)where) = extra_data != NULL &&
                    (extra_data->flags & PCRE_EXTRA_EXECUTABLE_JIT) != 0 &&
                    extra_data->executable_jit != NULL;
  break;

  case PCRE_INFO_LASTLITERAL:
  *((int *)where) =
    ((re->flags & PCRE_REQCHSET) != 0)? re->req_char : -1;
  break;

  case PCRE_INFO_NAMEENTRYSIZE:
  *((int *)where) = re->name_entry_size;
  break;

  case PCRE_INFO_NAMECOUNT:
  *((int *)where) = re->name_count;
  break;

  case PCRE_INFO_NAMETABLE:
  *((const pcre_uchar **)where) = (const pcre_uchar *)re + re->name_table_offset;
  break;

  case PCRE_INFO_DEFAULT_TABLES:
  *((const pcre_uint8 **)where) = (const pcre_uint8 *)(PRIV(default_tables));
  break;

  /* From release 8.00 this will always return TRUE because NOPARTIAL is
  no longer ever set (the restrictions have been removed). */

  case PCRE_INFO_OKPARTIAL:
  *((int *)where) = (re->flags & PCRE_NOPARTIAL) == 0;
  break;

  case PCRE_INFO_JCHANGED:
  *((int *)where) = (re->flags & PCRE_JCHANGED) != 0;
  break;

  case PCRE_INFO_HASCRORLF:
  *((int *)where) = (re->flags & PCRE_HASCRORLF) != 0;
  break;

  case PCRE_INFO_MAXLOOKBEHIND:
  *((int *)where) = re->max_lookbehind;
  break;

  default: return PCRE_ERROR_BADOPTION;
  }

return 0;
}

/* End of pcre_fullinfo.c */
1	nigel	77	/*************************************************
2			* Perl-Compatible Regular Expressions *
3			*************************************************/
4
5	ph10	305	/* PCRE is a library of functions to support regular expressions whose syntax
6	nigel	77	and semantics are as close as possible to those of the Perl 5 language.
7
8			Written by Philip Hazel
9	ph10	836	Copyright (c) 1997-2012 University of Cambridge
10	nigel	77
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_fullinfo(), which returns
42			information about a compiled pattern. */
43
44
45	ph10	200	#ifdef HAVE_CONFIG_H
46	ph10	236	#include "config.h"
47	ph10	200	#endif
48	ph10	199
49	nigel	77	#include "pcre_internal.h"
50
51
52			/*************************************************
53			* Return info about compiled pattern *
54			*************************************************/
55
56			/* This is a newer "info" function which has an extensible interface so
57			that additional items can be added compatibly.
58
59			Arguments:
60			argument_re points to compiled code
61			extra_data points extra data, or NULL
62			what what information is required
63			where where to put the information
64
65			Returns: 0 if data returned, negative on error
66			*/
67
68	ph10	836	#ifdef COMPILE_PCRE8
69	ph10	359	PCRE_EXP_DEFN int PCRE_CALL_CONVENTION
70	zherczeg	852	pcre_fullinfo(const pcre argument_re, const pcre_extra extra_data,
71			int what, void *where)
72	ph10	836	#else
73			PCRE_EXP_DEFN int PCRE_CALL_CONVENTION
74	zherczeg	852	pcre16_fullinfo(const pcre16 argument_re, const pcre16_extra extra_data,
75			int what, void *where)
76	ph10	836	#endif
77	nigel	77	{
78	zherczeg	852	const REAL_PCRE re = (const REAL_PCRE )argument_re;
79	nigel	77	const pcre_study_data *study = NULL;
80
81			if (re == NULL \|\| where == NULL) return PCRE_ERROR_NULL;
82
83			if (extra_data != NULL && (extra_data->flags & PCRE_EXTRA_STUDY_DATA) != 0)
84			study = (const pcre_study_data *)extra_data->study_data;
85
86	ph10	836	/* Check that the first field in the block is the magic number. If it is not,
87			return with PCRE_ERROR_BADMAGIC. However, if the magic number is equal to
88			REVERSED_MAGIC_NUMBER we return with PCRE_ERROR_BADENDIANNESS, which
89			means that the pattern is likely compiled with different endianness. */
90
91	nigel	77	if (re->magic_number != MAGIC_NUMBER)
92	ph10	836	return re->magic_number == REVERSED_MAGIC_NUMBER?
93			PCRE_ERROR_BADENDIANNESS:PCRE_ERROR_BADMAGIC;
94	ph10	842
95	ph10	836	/* Check that this pattern was compiled in the correct bit mode */
96	ph10	842
97	ph10	836	if ((re->flags & PCRE_MODE) == 0) return PCRE_ERROR_BADMODE;
98	nigel	77
99			switch (what)
100			{
101			case PCRE_INFO_OPTIONS:
102	ph10	389	((unsigned long int )where) = re->options & PUBLIC_COMPILE_OPTIONS;
103	nigel	77	break;
104
105			case PCRE_INFO_SIZE:
106			((size_t )where) = re->size;
107			break;
108
109			case PCRE_INFO_STUDYSIZE:
110			((size_t )where) = (study == NULL)? 0 : study->size;
111			break;
112	ph10	788
113	ph10	836	case PCRE_INFO_JITSIZE:
114			#ifdef SUPPORT_JIT
115			((size_t )where) =
116			(extra_data != NULL &&
117			(extra_data->flags & PCRE_EXTRA_EXECUTABLE_JIT) != 0 &&
118			extra_data->executable_jit != NULL)?
119			PRIV(jit_get_size)(extra_data->executable_jit) : 0;
120			#else
121			((size_t )where) = 0;
122			#endif
123			break;
124
125	nigel	77	case PCRE_INFO_CAPTURECOUNT:
126			((int )where) = re->top_bracket;
127			break;
128
129			case PCRE_INFO_BACKREFMAX:
130			((int )where) = re->top_backref;
131			break;
132
133			case PCRE_INFO_FIRSTBYTE:
134			((int )where) =
135	ph10	836	((re->flags & PCRE_FIRSTSET) != 0)? re->first_char :
136	ph10	230	((re->flags & PCRE_STARTLINE) != 0)? -1 : -2;
137	nigel	77	break;
138
139			/* Make sure we pass back the pointer to the bit vector in the external
140			block, not the internal copy (with flipped integer fields). */
141
142			case PCRE_INFO_FIRSTTABLE:
143	ph10	836	((const pcre_uint8 *)where) =
144	ph10	455	(study != NULL && (study->flags & PCRE_STUDY_MAPPED) != 0)?
145	nigel	77	((const pcre_study_data *)extra_data->study_data)->start_bits : NULL;
146			break;
147	ph10	461
148	ph10	455	case PCRE_INFO_MINLENGTH:
149			((int )where) =
150			(study != NULL && (study->flags & PCRE_STUDY_MINLEN) != 0)?
151	ph10	904	(int)(study->minlength) : -1;
152	ph10	461	break;
153	nigel	77
154	ph10	666	case PCRE_INFO_JIT:
155	ph10	691	((int )where) = extra_data != NULL &&
156	ph10	666	(extra_data->flags & PCRE_EXTRA_EXECUTABLE_JIT) != 0 &&
157			extra_data->executable_jit != NULL;
158			break;
159
160	nigel	77	case PCRE_INFO_LASTLITERAL:
161			((int )where) =
162	ph10	836	((re->flags & PCRE_REQCHSET) != 0)? re->req_char : -1;
163	nigel	77	break;
164
165			case PCRE_INFO_NAMEENTRYSIZE:
166			((int )where) = re->name_entry_size;
167			break;
168
169			case PCRE_INFO_NAMECOUNT:
170			((int )where) = re->name_count;
171			break;
172
173			case PCRE_INFO_NAMETABLE:
174	ph10	836	((const pcre_uchar )where) = (const pcre_uchar )re + re->name_table_offset;
175	nigel	77	break;
176
177			case PCRE_INFO_DEFAULT_TABLES:
178	ph10	836	((const pcre_uint8 )where) = (const pcre_uint8 )(PRIV(default_tables));
179	nigel	77	break;
180	ph10	172
181	ph10	426	/* From release 8.00 this will always return TRUE because NOPARTIAL is
182			no longer ever set (the restrictions have been removed). */
183	ph10	461
184	ph10	169	case PCRE_INFO_OKPARTIAL:
185	ph10	230	((int )where) = (re->flags & PCRE_NOPARTIAL) == 0;
186	ph10	169	break;
187	ph10	172
188	ph10	169	case PCRE_INFO_JCHANGED:
189	ph10	230	((int )where) = (re->flags & PCRE_JCHANGED) != 0;
190	ph10	172	break;
191	nigel	77
192	ph10	226	case PCRE_INFO_HASCRORLF:
193	ph10	230	((int )where) = (re->flags & PCRE_HASCRORLF) != 0;
194	ph10	226	break;
195	ph10	975
196			case PCRE_INFO_MAXLOOKBEHIND:
197	ph10	932	((int )where) = re->max_lookbehind;
198	ph10	975	break;
199	ph10	226
200	nigel	77	default: return PCRE_ERROR_BADOPTION;
201			}
202
203			return 0;
204			}
205
206			/* End of pcre_fullinfo.c */
Name	Value
svn:eol-style	native
svn:keywords	"Author Date Id Revision Url"