1823 
number is 1, and the offsets for for the second and third capturing subpatterns 
number is 1, and the offsets for for the second and third capturing subpatterns 
1824 
(assuming the vector is large enough, of course) are set to 1. 
(assuming the vector is large enough, of course) are set to 1. 
1825 
.P 
.P 
1826 
\fBNote\fP: Elements of \fIovector\fP that do not correspond to capturing 
\fBNote\fP: Elements in the first twothids of \fIovector\fP that do not 
1827 
parentheses in the pattern are never changed. That is, if a pattern contains 
correspond to capturing parentheses in the pattern are never changed. That is, 
1828 
\fIn\fP capturing parentheses, no more than \fIovector[0]\fP to 
if a pattern contains \fIn\fP capturing parentheses, no more than 
1829 
\fIovector[2n+1]\fP are set by \fBpcre_exec()\fP. The other elements retain 
\fIovector[0]\fP to \fIovector[2n+1]\fP are set by \fBpcre_exec()\fP. The other 
1830 
whatever values they previously had. 
elements (in the first twothirds) retain whatever values they previously had. 
1831 
.P 
.P 
1832 
Some convenience functions are provided for extracting the captured substrings 
Some convenience functions are provided for extracting the captured substrings 
1833 
as separate strings. These are described below. 
as separate strings. These are described below. 
2428 
The strings are returned in reverse order of length; that is, the longest 
The strings are returned in reverse order of length; that is, the longest 
2429 
matching string is given first. If there were too many matches to fit into 
matching string is given first. If there were too many matches to fit into 
2430 
\fIovector\fP, the yield of the function is zero, and the vector is filled with 
\fIovector\fP, the yield of the function is zero, and the vector is filled with 
2431 
the longest matches. 
the longest matches. Unlike \fBpcre_exec()\fP, \fBpcre_dfa_exec()\fP can use 
2432 

the entire \fIovector\fP for returning matched strings. 
2433 
. 
. 
2434 
. 
. 
2435 
.SS "Error returns from \fBpcre_dfa_exec()\fP" 
.SS "Error returns from \fBpcre_dfa_exec()\fP" 
2498 
.rs 
.rs 
2499 
.sp 
.sp 
2500 
.nf 
.nf 
2501 
Last updated: 27 August 2011 
Last updated: 29 August 2011 
2502 
Copyright (c) 19972011 University of Cambridge. 
Copyright (c) 19972011 University of Cambridge. 
2503 
.fi 
.fi 