Lines Matching full:callout
21 PCRE2 provides a feature called "callout", which is a means of temporarily
31 function is to be called. Different callout points can be identified by putting
37 two callout points:
51 Notice that there is a callout before and after each parenthesis and
53 an assertion, an automatic callout is inserted immediately before the
54 condition. Such a callout may also be inserted explicitly, for example:
166 start, and the callout is never reached. However, with "abyd", though the
167 result is still no match, the callout is obeyed.
180 .SH "THE CALLOUT INTERFACE"
183 During matching, when PCRE2 reaches a callout point, if an external function is
185 matching. The first argument to the callout function is a pointer to a
186 \fBpcre2_callout\fP block. The second argument is the void * callout data that
187 was supplied when the callout was set up by calling \fBpcre2_set_callout()\fP
192 documentation). The callout block structure contains the following fields:
211 current version is 1; the three callout string fields were added for this
221 For a numerical callout, \fIcallout_string\fP is NULL, and \fIcallout_number\fP
222 contains the number of the callout, in the range 0-255. This is the number
234 into single characters, but there is no other processing of the callout string
242 the callout argument string within the original pattern string. This is
244 need to report errors in the callout string within the pattern.
250 The remaining fields in the callout block are the same for both kinds of
251 callout.
266 point. If the pattern is not anchored, the callout function may be called
289 matched in the pattern string. When the callout immediately precedes an
291 is zero. When the callout precedes an opening parenthesis, the length is that
296 same callout number. However, they are set for all callouts, and are used by
297 \fBpcre2test\fP to show the next item to be matched when displaying callout
310 The external callout function returns an integer to PCRE2. If the value is
319 failure. The error number PCRE2_ERROR_CALLOUT is reserved for use by callout
323 .SH "CALLOUT ENUMERATION"
337 callout in the pattern in the order in which they appear. Its first argument is
338 a pointer to a callout enumeration block, and its second argument is the
347 \fIcallout_string_length\fP Length of callout string
348 \fIcallout_string\fP Points to callout string or is NULL
359 Note that the value of \fIpattern_position\fP is unique for each callout.
360 However, if a callout occurs inside a group that is quantified with a non-zero
363 /(a)(a)/. This means that the callout will be enumerated more than once, but
