I've tried it, and it's fairly obvious what it means, but nonetheless, the help file is incomplete and/or out of date.
There is also no explanation of what the dropdown option means Reset at start of each region.
This is really not obvious, as I've no idea what the word region might denote in the context of this filter.
This section of the help needs better explaining!
The help states
I can't make sense of how TextPipe processes the data, in order to use this filter successfully.It is VERY important to understand how TextPipe processes data to use this filter successfully. For most applications, this will involve placing this filter inside a Restrict to each line in turn filter. If you do not, the text captured will most likely be the very last value found in the file. If you have any questions about this, please contact us.
- When I include the Restrict to each line in turn filter as advised, I don't get any captured values. The variable remains empty!!!
When I exclude the Restrict to each line in turn filter, I get some values to the variable, but not all of those shown using Break on value change.
Code: Select all
Comment... | Output merged VPL file | | Bug: The captured variable has | 388 values instead of 1190 values. | | e.g. First value is GENESE 43 when it should be GENESE 1 | Yet, Break on change value works as expected. | +--T-Filter | |--Comment... | | Capture book name and chapter number | | | +--Perl pattern [^(.+) (\d+)$] with  | | [ ] Match case | | [ ] Whole words only | | [ ] Case sensitive replace | | [ ] Prompt on replace | | [ ] Skip prompt if identical | | [ ] First only | | [ ] Extract matches | | Maximum text buffer size 4096 | | [X] Maximum match (greedy) | | [ ] Allow comments | | [ ] '.' matches newline | | [X] UTF-8 Support | | | +--Capture to variable @BookChapter | Reset: 3 | +--Comment... | Convert verse lines to VPL format | |--Remove non-matching lines [^(\d+)\.\t(.+)$] | [ ] Include line numbers | [ ] Include filename | [ ] Match case | [ ] Count matches | Pattern type: 0 | [X] UTF8 Support | [ ] Ignore empty matches | Context before: 0 | Context after: 0 | |--Perl pattern [\.\t] with [ ] | [X] Match case | [ ] Whole words only | [ ] Case sensitive replace | [ ] Prompt on replace | [ ] Skip prompt if identical | [ ] First only | [ ] Extract matches | Maximum text buffer size 4096 | [ ] Maximum match (greedy) | [ ] Allow comments | [ ] '.' matches newline | [X] UTF-8 Support | |--Add left margin [@BookChapter\t] | +--Merge output to file D:\Download\Java\GoBibleCreator\Captured\French David Martin 1744\VPL\Martin1744.vpl.txt
There are only 388 values captured, yet the whole [French] Bible contains 1189 chapters.
For the shorter books, many of the captures are just the very last value found in the file.
For the longer books, more values are captured, but the proportion thus captured is very uneven.
e.g. 4 out of 50 for GENESE, yet 19 out of 40 for EXODE.