pcre_study.c
Study a compiled expression
This function is handed a compiled expression that it must study to produce
information that will speed up the matching. It returns a pcre_extra block
which then gets handed back to pcre_exec().
Synopsis
Prototype
pcre_extra* pcre_study (
const pcre* external_re,
int options,
const char** errorptr
);
Type | Name | Read/Write | Description |
const pcre* | external_re | Input | points to the compiled expression |
int | options | Input | contains option bits |
const char** | errorptr | Output | points to where to place error messages;
set NULL unless error |
pcre_extra* | | RETURN | pointer to a pcre_extra block,
with study_data filled in and the
appropriate flag set;
NULL on error or if no optimization possible |
Input
external_re: | (Input) | points to the compiled expression |
options: | (Input) | contains option bits |
Output
errorptr: | (Output) | points to where to place error messages;
set NULL unless error |
Returns
pcre_extra*: | pointer to a pcre_extra block,
with study_data filled in and the
appropriate flag set;
NULL on error or if no optimization possible |
Description
Study a compiled expression
This function is handed a compiled expression that it must study to produce
information that will speed up the matching. It returns a pcre_extra block
which then gets handed back to pcre_exec().
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0