pcre_study.c


Function pcre_study

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
);

TypeNameRead/WriteDescription
const pcre*external_reInputpoints to the compiled expression
intoptionsInputcontains option bits
const char**errorptrOutputpoints to where to place error messages; set NULL unless error
pcre_extra* RETURNpointer 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