714 |
+10 ^ ^ |
+10 ^ ^ |
715 |
0: E* |
0: E* |
716 |
.sp |
.sp |
717 |
|
If a pattern contains (*MARK) items, an additional line is output whenever |
718 |
|
a change of latest mark is passed to the callout function. For example: |
719 |
|
.sp |
720 |
|
re> /a(*MARK:X)bc/C |
721 |
|
data> abc |
722 |
|
--->abc |
723 |
|
+0 ^ a |
724 |
|
+1 ^^ (*MARK:X) |
725 |
|
+10 ^^ b |
726 |
|
Latest Mark: X |
727 |
|
+11 ^ ^ c |
728 |
|
+12 ^ ^ |
729 |
|
0: abc |
730 |
|
.sp |
731 |
|
The mark changes between matching "a" and "b", but stays the same for the rest |
732 |
|
of the match, so nothing more is output. If, as a result of backtracking, the |
733 |
|
mark reverts to being unset, the text "<unset>" is output. |
734 |
|
.P |
735 |
The callout function in \fBpcretest\fP returns zero (carry on matching) by |
The callout function in \fBpcretest\fP returns zero (carry on matching) by |
736 |
default, but you can use a \eC item in a data line (as described above) to |
default, but you can use a \eC item in a data line (as described above) to |
737 |
change this. |
change this and other parameters of the callout. |
738 |
.P |
.P |
739 |
Inserting callouts can be helpful when using \fBpcretest\fP to check |
Inserting callouts can be helpful when using \fBpcretest\fP to check |
740 |
complicated regular expressions. For further information about callouts, see |
complicated regular expressions. For further information about callouts, see |
841 |
.rs |
.rs |
842 |
.sp |
.sp |
843 |
.nf |
.nf |
844 |
Last updated: 20 July 2011 |
Last updated: 01 August 2011 |
845 |
Copyright (c) 1997-2011 University of Cambridge. |
Copyright (c) 1997-2011 University of Cambridge. |
846 |
.fi |
.fi |