"Fossies" - the Fresh Open Source Software Archive

Member "pcre-8.42/doc/pcre_get_stringtable_entries.3" (31 Jan 2014, 1497 Bytes) of package /linux/misc/pcre-8.42.tar.bz2:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even errorneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field.

PCRE_GET_STRINGTABLE_ENTRIES

NAME
SYNOPSIS
DESCRIPTION

NAME

PCRE - Perl-compatible regular expressions

SYNOPSIS

#include <pcre.h>

int pcre_get_stringtable_entries(const pcre *code,
const char *
name, char **first, char **last);

int pcre16_get_stringtable_entries(const pcre16 *code,
PCRE_SPTR16
name, PCRE_UCHAR16 **first, PCRE_UCHAR16 **last);

int pcre32_get_stringtable_entries(const pcre32 *code,
PCRE_SPTR32
name, PCRE_UCHAR32 **first, PCRE_UCHAR32 **last);

DESCRIPTION

This convenience function finds, for a compiled pattern, the first and last entries for a given name in the table that translates capturing parenthesis names into numbers. When names are required to be unique (PCRE_DUPNAMES is not set), it is usually easier to use pcre[16|32]_get_stringnumber() instead.

code Compiled regular expression
name
Name whose entries required
first
Where to return a pointer to the first entry
last
Where to return a pointer to the last entry

The yield of the function is the length of each entry, or PCRE_ERROR_NOSUBSTRING if none are found.

There is a complete description of the PCRE native API, including the format of the table entries, in the pcreapi page, and a description of the POSIX API in the pcreposix page.