1 ==============================================================================
2 Release of version 1.89 of Text::Balanced
3 ==============================================================================
8 Text::Balanced - Extract delimited text sequences from strings.
11 SUMMARY (see Balanced.pod for full details)
13 Text::Balanced::extract_delimited
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
20 Text::Balanced::extract_bracketed
22 `extract_bracketed' extracts a balanced-bracket-delimited substring
23 (using any one (or more) of the user-specified delimiter brackets:
24 '(..)', '{..}', '[..]', or '<..>').
26 Text::Balanced::extract_quotelike
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.
33 Text::Balanced::extract_codeblock
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'.
41 Text::Balanced::extract_tagged
43 `extract_tagged' attempts to recognize and extract a
44 substring between two arbitrary "tag" patterns (a start tag
50 It's all pure Perl, so just put the .pm file in its appropriate
51 local Perl subdirectory.
56 Damian Conway (damian@cs.monash.edu.au)
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.
67 ==============================================================================
69 CHANGES IN VERSION 1.89
72 - Fixed extvar.t tests
75 ==============================================================================
79 Text::Balanced has been uploaded to the CPAN
80 and is also available from:
82 http://www.csse.monash.edu.au/~damian/CPAN/Text-Balanced.tar.gz
84 ==============================================================================