22

✏️ Editing: pcre2_substring_nametable_scan.html

<html>
<head>
<title>pcre2_substring_nametable_scan specification</title>
</head>
<body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
<h1>pcre2_substring_nametable_scan man page</h1>

Return to the <a href="index.html">PCRE2 index page</a>.


This page is part of the PCRE2 HTML documentation. It was generated
automatically from the original man page. If there is any nonsense in it,
please consult the man page, in case the conversion went wrong.
 
 
SYNOPSIS
 

#include &#60;pcre2.h&#62;


int pcre2_substring_nametable_scan(const pcre2_code *code,
 PCRE2_SPTR name, PCRE2_SPTR *first, PCRE2_SPTR *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.
<pre>
 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
</pre>
When the name is found in the table, if first is NULL, the function
returns a group number, but if there is more than one matching entry, it is not
defined which one. Otherwise, when both pointers have been set, the yield of
the function is the length of each entry in code units. If the name is not
found, PCRE2_ERROR_NOSUBSTRING is returned.


There is a complete description of the PCRE2 native API, including the format of
the table entries, in the
<a href="pcre2api.html">pcre2api</a>
page, and a description of the POSIX API in the
<a href="pcre2posix.html">pcre2posix</a>
page.

Return to the <a href="index.html">PCRE2 index page</a>.

MR SKB