Man page - pcre_get_named_substring(3)
Packages contains this manual
- pcre32_exec(3)
- pcre32_config(3)
- pcre16_get_substring(3)
- pcrejit(3)
- pcre32_pattern_to_host_byte_order(3)
- pcre_utf16_to_host_byte_order(3)
- pcre16_maketables(3)
- pcrematching(3)
- pcre32_jit_stack_free(3)
- pcre16_exec(3)
- pcre16_free_study(3)
- pcre_get_named_substring(3)
- pcrebuild(3)
- pcre_fullinfo(3)
- pcre32_compile2(3)
- pcre-config(1)
- pcreprecompile(3)
- pcre_compile(3)
- pcreposix(3)
- pcre32_dfa_exec(3)
- pcreperform(3)
- pcre_maketables(3)
- pcre32_free_substring(3)
- pcre32_compile(3)
- pcre32_study(3)
- pcre_free_study(3)
- pcre_jit_stack_free(3)
- pcre_config(3)
- pcre16_compile(3)
- pcre_get_substring_list(3)
- pcre(3)
- pcreunicode(3)
- pcrestack(3)
- pcre_get_substring(3)
- pcreapi(3)
- pcre_free_substring(3)
- pcre16_fullinfo(3)
- pcrelimits(3)
- pcre16_assign_jit_stack(3)
- pcre32_copy_named_substring(3)
- pcre_assign_jit_stack(3)
- pcre32_jit_stack_alloc(3)
- pcre16_compile2(3)
- pcre32_free_study(3)
- pcre16_copy_substring(3)
- pcre_refcount(3)
- pcre32_version(3)
- pcre_pattern_to_host_byte_order(3)
- pcre16_copy_named_substring(3)
- pcre16_get_named_substring(3)
- pcre_utf32_to_host_byte_order(3)
- pcre16_study(3)
- pcresample(3)
- pcrecallout(3)
- pcre_copy_named_substring(3)
- pcre32_jit_exec(3)
- pcre16_jit_exec(3)
- pcre_version(3)
- pcre16_get_stringnumber(3)
- pcre_get_stringnumber(3)
- pcre32_free_substring_list(3)
- pcrepartial(3)
- pcre32_copy_substring(3)
- pcredemo(3)
- pcre16_jit_stack_alloc(3)
- pcre_jit_stack_alloc(3)
- pcre16_refcount(3)
- pcre_jit_exec(3)
- pcresyntax(3)
- pcre16_dfa_exec(3)
- pcre32_maketables(3)
- pcre16_get_substring_list(3)
- pcre32_get_stringnumber(3)
- pcre32_get_stringtable_entries(3)
- pcre32(3)
- pcre16(3)
- pcre16_free_substring_list(3)
- pcre16_version(3)
- pcre16_jit_stack_free(3)
- pcre16_pattern_to_host_byte_order(3)
- pcre32_refcount(3)
- pcre16_get_stringtable_entries(3)
- pcre_compile2(3)
- pcrecompat(3)
- pcre_dfa_exec(3)
- pcre32_fullinfo(3)
- pcrecpp(3)
- pcre_exec(3)
- pcre32_get_substring(3)
- pcre32_assign_jit_stack(3)
- pcre32_get_substring_list(3)
- pcre_get_stringtable_entries(3)
- pcre32_utf32_to_host_byte_order(3)
- pcre_free_substring_list(3)
- pcre16_utf16_to_host_byte_order(3)
- pcre16_config(3)
- pcre16_free_substring(3)
- pcre_study(3)
- pcre32_get_named_substring(3)
- pcre_copy_substring(3)
apt-get install libpcre3-dev
Manual
PCRE_GET_NAMED_SUBSTRING
NAMESYNOPSIS
DESCRIPTION
NAME
PCRE - Perl-compatible regular expressions
SYNOPSIS
#include <pcre.h>
int
pcre_get_named_substring(const pcre *
code
,
const char *
subject
, int
*
ovector
,
int
stringcount
, const char
*
stringname
,
const char **
stringptr
);
int
pcre16_get_named_substring(const pcre16 *
code
,
PCRE_SPTR16
subject
, int
*
ovector
,
int
stringcount
, PCRE_SPTR16
stringname
,
PCRE_SPTR16 *
stringptr
);
int
pcre32_get_named_substring(const pcre32 *
code
,
PCRE_SPTR32
subject
, int
*
ovector
,
int
stringcount
, PCRE_SPTR32
stringname
,
PCRE_SPTR32 *
stringptr
);
DESCRIPTION
This is a convenience function for extracting a captured substring by name. The arguments are:
code
Compiled pattern
subject
Subject that has been successfully matched
ovector
Offset vector that
pcre[16|32]_exec()
used
stringcount
Value returned by
pcre[16|32]_exec()
stringname
Name of the required substring
stringptr
Where to put the string pointer
The memory in which the substring is placed is obtained by calling pcre[16|32]_malloc() . The convenience function pcre[16|32]_free_substring() can be used to free it when it is no longer needed. The yield of the function is the length of the extracted substring, PCRE_ERROR_NOMEMORY if sufficient memory could not be obtained, or PCRE_ERROR_NOSUBSTRING if the string name is 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.