summaryrefslogtreecommitdiff
path: root/doc/pcre_copy_named_substring.3
diff options
context:
space:
mode:
Diffstat (limited to 'doc/pcre_copy_named_substring.3')
-rw-r--r--doc/pcre_copy_named_substring.338
1 files changed, 21 insertions, 17 deletions
diff --git a/doc/pcre_copy_named_substring.3 b/doc/pcre_copy_named_substring.3
index 915bd0a..92e47be 100644
--- a/doc/pcre_copy_named_substring.3
+++ b/doc/pcre_copy_named_substring.3
@@ -8,33 +8,37 @@ PCRE - Perl-compatible regular expressions
.PP
.SM
.br
-.B int pcre_copy_named_substring(const pcre *\fIcode\fR,
+.B int pcre_copy_named_substring(const pcre *\fIcode\fP,
.ti +5n
-.B const char *\fIsubject\fR, int *\fIovector\fR,
+.B const char *\fIsubject\fP, int *\fIovector\fP,
.ti +5n
-.B int \fIstringcount\fR, const char *\fIstringname\fR,
+.B int \fIstringcount\fP, const char *\fIstringname\fP,
.ti +5n
-.B char *\fIbuffer\fR, int \fIbuffersize\fR);
-
+.B char *\fIbuffer\fP, int \fIbuffersize\fP);
+.
.SH DESCRIPTION
.rs
.sp
This is a convenience function for extracting a captured substring, identified
by name, into a given buffer. The arguments are:
-
- \fIcode\fR Pattern that was successfully matched
- \fIsubject\fR Subject that has been successfully matched
- \fIovector\fR Offset vector that \fBpcre_exec()\fR used
- \fIstringcount\fR Value returned by \fBpcre_exec()\fR
- \fIstringname\fR Name of the required substring
- \fIbuffer\fR Buffer to receive the string
- \fIbuffersize\fR Size of buffer
-
+.sp
+ \fIcode\fP Pattern that was successfully matched
+ \fIsubject\fP Subject that has been successfully matched
+ \fIovector\fP Offset vector that \fBpcre_exec()\fP used
+ \fIstringcount\fP Value returned by \fBpcre_exec()\fP
+ \fIstringname\fP Name of the required substring
+ \fIbuffer\fP Buffer to receive the string
+ \fIbuffersize\fP Size of buffer
+.sp
The yield is the length of the substring, PCRE_ERROR_NOMEMORY if the buffer was
too small, or PCRE_ERROR_NOSUBSTRING if the string name is invalid.
-
-There is a complete description of the PCRE API in the
+.P
+There is a complete description of the PCRE native API in the
+.\" HREF
+\fBpcreapi\fP
+.\"
+page and a description of the POSIX API in the
.\" HREF
-\fBpcreapi\fR
+\fBpcreposix\fP
.\"
page.