| 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 ([email protected])
|
|---|
| 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 | ==============================================================================
|
|---|
