| 1 |
root |
1.1 |
============================================================================== |
| 2 |
|
|
Release of version 1.95 of Text::Balanced |
| 3 |
|
|
============================================================================== |
| 4 |
|
|
|
| 5 |
|
|
|
| 6 |
|
|
NAME |
| 7 |
|
|
|
| 8 |
|
|
Text::Balanced - Extract delimited text sequences from strings. |
| 9 |
|
|
|
| 10 |
|
|
|
| 11 |
|
|
SUMMARY (see Balanced.pod for full details) |
| 12 |
|
|
|
| 13 |
|
|
Text::Balanced::extract_delimited |
| 14 |
|
|
|
| 15 |
|
|
`extract_delimited' extracts the initial substring of a string |
| 16 |
|
|
which is delimited by a user-specified set of single-character |
| 17 |
|
|
delimiters, whilst ignoring any backslash-escaped delimiter |
| 18 |
|
|
characters. |
| 19 |
|
|
|
| 20 |
|
|
Text::Balanced::extract_bracketed |
| 21 |
|
|
|
| 22 |
|
|
`extract_bracketed' extracts a balanced-bracket-delimited substring |
| 23 |
|
|
(using any one (or more) of the user-specified delimiter brackets: |
| 24 |
|
|
'(..)', '{..}', '[..]', or '<..>'). |
| 25 |
|
|
|
| 26 |
|
|
Text::Balanced::extract_quotelike |
| 27 |
|
|
|
| 28 |
|
|
`extract_quotelike' attempts to recognize and extract any one of the |
| 29 |
|
|
various Perl quote and quotelike operators (see "perlop(3)"). Embedded |
| 30 |
|
|
backslashed delimiters, nested bracket delimiters (for the |
| 31 |
|
|
quotelike operators), and trailing modifiers are all correctly handled. |
| 32 |
|
|
|
| 33 |
|
|
Text::Balanced::extract_codeblock |
| 34 |
|
|
|
| 35 |
|
|
`extract_codeblock' attempts to recognize and extract a |
| 36 |
|
|
balanced bracket-delimited substring which may also contain |
| 37 |
|
|
unbalanced brackets inside Perl quotes or quotelike |
| 38 |
|
|
operations. That is, `extract_codeblock' is like a combination |
| 39 |
|
|
of `extract_bracketed' and `extract_quotelike'. |
| 40 |
|
|
|
| 41 |
|
|
Text::Balanced::extract_tagged |
| 42 |
|
|
|
| 43 |
|
|
`extract_tagged' attempts to recognize and extract a |
| 44 |
|
|
substring between two arbitrary "tag" patterns (a start tag |
| 45 |
|
|
and an end tag). |
| 46 |
|
|
|
| 47 |
|
|
|
| 48 |
|
|
INSTALLATION |
| 49 |
|
|
|
| 50 |
|
|
It's all pure Perl, so just put the .pm file in its appropriate |
| 51 |
|
|
local Perl subdirectory. |
| 52 |
|
|
|
| 53 |
|
|
|
| 54 |
|
|
AUTHOR |
| 55 |
|
|
|
| 56 |
|
|
Damian Conway (damian@cs.monash.edu.au) |
| 57 |
|
|
|
| 58 |
|
|
|
| 59 |
|
|
COPYRIGHT |
| 60 |
|
|
|
| 61 |
|
|
Copyright (c) 1997-2001, Damian Conway. All Rights Reserved. |
| 62 |
|
|
This module is free software. It may be used, redistributed |
| 63 |
|
|
and/or modified under the same terms as Perl itself. |
| 64 |
|
|
|
| 65 |
|
|
|
| 66 |
|
|
|
| 67 |
|
|
============================================================================== |
| 68 |
|
|
|
| 69 |
|
|
CHANGES IN VERSION 1.95 |
| 70 |
|
|
|
| 71 |
|
|
|
| 72 |
|
|
- Constrainted _match_quote to only match at word boundaries |
| 73 |
|
|
(so "exemplum(hic)" doesn't match "m(hic)") |
| 74 |
|
|
(thanks Craig) |
| 75 |
|
|
|
| 76 |
|
|
|
| 77 |
|
|
============================================================================== |
| 78 |
|
|
|
| 79 |
|
|
AVAILABILITY |
| 80 |
|
|
|
| 81 |
|
|
Text::Balanced has been uploaded to the CPAN |
| 82 |
|
|
|
| 83 |
|
|
============================================================================== |