Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pcre_study(3) [linux man page]

PCRE_STUDY(3)						     Library Functions Manual						     PCRE_STUDY(3)

NAME
PCRE - Perl-compatible regular expressions SYNOPSIS
#include <pcre.h> pcre_extra *pcre_study(const pcre *code, int options, const char **errptr); DESCRIPTION
This function studies a compiled pattern, to see if additional information can be extracted that might speed up matching. Its arguments are: code A compiled regular expression options Options for pcre_study() errptr Where to put an error message If the function succeeds, it returns a value that can be passed to pcre_exec() via its extra argument. If the function returns NULL, either it could not find any additional information, or there was an error. You can tell the difference by looking at the error value. It is NULL in first case. There are currently no options defined; the value of the second argument should always be zero. There is a complete description of the PCRE native API in the pcreapi page and a description of the POSIX API in the pcreposix page. PCRE_STUDY(3)

Check Out this Related Man Page

PCRE_FULLINFO(3)					     Library Functions Manual						  PCRE_FULLINFO(3)

NAME
PCRE - Perl-compatible regular expressions SYNOPSIS
#include <pcre.h> int pcre_fullinfo(const pcre *code, const pcre_extra *extra, int what, void *where); DESCRIPTION
This function returns information about a compiled pattern. Its arguments are: code Compiled regular expression extra Result of pcre_study() or NULL what What information is required where Where to put the information The following information is available: PCRE_INFO_BACKREFMAX Number of highest back reference PCRE_INFO_CAPTURECOUNT Number of capturing subpatterns PCRE_INFO_DEFAULT_TABLES Pointer to default tables PCRE_INFO_FIRSTBYTE Fixed first byte for a match, or -1 for start of string or after newline, or -2 otherwise PCRE_INFO_FIRSTTABLE Table of first bytes (after studying) PCRE_INFO_JCHANGED Return 1 if (?J) or (?-J) was used PCRE_INFO_LASTLITERAL Literal last byte required PCRE_INFO_NAMECOUNT Number of named subpatterns PCRE_INFO_NAMEENTRYSIZE Size of name table entry PCRE_INFO_NAMETABLE Pointer to name table PCRE_INFO_OKPARTIAL Return 1 if partial matching can be tried PCRE_INFO_OPTIONS Option bits used for compilation PCRE_INFO_SIZE Size of compiled pattern PCRE_INFO_STUDYSIZE Size of study data The yield of the function is zero on success or: PCRE_ERROR_NULL the argument code was NULL the argument where was NULL PCRE_ERROR_BADMAGIC the "magic number" was not found PCRE_ERROR_BADOPTION the value of what was invalid There is a complete description of the PCRE native API in the pcreapi page and a description of the POSIX API in the pcreposix page. PCRE_FULLINFO(3)
Man Page