NAME

   Text::Balanced - Extract delimited text sequences from strings.


SUMMARY (see Balanced.pod for full details)

   Text::Balanced::extract_delimited

       `extract_delimited' extracts the initial substring of a string
       which is delimited by a user-specified set of single-character
       delimiters, whilst ignoring any backslash-escaped delimiter
       characters.

   Text::Balanced::extract_bracketed

       `extract_bracketed' extracts a balanced-bracket-delimited substring
       (using any one (or more) of the user-specified delimiter brackets:
       '(..)', '{..}', '[..]', or '<..>').

   Text::Balanced::extract_quotelike

       `extract_quotelike' attempts to recognize and extract any one of the
       various Perl quote and quotelike operators (see "perlop(3)"). Embedded
       backslashed delimiters, nested bracket delimiters (for the
       quotelike operators), and trailing modifiers are all correctly handled.

   Text::Balanced::extract_codeblock

       `extract_codeblock' attempts to recognize and extract a
       balanced bracket-delimited substring which may also contain
       unbalanced brackets inside Perl quotes or quotelike
       operations. That is, `extract_codeblock' is like a combination
       of `extract_bracketed' and `extract_quotelike'.


INSTALLATION

   It's all pure Perl, so just put the .pm file in its appropriate
   local Perl subdirectory.


CHANGES

   This is version 1.10.
   Previous version was 1.01.
   See the file "Changes" for details.


AUTHOR

   Damian Conway ([email protected])


COPYRIGHT

      Copyright (c) 1997, Damian Conway. All Rights Reserved.
    This module is free software. It may be used, redistributed
    and/or modified under the terms of the Perl Artistic License
         (see http://www.perl.com/perl/misc/Artistic.html)