Added Cyg-Win
This commit is contained in:
parent
82cbc206eb
commit
413c315806
10586 changed files with 3806249 additions and 0 deletions
84
Agent-Windows/OGP64/usr/share/perl5/5.40/Text/Abbrev.pm
Normal file
84
Agent-Windows/OGP64/usr/share/perl5/5.40/Text/Abbrev.pm
Normal file
|
|
@ -0,0 +1,84 @@
|
|||
package Text::Abbrev;
|
||||
require 5.005; # Probably works on earlier versions too.
|
||||
require Exporter;
|
||||
|
||||
our $VERSION = '1.02';
|
||||
|
||||
=head1 NAME
|
||||
|
||||
Text::Abbrev - abbrev - create an abbreviation table from a list
|
||||
|
||||
=head1 SYNOPSIS
|
||||
|
||||
use Text::Abbrev;
|
||||
abbrev $hashref, LIST
|
||||
|
||||
|
||||
=head1 DESCRIPTION
|
||||
|
||||
Stores all unambiguous truncations of each element of LIST
|
||||
as keys in the associative array referenced by C<$hashref>.
|
||||
The values are the original list elements.
|
||||
|
||||
=head1 EXAMPLE
|
||||
|
||||
$hashref = abbrev qw(list edit send abort gripe);
|
||||
|
||||
%hash = abbrev qw(list edit send abort gripe);
|
||||
|
||||
abbrev $hashref, qw(list edit send abort gripe);
|
||||
|
||||
abbrev(*hash, qw(list edit send abort gripe));
|
||||
|
||||
=cut
|
||||
|
||||
@ISA = qw(Exporter);
|
||||
@EXPORT = qw(abbrev);
|
||||
|
||||
# Usage:
|
||||
# abbrev \%foo, LIST;
|
||||
# ...
|
||||
# $long = $foo{$short};
|
||||
|
||||
sub abbrev {
|
||||
my ($word, $hashref, $glob, %table, $returnvoid);
|
||||
|
||||
@_ or return; # So we don't autovivify onto @_ and trigger warning
|
||||
if (ref($_[0])) { # hash reference preferably
|
||||
$hashref = shift;
|
||||
$returnvoid = 1;
|
||||
} elsif (ref \$_[0] eq 'GLOB') { # is actually a glob (deprecated)
|
||||
$hashref = \%{shift()};
|
||||
$returnvoid = 1;
|
||||
}
|
||||
%{$hashref} = ();
|
||||
|
||||
WORD: foreach $word (@_) {
|
||||
for (my $len = (length $word) - 1; $len > 0; --$len) {
|
||||
my $abbrev = substr($word,0,$len);
|
||||
my $seen = ++$table{$abbrev};
|
||||
if ($seen == 1) { # We're the first word so far to have
|
||||
# this abbreviation.
|
||||
$hashref->{$abbrev} = $word;
|
||||
} elsif ($seen == 2) { # We're the second word to have this
|
||||
# abbreviation, so we can't use it.
|
||||
delete $hashref->{$abbrev};
|
||||
} else { # We're the third word to have this
|
||||
# abbreviation, so skip to the next word.
|
||||
next WORD;
|
||||
}
|
||||
}
|
||||
}
|
||||
# Non-abbreviations always get entered, even if they aren't unique
|
||||
foreach $word (@_) {
|
||||
$hashref->{$word} = $word;
|
||||
}
|
||||
return if $returnvoid;
|
||||
if (wantarray) {
|
||||
%{$hashref};
|
||||
} else {
|
||||
$hashref;
|
||||
}
|
||||
}
|
||||
|
||||
1;
|
||||
2434
Agent-Windows/OGP64/usr/share/perl5/5.40/Text/Balanced.pm
Normal file
2434
Agent-Windows/OGP64/usr/share/perl5/5.40/Text/Balanced.pm
Normal file
File diff suppressed because it is too large
Load diff
327
Agent-Windows/OGP64/usr/share/perl5/5.40/Text/ParseWords.pm
Normal file
327
Agent-Windows/OGP64/usr/share/perl5/5.40/Text/ParseWords.pm
Normal file
|
|
@ -0,0 +1,327 @@
|
|||
package Text::ParseWords;
|
||||
|
||||
use strict;
|
||||
use warnings;
|
||||
require 5.006;
|
||||
our $VERSION = "3.31";
|
||||
|
||||
|
||||
use Exporter;
|
||||
our @ISA = qw(Exporter);
|
||||
our @EXPORT = qw(shellwords quotewords nested_quotewords parse_line);
|
||||
our @EXPORT_OK = qw(old_shellwords);
|
||||
our $PERL_SINGLE_QUOTE;
|
||||
|
||||
|
||||
sub shellwords {
|
||||
my (@lines) = @_;
|
||||
my @allwords;
|
||||
|
||||
foreach my $line (@lines) {
|
||||
$line =~ s/^\s+//;
|
||||
my @words = parse_line('\s+', 0, $line);
|
||||
pop @words if (@words and !defined $words[-1]);
|
||||
return() unless (@words || !length($line));
|
||||
push(@allwords, @words);
|
||||
}
|
||||
return(@allwords);
|
||||
}
|
||||
|
||||
|
||||
|
||||
sub quotewords {
|
||||
my($delim, $keep, @lines) = @_;
|
||||
my($line, @words, @allwords);
|
||||
|
||||
foreach $line (@lines) {
|
||||
@words = parse_line($delim, $keep, $line);
|
||||
return() unless (@words || !length($line));
|
||||
push(@allwords, @words);
|
||||
}
|
||||
return(@allwords);
|
||||
}
|
||||
|
||||
|
||||
|
||||
sub nested_quotewords {
|
||||
my($delim, $keep, @lines) = @_;
|
||||
my($i, @allwords);
|
||||
|
||||
for ($i = 0; $i < @lines; $i++) {
|
||||
@{$allwords[$i]} = parse_line($delim, $keep, $lines[$i]);
|
||||
return() unless (@{$allwords[$i]} || !length($lines[$i]));
|
||||
}
|
||||
return(@allwords);
|
||||
}
|
||||
|
||||
|
||||
|
||||
sub parse_line {
|
||||
my($delimiter, $keep, $line) = @_;
|
||||
my($word, @pieces);
|
||||
|
||||
no warnings 'uninitialized'; # we will be testing undef strings
|
||||
|
||||
while (length($line)) {
|
||||
# This pattern is optimised to be stack conservative on older perls.
|
||||
# Do not refactor without being careful and testing it on very long strings.
|
||||
# See Perl bug #42980 for an example of a stack busting input.
|
||||
$line =~ s/^
|
||||
(?:
|
||||
# double quoted string
|
||||
(") # $quote
|
||||
((?>[^\\"]*(?:\\.[^\\"]*)*))" # $quoted
|
||||
| # --OR--
|
||||
# singe quoted string
|
||||
(') # $quote
|
||||
((?>[^\\']*(?:\\.[^\\']*)*))' # $quoted
|
||||
| # --OR--
|
||||
# unquoted string
|
||||
( # $unquoted
|
||||
(?:\\.|[^\\"'])*?
|
||||
)
|
||||
# followed by
|
||||
( # $delim
|
||||
\Z(?!\n) # EOL
|
||||
| # --OR--
|
||||
(?-x:$delimiter) # delimiter
|
||||
| # --OR--
|
||||
(?!^)(?=["']) # a quote
|
||||
)
|
||||
)//xs or return; # extended layout
|
||||
my ($quote, $quoted, $unquoted, $delim) = (($1 ? ($1,$2) : ($3,$4)), $5, $6);
|
||||
|
||||
|
||||
return() unless( defined($quote) || length($unquoted) || length($delim));
|
||||
|
||||
if ($keep) {
|
||||
$quoted = "$quote$quoted$quote";
|
||||
}
|
||||
else {
|
||||
$unquoted =~ s/\\(.)/$1/sg;
|
||||
if (defined $quote) {
|
||||
$quoted =~ s/\\(.)/$1/sg if ($quote eq '"');
|
||||
$quoted =~ s/\\([\\'])/$1/g if ( $PERL_SINGLE_QUOTE && $quote eq "'");
|
||||
}
|
||||
}
|
||||
$word .= substr($line, 0, 0); # leave results tainted
|
||||
$word .= defined $quote ? $quoted : $unquoted;
|
||||
|
||||
if (length($delim)) {
|
||||
push(@pieces, $word);
|
||||
push(@pieces, $delim) if ($keep eq 'delimiters');
|
||||
undef $word;
|
||||
}
|
||||
if (!length($line)) {
|
||||
push(@pieces, $word);
|
||||
}
|
||||
}
|
||||
return(@pieces);
|
||||
}
|
||||
|
||||
|
||||
|
||||
sub old_shellwords {
|
||||
|
||||
# Usage:
|
||||
# use ParseWords;
|
||||
# @words = old_shellwords($line);
|
||||
# or
|
||||
# @words = old_shellwords(@lines);
|
||||
# or
|
||||
# @words = old_shellwords(); # defaults to $_ (and clobbers it)
|
||||
|
||||
no warnings 'uninitialized'; # we will be testing undef strings
|
||||
local *_ = \join('', @_) if @_;
|
||||
my (@words, $snippet);
|
||||
|
||||
s/\A\s+//;
|
||||
while ($_ ne '') {
|
||||
my $field = substr($_, 0, 0); # leave results tainted
|
||||
for (;;) {
|
||||
if (s/\A"(([^"\\]|\\.)*)"//s) {
|
||||
($snippet = $1) =~ s#\\(.)#$1#sg;
|
||||
}
|
||||
elsif (/\A"/) {
|
||||
require Carp;
|
||||
Carp::carp("Unmatched double quote: $_");
|
||||
return();
|
||||
}
|
||||
elsif (s/\A'(([^'\\]|\\.)*)'//s) {
|
||||
($snippet = $1) =~ s#\\(.)#$1#sg;
|
||||
}
|
||||
elsif (/\A'/) {
|
||||
require Carp;
|
||||
Carp::carp("Unmatched single quote: $_");
|
||||
return();
|
||||
}
|
||||
elsif (s/\A\\(.?)//s) {
|
||||
$snippet = $1;
|
||||
}
|
||||
elsif (s/\A([^\s\\'"]+)//) {
|
||||
$snippet = $1;
|
||||
}
|
||||
else {
|
||||
s/\A\s+//;
|
||||
last;
|
||||
}
|
||||
$field .= $snippet;
|
||||
}
|
||||
push(@words, $field);
|
||||
}
|
||||
return @words;
|
||||
}
|
||||
|
||||
1;
|
||||
|
||||
__END__
|
||||
|
||||
=head1 NAME
|
||||
|
||||
Text::ParseWords - parse text into an array of tokens or array of arrays
|
||||
|
||||
=head1 SYNOPSIS
|
||||
|
||||
use Text::ParseWords;
|
||||
@lists = nested_quotewords($delim, $keep, @lines);
|
||||
@words = quotewords($delim, $keep, @lines);
|
||||
@words = shellwords(@lines);
|
||||
@words = parse_line($delim, $keep, $line);
|
||||
@words = old_shellwords(@lines); # DEPRECATED!
|
||||
|
||||
=head1 DESCRIPTION
|
||||
|
||||
The C<nested_quotewords()> and C<quotewords()> functions accept a delimiter
|
||||
(which can be a regular expression)
|
||||
and a list of lines and then breaks those lines up into a list of
|
||||
words ignoring delimiters that appear inside quotes. C<quotewords()>
|
||||
returns all of the tokens in a single long list, while C<nested_quotewords()>
|
||||
returns a list of token lists corresponding to the elements of C<@lines>.
|
||||
C<parse_line()> does tokenizing on a single string. The C<*quotewords()>
|
||||
functions simply call C<parse_line()>, so if you're only splitting
|
||||
one line you can call C<parse_line()> directly and save a function
|
||||
call.
|
||||
|
||||
The C<$keep> controls what happens with delimters and special characters:
|
||||
|
||||
=over 4
|
||||
|
||||
=item true
|
||||
|
||||
If true, then the tokens are split on the specified delimiter,
|
||||
but all other characters (including quotes and backslashes)
|
||||
are kept in the tokens.
|
||||
|
||||
=item false
|
||||
|
||||
If $keep is false then the C<*quotewords()> functions
|
||||
remove all quotes and backslashes that are
|
||||
not themselves backslash-escaped or inside of single quotes (i.e.,
|
||||
C<quotewords()> tries to interpret these characters just like the Bourne
|
||||
shell). NB: these semantics are significantly different from the
|
||||
original version of this module shipped with Perl 5.000 through 5.004.
|
||||
|
||||
=item C<"delimiters">
|
||||
|
||||
As an additional feature, $keep may be the keyword "delimiters" which
|
||||
causes the functions to preserve the delimiters in each string as
|
||||
tokens in the token lists, in addition to preserving quote and
|
||||
backslash characters.
|
||||
|
||||
=back
|
||||
|
||||
C<shellwords()> is written as a special case of C<quotewords()>, and it
|
||||
does token parsing with whitespace as a delimiter-- similar to most
|
||||
Unix shells.
|
||||
|
||||
=head1 EXAMPLES
|
||||
|
||||
The sample program:
|
||||
|
||||
use Text::ParseWords;
|
||||
@words = quotewords('\s+', 0, q{this is "a test" of\ quotewords \"for you});
|
||||
$i = 0;
|
||||
foreach (@words) {
|
||||
print "$i: <$_>\n";
|
||||
$i++;
|
||||
}
|
||||
|
||||
produces:
|
||||
|
||||
0: <this>
|
||||
1: <is>
|
||||
2: <a test>
|
||||
3: <of quotewords>
|
||||
4: <"for>
|
||||
5: <you>
|
||||
|
||||
demonstrating:
|
||||
|
||||
=over 4
|
||||
|
||||
=item 0Z<>
|
||||
|
||||
a simple word
|
||||
|
||||
=item 1Z<>
|
||||
|
||||
multiple spaces are skipped because of our $delim
|
||||
|
||||
=item 2Z<>
|
||||
|
||||
use of quotes to include a space in a word
|
||||
|
||||
=item 3Z<>
|
||||
|
||||
use of a backslash to include a space in a word
|
||||
|
||||
=item 4Z<>
|
||||
|
||||
use of a backslash to remove the special meaning of a double-quote
|
||||
|
||||
=item 5Z<>
|
||||
|
||||
another simple word (note the lack of effect of the
|
||||
backslashed double-quote)
|
||||
|
||||
=back
|
||||
|
||||
Replacing C<quotewords('\s+', 0, q{this is...})>
|
||||
with C<shellwords(q{this is...})>
|
||||
is a simpler way to accomplish the same thing.
|
||||
|
||||
=head1 SEE ALSO
|
||||
|
||||
L<Text::CSV> - for parsing CSV files
|
||||
|
||||
=head1 AUTHORS
|
||||
|
||||
The original author is unknown,
|
||||
but presumably this evolved from C<shellwords.pl> in Perl 4.
|
||||
|
||||
Much of the code for C<parse_line()>
|
||||
(including the primary regexp)
|
||||
came from Joerk Behrends E<lt>jbehrends@multimediaproduzenten.deE<gt>.
|
||||
|
||||
Examples section and other documentation provided by
|
||||
John Heidemann E<lt>johnh@ISI.EDUE<gt>.
|
||||
|
||||
Hal Pomeranz E<lt>pomeranz@netcom.comE<gt>
|
||||
maintained this from 1994 through 1999,
|
||||
and did the first CPAN release.
|
||||
|
||||
Alexandr Ciornii E<lt>alexchornyATgmail.comE<gt>
|
||||
maintained this from 2008 to 2015.
|
||||
|
||||
Many other people have contributed,
|
||||
with special thanks due to
|
||||
Michael Schwern E<lt>schwern@envirolink.orgE<gt>
|
||||
and
|
||||
Jeff Friedl E<lt>jfriedl@yahoo-inc.comE<gt>.
|
||||
|
||||
=head1 COPYRIGHT AND LICENSE
|
||||
|
||||
This library is free software; you may redistribute and/or modify it
|
||||
under the same terms as Perl itself.
|
||||
|
||||
=cut
|
||||
151
Agent-Windows/OGP64/usr/share/perl5/5.40/Text/Tabs.pm
Normal file
151
Agent-Windows/OGP64/usr/share/perl5/5.40/Text/Tabs.pm
Normal file
|
|
@ -0,0 +1,151 @@
|
|||
use strict; use warnings;
|
||||
|
||||
package Text::Tabs;
|
||||
|
||||
BEGIN { require Exporter; *import = \&Exporter::import }
|
||||
|
||||
our @EXPORT = qw( expand unexpand $tabstop );
|
||||
|
||||
our $VERSION = '2024.001';
|
||||
our $SUBVERSION = 'modern'; # back-compat vestige
|
||||
|
||||
our $tabstop = 8;
|
||||
|
||||
sub expand {
|
||||
my @l;
|
||||
my $pad;
|
||||
for ( @_ ) {
|
||||
defined or do { push @l, ''; next };
|
||||
my $s = '';
|
||||
for (split(/^/m, $_, -1)) {
|
||||
my $offs;
|
||||
for (split(/\t/, $_, -1)) {
|
||||
if (defined $offs) {
|
||||
$pad = $tabstop - $offs % $tabstop;
|
||||
$s .= " " x $pad;
|
||||
}
|
||||
$s .= $_;
|
||||
$offs = /^\pM/ + ( () = /\PM/g );
|
||||
}
|
||||
}
|
||||
push(@l, $s);
|
||||
}
|
||||
return @l if wantarray;
|
||||
return $l[0];
|
||||
}
|
||||
|
||||
sub unexpand
|
||||
{
|
||||
my (@l) = @_;
|
||||
my @e;
|
||||
my $x;
|
||||
my $line;
|
||||
my @lines;
|
||||
my $lastbit;
|
||||
my $ts_as_space = " " x $tabstop;
|
||||
for $x (@l) {
|
||||
defined $x or next;
|
||||
@lines = split("\n", $x, -1);
|
||||
for $line (@lines) {
|
||||
$line = expand($line);
|
||||
@e = split(/((?:\PM\pM*|^\pM+){$tabstop})/,$line,-1);
|
||||
$lastbit = pop(@e);
|
||||
$lastbit = ''
|
||||
unless defined $lastbit;
|
||||
$lastbit = "\t"
|
||||
if $lastbit eq $ts_as_space;
|
||||
for $_ (@e) {
|
||||
s/ +$/\t/;
|
||||
}
|
||||
$line = join('',@e, $lastbit);
|
||||
}
|
||||
$x = join("\n", @lines);
|
||||
}
|
||||
return @l if wantarray;
|
||||
return $l[0];
|
||||
}
|
||||
|
||||
1;
|
||||
|
||||
__END__
|
||||
|
||||
=head1 NAME
|
||||
|
||||
Text::Tabs - expand and unexpand tabs like unix expand(1) and unexpand(1)
|
||||
|
||||
=head1 SYNOPSIS
|
||||
|
||||
use Text::Tabs;
|
||||
|
||||
$tabstop = 4; # default = 8
|
||||
@lines_without_tabs = expand(@lines_with_tabs);
|
||||
@lines_with_tabs = unexpand(@lines_without_tabs);
|
||||
|
||||
=head1 DESCRIPTION
|
||||
|
||||
Text::Tabs does most of what the unix utilities expand(1) and unexpand(1)
|
||||
do. Given a line with tabs in it, C<expand> replaces those tabs with
|
||||
the appropriate number of spaces. Given a line with or without tabs in
|
||||
it, C<unexpand> adds tabs when it can save bytes by doing so,
|
||||
like the C<unexpand -a> command.
|
||||
|
||||
Unlike the old unix utilities, this module correctly accounts for
|
||||
any Unicode combining characters (such as diacriticals) that may occur
|
||||
in each line for both expansion and unexpansion. These are overstrike
|
||||
characters that do not increment the logical position. Make sure
|
||||
you have the appropriate Unicode settings enabled.
|
||||
|
||||
=head1 EXPORTS
|
||||
|
||||
The following are exported:
|
||||
|
||||
=over 4
|
||||
|
||||
=item expand
|
||||
|
||||
=item unexpand
|
||||
|
||||
=item $tabstop
|
||||
|
||||
The C<$tabstop> variable controls how many column positions apart each
|
||||
tabstop is. The default is 8.
|
||||
|
||||
Please note that C<local($tabstop)> doesn't do the right thing and if you want
|
||||
to use C<local> to override C<$tabstop>, you need to use
|
||||
C<local($Text::Tabs::tabstop)>.
|
||||
|
||||
=back
|
||||
|
||||
=head1 EXAMPLE
|
||||
|
||||
#!perl
|
||||
# unexpand -a
|
||||
use Text::Tabs;
|
||||
|
||||
while (<>) {
|
||||
print unexpand $_;
|
||||
}
|
||||
|
||||
Instead of the shell's C<expand> command, use:
|
||||
|
||||
perl -MText::Tabs -n -e 'print expand $_'
|
||||
|
||||
Instead of the shell's C<unexpand -a> command, use:
|
||||
|
||||
perl -MText::Tabs -n -e 'print unexpand $_'
|
||||
|
||||
=head1 BUGS
|
||||
|
||||
Text::Tabs handles only tabs (C<"\t">) and combining characters (C</\pM/>). It doesn't
|
||||
count backwards for backspaces (C<"\t">), omit other non-printing control characters (C</\pC/>),
|
||||
or otherwise deal with any other zero-, half-, and full-width characters.
|
||||
|
||||
=head1 LICENSE
|
||||
|
||||
Copyright (C) 1996-2002,2005,2006 David Muir Sharnoff.
|
||||
Copyright (C) 2005 Aristotle Pagaltzis
|
||||
Copyright (C) 2012-2013 Google, Inc.
|
||||
This module may be modified, used, copied, and redistributed at your own risk.
|
||||
Although allowed by the preceding license, please do not publicly
|
||||
redistribute modified versions of this code with the name "Text::Tabs"
|
||||
unless it passes the unmodified Text::Tabs test suite.
|
||||
279
Agent-Windows/OGP64/usr/share/perl5/5.40/Text/Wrap.pm
Normal file
279
Agent-Windows/OGP64/usr/share/perl5/5.40/Text/Wrap.pm
Normal file
|
|
@ -0,0 +1,279 @@
|
|||
use strict; use warnings;
|
||||
|
||||
package Text::Wrap;
|
||||
|
||||
use warnings::register;
|
||||
|
||||
BEGIN { require Exporter; *import = \&Exporter::import }
|
||||
|
||||
our @EXPORT = qw( wrap fill );
|
||||
our @EXPORT_OK = qw( $columns $break $huge );
|
||||
|
||||
our $VERSION = '2024.001';
|
||||
our $SUBVERSION = 'modern'; # back-compat vestige
|
||||
|
||||
BEGIN { eval sprintf 'sub REGEXPS_USE_BYTES () { %d }', scalar( pack('U*', 0x80) =~ /\xc2/ ) }
|
||||
|
||||
my $brkspc = "\x{a0}\x{202f}" =~ /\s/ ? '[^\x{a0}\x{202f}\S]' : '\s';
|
||||
|
||||
our $columns = 76; # <= screen width
|
||||
our $break = '(?>\n|\r\n|'.$brkspc.'\pM*)';
|
||||
our $huge = 'wrap'; # alternatively: 'die' or 'overflow'
|
||||
our $unexpand = 1;
|
||||
our $tabstop = 8;
|
||||
our $separator = "\n";
|
||||
our $separator2 = undef;
|
||||
|
||||
sub _xlen { $_[0] =~ /^\pM/ + ( () = $_[0] =~ /\PM/g ) }
|
||||
|
||||
use Text::Tabs qw(expand unexpand);
|
||||
|
||||
sub wrap
|
||||
{
|
||||
my ($ip, $xp, @t) = map +( defined $_ ? $_ : '' ), @_;
|
||||
|
||||
local($Text::Tabs::tabstop) = $tabstop;
|
||||
my $r = "";
|
||||
my $tail = pop(@t);
|
||||
my $t = expand(join("", (map { /\s+\z/ ? ( $_ ) : ($_, ' ') } @t), $tail));
|
||||
my $lead = $ip;
|
||||
my $nll = $columns - _xlen(expand($xp)) - 1;
|
||||
if ($nll <= 0 && $xp ne '') {
|
||||
my $nc = _xlen(expand($xp)) + 2;
|
||||
warnings::warnif "Increasing \$Text::Wrap::columns from $columns to $nc to accommodate length of subsequent tab";
|
||||
$columns = $nc;
|
||||
$nll = 1;
|
||||
}
|
||||
my $ll = $columns - _xlen(expand($ip)) - 1;
|
||||
$ll = 0 if $ll < 0;
|
||||
my $nl = "";
|
||||
my $remainder = "";
|
||||
|
||||
use re 'taint';
|
||||
|
||||
pos($t) = 0;
|
||||
while ($t !~ /\G(?:$break)*\Z/gc) {
|
||||
if ($t =~ /\G((?>(?!\n)\PM\pM*|(?<![^\n])\pM+){0,$ll})($break|\n+|\z)/xmgc) {
|
||||
$r .= $unexpand
|
||||
? unexpand($nl . $lead . $1)
|
||||
: $nl . $lead . $1;
|
||||
$remainder = $2;
|
||||
} elsif ($huge eq 'wrap' && $t =~ /\G((?>(?!\n)\PM\pM*|(?<![^\n])\pM+){$ll})/gc) {
|
||||
$r .= $unexpand
|
||||
? unexpand($nl . $lead . $1)
|
||||
: $nl . $lead . $1;
|
||||
$remainder = defined($separator2) ? $separator2 : $separator;
|
||||
} elsif ($huge eq 'overflow' && $t =~ /\G([^\n]*?)(?!(?<![^\n])\pM)($break|\n+|\z)/xmgc) {
|
||||
$r .= $unexpand
|
||||
? unexpand($nl . $lead . $1)
|
||||
: $nl . $lead . $1;
|
||||
$remainder = $2;
|
||||
} elsif ($huge eq 'die') {
|
||||
die "couldn't wrap '$t'";
|
||||
} elsif ($columns < 2) {
|
||||
warnings::warnif "Increasing \$Text::Wrap::columns from $columns to 2";
|
||||
$columns = 2;
|
||||
return @_;
|
||||
} else {
|
||||
die "This shouldn't happen";
|
||||
}
|
||||
|
||||
$lead = $xp;
|
||||
$ll = $nll;
|
||||
$nl = defined($separator2)
|
||||
? ($remainder eq "\n"
|
||||
? "\n"
|
||||
: $separator2)
|
||||
: $separator;
|
||||
}
|
||||
$r .= $remainder;
|
||||
|
||||
$r .= $lead . substr($t, pos($t), length($t) - pos($t))
|
||||
if pos($t) ne length($t);
|
||||
|
||||
# the 5.6 regexp engine ignores the UTF8 flag, so using capture buffers acts as an implicit _utf8_off
|
||||
# that means on 5.6 we now have to manually set UTF8=on on the output if the input had it, for which
|
||||
# we extract just the UTF8 flag from the input and check if it forces chr(0x80) to become multibyte
|
||||
return REGEXPS_USE_BYTES && (substr($t,0,0)."\x80") =~ /\xc2/ ? pack('U0a*', $r) : $r;
|
||||
}
|
||||
|
||||
sub fill
|
||||
{
|
||||
my ($ip, $xp, @raw) = map +( defined $_ ? $_ : '' ), @_;
|
||||
my @para;
|
||||
my $pp;
|
||||
|
||||
for $pp (split(/\n\s+/, join("\n",@raw))) {
|
||||
$pp =~ s/\s+/ /g;
|
||||
my $x = wrap($ip, $xp, $pp);
|
||||
push(@para, $x);
|
||||
}
|
||||
|
||||
# if paragraph_indent is the same as line_indent,
|
||||
# separate paragraphs with blank lines
|
||||
|
||||
my $ps = ($ip eq $xp) ? "\n\n" : "\n";
|
||||
return join ($ps, @para);
|
||||
}
|
||||
|
||||
1;
|
||||
|
||||
__END__
|
||||
|
||||
=head1 NAME
|
||||
|
||||
Text::Wrap - line wrapping to form simple paragraphs
|
||||
|
||||
=head1 SYNOPSIS
|
||||
|
||||
B<Example 1>
|
||||
|
||||
use Text::Wrap;
|
||||
|
||||
$initial_tab = "\t"; # Tab before first line
|
||||
$subsequent_tab = ""; # All other lines flush left
|
||||
|
||||
print wrap($initial_tab, $subsequent_tab, @text);
|
||||
print fill($initial_tab, $subsequent_tab, @text);
|
||||
|
||||
$lines = wrap($initial_tab, $subsequent_tab, @text);
|
||||
|
||||
@paragraphs = fill($initial_tab, $subsequent_tab, @text);
|
||||
|
||||
B<Example 2>
|
||||
|
||||
use Text::Wrap qw(wrap $columns $huge);
|
||||
|
||||
$columns = 132; # Wrap at 132 characters
|
||||
$huge = 'die';
|
||||
$huge = 'wrap';
|
||||
$huge = 'overflow';
|
||||
|
||||
B<Example 3>
|
||||
|
||||
use Text::Wrap;
|
||||
|
||||
$Text::Wrap::columns = 72;
|
||||
print wrap('', '', @text);
|
||||
|
||||
=head1 DESCRIPTION
|
||||
|
||||
C<Text::Wrap::wrap()> is a very simple paragraph formatter. It formats a
|
||||
single paragraph at a time by breaking lines at word boundaries.
|
||||
Indentation is controlled for the first line (C<$initial_tab>) and
|
||||
all subsequent lines (C<$subsequent_tab>) independently. Please note:
|
||||
C<$initial_tab> and C<$subsequent_tab> are the literal strings that will
|
||||
be used: it is unlikely you would want to pass in a number.
|
||||
|
||||
C<Text::Wrap::fill()> is a simple multi-paragraph formatter. It formats
|
||||
each paragraph separately and then joins them together when it's done. It
|
||||
will destroy any whitespace in the original text. It breaks text into
|
||||
paragraphs by looking for whitespace after a newline. In other respects,
|
||||
it acts like wrap().
|
||||
|
||||
C<wrap()> compresses trailing whitespace into one newline, and C<fill()>
|
||||
deletes all trailing whitespace.
|
||||
|
||||
Both C<wrap()> and C<fill()> return a single string.
|
||||
|
||||
Unlike the old Unix fmt(1) utility, this module correctly accounts for
|
||||
any Unicode combining characters (such as diacriticals) that may occur
|
||||
in each line for both expansion and unexpansion. These are overstrike
|
||||
characters that do not increment the logical position. Make sure
|
||||
you have the appropriate Unicode settings enabled.
|
||||
|
||||
=head1 OVERRIDES
|
||||
|
||||
C<Text::Wrap::wrap()> has a number of variables that control its behavior.
|
||||
Because other modules might be using C<Text::Wrap::wrap()> it is suggested
|
||||
that you leave these variables alone! If you can't do that, then
|
||||
use C<local($Text::Wrap::VARIABLE) = YOURVALUE> when you change the
|
||||
values so that the original value is restored. This C<local()> trick
|
||||
will not work if you import the variable into your own namespace.
|
||||
|
||||
Lines are wrapped at C<$Text::Wrap::columns> columns (default value: 76).
|
||||
C<$Text::Wrap::columns> should be set to the full width of your output
|
||||
device. In fact, every resulting line will have length of no more than
|
||||
C<$columns - 1>.
|
||||
|
||||
It is possible to control which characters terminate words by
|
||||
modifying C<$Text::Wrap::break>. Set this to a string such as
|
||||
C<'[\s:]'> (to break before spaces or colons) or a pre-compiled regexp
|
||||
such as C<qr/[\s']/> (to break before spaces or apostrophes). The
|
||||
default is simply C<'\s'>; that is, words are terminated by spaces.
|
||||
(This means, among other things, that trailing punctuation such as
|
||||
full stops or commas stay with the word they are "attached" to.)
|
||||
Setting C<$Text::Wrap::break> to a regular expression that doesn't
|
||||
eat any characters (perhaps just a forward look-ahead assertion) will
|
||||
cause warnings.
|
||||
|
||||
Beginner note: In example 2, above C<$columns> is imported into
|
||||
the local namespace, and set locally. In example 3,
|
||||
C<$Text::Wrap::columns> is set in its own namespace without importing it.
|
||||
|
||||
C<Text::Wrap::wrap()> starts its work by expanding all the tabs in its
|
||||
input into spaces. The last thing it does it to turn spaces back
|
||||
into tabs. If you do not want tabs in your results, set
|
||||
C<$Text::Wrap::unexpand> to a false value. Likewise if you do not
|
||||
want to use 8-character tabstops, set C<$Text::Wrap::tabstop> to
|
||||
the number of characters you do want for your tabstops.
|
||||
|
||||
If you want to separate your lines with something other than C<\n>
|
||||
then set C<$Text::Wrap::separator> to your preference. This replaces
|
||||
all newlines with C<$Text::Wrap::separator>. If you just want to
|
||||
preserve existing newlines but add new breaks with something else, set
|
||||
C<$Text::Wrap::separator2> instead.
|
||||
|
||||
When words that are longer than C<$columns> are encountered, they
|
||||
are broken up. C<wrap()> adds a C<"\n"> at column C<$columns>.
|
||||
This behavior can be overridden by setting C<$huge> to
|
||||
'die' or to 'overflow'. When set to 'die', large words will cause
|
||||
C<die()> to be called. When set to 'overflow', large words will be
|
||||
left intact.
|
||||
|
||||
Historical notes: 'die' used to be the default value of
|
||||
C<$huge>. Now, 'wrap' is the default value.
|
||||
|
||||
=head1 EXAMPLES
|
||||
|
||||
Code:
|
||||
|
||||
print wrap("\t","",<<END);
|
||||
This is a bit of text that forms
|
||||
a normal book-style indented paragraph
|
||||
END
|
||||
|
||||
Result:
|
||||
|
||||
" This is a bit of text that forms
|
||||
a normal book-style indented paragraph
|
||||
"
|
||||
|
||||
Code:
|
||||
|
||||
$Text::Wrap::columns=20;
|
||||
$Text::Wrap::separator="|";
|
||||
print wrap("","","This is a bit of text that forms a normal book-style paragraph");
|
||||
|
||||
Result:
|
||||
|
||||
"This is a bit of|text that forms a|normal book-style|paragraph"
|
||||
|
||||
=head1 SEE ALSO
|
||||
|
||||
For correct handling of East Asian half- and full-width characters,
|
||||
see L<Text::WrapI18N>. For more detailed controls: L<Text::Format>.
|
||||
|
||||
=head1 AUTHOR
|
||||
|
||||
David Muir Sharnoff <cpan@dave.sharnoff.org> with help from Tim Pierce and
|
||||
many many others.
|
||||
|
||||
=head1 LICENSE
|
||||
|
||||
Copyright (C) 1996-2009 David Muir Sharnoff.
|
||||
Copyright (C) 2012-2013 Google, Inc.
|
||||
This module may be modified, used, copied, and redistributed at your own risk.
|
||||
Although allowed by the preceding license, please do not publicly
|
||||
redistribute modified versions of this code with the name "Text::Wrap"
|
||||
unless it passes the unmodified Text::Wrap test suite.
|
||||
Loading…
Add table
Add a link
Reference in a new issue