Lines Matching full:callout
19 <li><a name="TOC4" href="#SEC4">THE CALLOUT INTERFACE</a>
21 <li><a name="TOC6" href="#SEC6">CALLOUT ENUMERATION</a>
39 PCRE2 provides a feature called "callout", which is a means of temporarily
48 function is to be called. Different callout points can be identified by putting
54 two callout points:
70 Notice that there is a callout before and after each parenthesis and
72 an assertion, an automatic callout is inserted immediately before the
73 condition. Such a callout may also be inserted explicitly, for example:
184 start, and the callout is never reached. However, with "abyd", though the
185 result is still no match, the callout is obeyed.
198 <br><a name="SEC4" href="#TOC1">THE CALLOUT INTERFACE</a><br>
200 During matching, when PCRE2 reaches a callout point, if an external function is
202 matching. The first argument to the callout function is a pointer to a
203 <b>pcre2_callout</b> block. The second argument is the void * callout data that
204 was supplied when the callout was set up by calling <b>pcre2_set_callout()</b>
207 documentation). The callout block structure contains the following fields:
226 current version is 1; the three callout string fields were added for this
236 For a numerical callout, <i>callout_string</i> is NULL, and <i>callout_number</i>
237 contains the number of the callout, in the range 0-255. This is the number
249 into single characters, but there is no other processing of the callout string
258 the callout argument string within the original pattern string. This is
260 need to report errors in the callout string within the pattern.
266 The remaining fields in the callout block are the same for both kinds of
267 callout.
285 point. If the pattern is not anchored, the callout function may be called
313 matched in the pattern string. When the callout immediately precedes an
315 is zero. When the callout precedes an opening parenthesis, the length is that
321 same callout number. However, they are set for all callouts, and are used by
322 <b>pcre2test</b> to show the next item to be matched when displaying callout
334 The external callout function returns an integer to PCRE2. If the value is
344 failure. The error number PCRE2_ERROR_CALLOUT is reserved for use by callout
347 <br><a name="SEC6" href="#TOC1">CALLOUT ENUMERATION</a><br>
359 callout in the pattern in the order in which they appear. Its first argument is
360 a pointer to a callout enumeration block, and its second argument is the
369 <i>callout_string_length</i> Length of callout string
370 <i>callout_string</i> Points to callout string or is NULL
379 Note that the value of <i>pattern_position</i> is unique for each callout.
380 However, if a callout occurs inside a group that is quantified with a non-zero
383 /(a)(a)/. This means that the callout will be enumerated more than once, but