/[pcre]/code/trunk/doc/pcre_get_named_substring.3
ViewVC logotype

Contents of /code/trunk/doc/pcre_get_named_substring.3

Parent Directory Parent Directory | Revision Log Revision Log


Revision 99 - (hide annotations) (download)
Tue Mar 6 12:27:42 2007 UTC (7 years, 5 months ago) by ph10
File size: 1371 byte(s)
1. Move the comment about version numbers from pcre.h.in to configure.ac 
because that's where they are now set.
2. Update all the man pages to remove the use of .br and .in because this
causes trouble for some HTML converters. Also standardised the final sections 
giving author information and revision date.
3. Update the maintain/132html man page converter to handle .nf/.fi and to barf 
at .br/.in.

1 nigel 79 .TH PCRE_GET_NAMED_SUBSTRING 3
2 nigel 63 .SH NAME
3     PCRE - Perl-compatible regular expressions
4     .SH SYNOPSIS
5     .rs
6     .sp
7     .B #include <pcre.h>
8     .PP
9     .SM
10 nigel 75 .B int pcre_get_named_substring(const pcre *\fIcode\fP,
11 nigel 63 .ti +5n
12 nigel 75 .B const char *\fIsubject\fP, int *\fIovector\fP,
13 nigel 63 .ti +5n
14 nigel 75 .B int \fIstringcount\fP, const char *\fIstringname\fP,
15 nigel 63 .ti +5n
16 nigel 75 .B const char **\fIstringptr\fP);
17     .
18 nigel 63 .SH DESCRIPTION
19     .rs
20     .sp
21     This is a convenience function for extracting a captured substring by name. The
22     arguments are:
23 nigel 75 .sp
24     \fIcode\fP Compiled pattern
25     \fIsubject\fP Subject that has been successfully matched
26     \fIovector\fP Offset vector that \fBpcre_exec()\fP used
27     \fIstringcount\fP Value returned by \fBpcre_exec()\fP
28     \fIstringname\fP Name of the required substring
29     \fIstringptr\fP Where to put the string pointer
30     .sp
31     The memory in which the substring is placed is obtained by calling
32 nigel 93 \fBpcre_malloc()\fP. The convenience function \fBpcre_free_substring()\fP can
33     be used to free it when it is no longer needed. The yield of the function is
34     the length of the extracted substring, PCRE_ERROR_NOMEMORY if sufficient memory
35     could not be obtained, or PCRE_ERROR_NOSUBSTRING if the string name is invalid.
36 nigel 75 .P
37     There is a complete description of the PCRE native API in the
38 nigel 63 .\" HREF
39 nigel 75 \fBpcreapi\fP
40 nigel 63 .\"
41 nigel 75 page and a description of the POSIX API in the
42     .\" HREF
43     \fBpcreposix\fP
44     .\"
45 nigel 63 page.

Properties

Name Value
svn:eol-style native
svn:keywords "Author Date Id Revision Url"

webmaster@exim.org
ViewVC Help
Powered by ViewVC 1.1.12