https://perl5.git.perl.org / perl5.git / blame
| Commit | Line | Data |
|---|---|---|
| ecad4393 | 1 | Text::Balanced version 2.0.0 |
| 55a1c97c JH |
2 | |
| 3 | Text::Balanced - Extract delimited text sequences from strings. | |
| 4 | ||
| ecad4393 | 5 | SUMMARY |
| 55a1c97c JH |
6 | |
| 7 | Text::Balanced::extract_delimited | |
| 8 | ||
| 9 | `extract_delimited' extracts the initial substring of a string | |
| 10 | which is delimited by a user-specified set of single-character | |
| 11 | delimiters, whilst ignoring any backslash-escaped delimiter | |
| 12 | characters. | |
| 13 | ||
| 14 | Text::Balanced::extract_bracketed | |
| 15 | ||
| 16 | `extract_bracketed' extracts a balanced-bracket-delimited substring | |
| 17 | (using any one (or more) of the user-specified delimiter brackets: | |
| 18 | '(..)', '{..}', '[..]', or '<..>'). | |
| 19 | ||
| 20 | Text::Balanced::extract_quotelike | |
| 21 | ||
| 22 | `extract_quotelike' attempts to recognize and extract any one of the | |
| 23 | various Perl quote and quotelike operators (see "perlop(3)"). Embedded | |
| 24 | backslashed delimiters, nested bracket delimiters (for the | |
| 25 | quotelike operators), and trailing modifiers are all correctly handled. | |
| 26 | ||
| 27 | Text::Balanced::extract_codeblock | |
| 28 | ||
| 29 | `extract_codeblock' attempts to recognize and extract a | |
| 30 | balanced bracket-delimited substring which may also contain | |
| 31 | unbalanced brackets inside Perl quotes or quotelike | |
| 32 | operations. That is, `extract_codeblock' is like a combination | |
| 33 | of `extract_bracketed' and `extract_quotelike'. | |
| 34 | ||
| 35 | Text::Balanced::extract_tagged | |
| 36 | ||
| 37 | `extract_tagged' attempts to recognize and extract a | |
| 38 | substring between two arbitrary "tag" patterns (a start tag | |
| ecad4393 | 39 | and an end tag). |
| 55a1c97c | 40 | |
| 55a1c97c | 41 | |
| ecad4393 | 42 | INSTALLATION |
| 55a1c97c | 43 | |
| ecad4393 | 44 | To install this module, run the following commands: |
| 55a1c97c | 45 | |
| ecad4393 NC |
46 | perl Makefile.PL |
| 47 | make | |
| 48 | make test | |
| 49 | make install | |
| 55a1c97c JH |
50 | |
| 51 | ||
| ecad4393 | 52 | Alternatively, to install with Module::Build, you can use the following commands: |
| 55a1c97c | 53 | |
| ecad4393 NC |
54 | perl Build.PL |
| 55 | ./Build | |
| 56 | ./Build test | |
| 57 | ./Build install | |
| 55a1c97c | 58 | |
| 55a1c97c JH |
59 | |
| 60 | ||
| ecad4393 | 61 | DEPENDENCIES |
| 55a1c97c | 62 | |
| ecad4393 | 63 | None. |
| 55a1c97c | 64 | |
| 55a1c97c | 65 | |
| ecad4393 | 66 | COPYRIGHT AND LICENCE |
| 55a1c97c | 67 | |
| ecad4393 | 68 | Copyright (C) 2006, Damian Conway |
| 55a1c97c | 69 | |
| ecad4393 NC |
70 | This library is free software; you can redistribute it and/or modify |
| 71 | it under the same terms as Perl itself. |