CALLOUTS.BUILTIN 2018/03/26
|
|
|
* FAIL (progress)
|
|
(*FAIL)
|
|
Always fail.
|
|
|
* MISMATCH (progress)
|
|
(*MISMATCH)
|
|
Terminates Match process.
|
Continues Search process.
|
|
|
* ERROR (progress)
|
|
(*ERROR{n::LONG})
|
|
Terminates 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/TAG, c::CHAR})
|
|
Restricts the maximum count of success(default), progress or retraction.
|
If 'n' type is tag, slot 0 value of the tag are used.
|
Depends on 'c' argument, the slot 0 value changes.
|
'c' is an optional argument, default value is 'X'.
|
|
(* success count = progress count - retraction count)
|
|
|
ex. "(?:(*COUNT[T]{X})a)*(?:(*MAX{T})c)*"
|
|
[callout data]
|
slot 0: '>': progress count, '<': retraction count, 'X': success count (default)
|
|
|
* COUNT (progress/retraction)
|
|
(*COUNT{c::CHAR})
|
|
Counter.
|
Depends on 'c' argument, the slot 0 value changes.
|
'c' is an optional argument, default value is '>'.
|
|
[callout data]
|
slot 0: '>': progress count (default), '<': 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.
|
|
|
* 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, default value is '>'.
|
|
[callout data]
|
slot 0: '>': progress count (default), '<': 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})
|
|
Compares x value and y value with op operator.
|
If x and y types are tag, slot 0 value of the tag are used.
|
|
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
|
