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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 93 - (hide annotations) (download)
Sat Feb 24 21:41:42 2007 UTC (7 years, 8 months ago) by nigel
File size: 1110 byte(s)
Load pcre-7.0 into code/trunk.

1 nigel 79 .TH PCRE_COPY_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     .br
11 nigel 75 .B int pcre_copy_substring(const char *\fIsubject\fP, int *\fIovector\fP,
12 nigel 63 .ti +5n
13 nigel 75 .B int \fIstringcount\fP, int \fIstringnumber\fP, char *\fIbuffer\fP,
14 nigel 63 .ti +5n
15 nigel 75 .B int \fIbuffersize\fP);
16     .
17 nigel 63 .SH DESCRIPTION
18     .rs
19     .sp
20     This is a convenience function for extracting a captured substring into a given
21     buffer. The arguments are:
22 nigel 75 .sp
23     \fIsubject\fP Subject that has been successfully matched
24     \fIovector\fP Offset vector that \fBpcre_exec()\fP used
25     \fIstringcount\fP Value returned by \fBpcre_exec()\fP
26     \fIstringnumber\fP Number of the required substring
27     \fIbuffer\fP Buffer to receive the string
28     \fIbuffersize\fP Size of buffer
29     .sp
30 nigel 93 The yield is the length of the string, PCRE_ERROR_NOMEMORY if the buffer was
31 nigel 63 too small, or PCRE_ERROR_NOSUBSTRING if the string number is invalid.
32 nigel 75 .P
33     There is a complete description of the PCRE native API in the
34 nigel 63 .\" HREF
35 nigel 75 \fBpcreapi\fP
36 nigel 63 .\"
37 nigel 75 page and a description of the POSIX API in the
38     .\" HREF
39     \fBpcreposix\fP
40     .\"
41 nigel 63 page.

webmaster@exim.org
ViewVC Help
Powered by ViewVC 1.1.12