summaryrefslogtreecommitdiff
path: root/doc/CALLOUTS.BUILTIN
blob: dcf87f8b4537035cab2462fe0b4bbc5607201c2b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
CALLOUTS.BUILTIN               2018/03/19


* FAIL    (progress)

  (*FAIL)

  Always fail.


* MISMATCH    (progress)

  (*MISMATCH)

  Terminate Match process.
  Continue Search process.


* ERROR    (progress)

  (*ERROR{n::LONG})

  Terminate Search/Match process.

  Return value is the argument 'n'. (The value must be less than -1)
  'n' is an optional argument. (default value is ONIG_ABORT)


* MAX    (progress/retraction)

  (*MAX{n::LONG})

  Restrict the maximum count of success.

  [callout data]
  slot 0: current success count.


* COUNT    (progress/retraction)

  (*COUNT{c::CHAR})

  Counter.
  Depends on 'c' argument, the slot 0 value changes.
  'c' is an optional argument, deefault value is '>'.

  [callout data]
  slot 0: '>': progress count, '<': retraction count, 'X': success count
  slot 1: progress count
  slot 2: retraction count

  (* success count = progress count - retraction count)

  ** If option ONIG_OPTION_FIND_LONGEST or ONIG_OPTION_FIND_NOT_EMPTY is used,
     counts are not accurate.


* TOTAL_COUNT    (progress/retraction)

  (*TOTAL_COUNT{c::CHAR})

  It's the almost same as COUNT.
  But the counts are integrated in a search process.
  'c' is an optional argument, deefault value is '>'.

  [callout data]
  slot 0: '>': progress count, '<': retraction count, 'X': success count
  slot 1: progress count
  slot 2: retraction count

  ** If option ONIG_OPTION_FIND_LONGEST or ONIG_OPTION_FIND_NOT_EMPTY is used,
     counts are not accurate.


* CMP    (progress)

  (*CMP{x::TAG/LONG, op::STRING, y::TAG/LONG})

  Compare x value and y value with op operator.

  op: '==', '!=', '>', '<', '>=', '<='

  ex. "(?:(*MAX[TA]{7})a|(*MAX[TB]{5})b)*(*CMP{TA,>=,4})"

  [callout data]
  slot 0: op value (enum OP_CMP in src/regexec.c)

//END