String::Trim::More - Various string trimming utilities
This document describes version 0.03 of String::Trim::More (from Perl distribution String-Trim-More), released on 2017-01-27.
This is an alternative to String::Trim (and similar modules, see "SEE ALSO"). Instead of a single trim function, this module provides several from which you can choose on, depending on your needs.
Trim whitespaces (including newlines) at the beginning of string. Equivalent to:
$str =~ s/\A\s+//s;
Trim whitespaces (not including newlines) at the beginning of each line of string. Equivalent to:
$str =~ s/^\s+//mg;
Trim whitespaces (including newlines) at the end of string. Equivalent to:
$str =~ s/[ \t]+\z//s;
Trim whitespaces (not including newlines) at the end of each line of string. Equivalent to:
$str =~ s/[ \t]+$//mg;
ltrim + rtrim.
ltrim_lines + rtrim_lines.
Trim blank lines at the beginning and the end. Won't trim blank lines in the middle. Blank lines include lines with only whitespaces in them.
Return $str unmodified if $str's length is less than $maxlen (default 80). Otherwise cut $str to ($maxlen - length($ellipsis)) and append $ellipsis (default '...') at the end.
Please visit the project's homepage at https://metacpan.org/release/String-Trim-More.
Source repository is at https://github.com/perlancar/perl-String-Trim-More.
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=String-Trim-More
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
For trim functions: String::Trim, Text::Trim, String::Strip, String::Util.
For ellipsis/eliding: Text::Elide (elide at word boundaries), String::Elide::Parts (elide with more options).
This software is copyright (c) 2017 by firstname.lastname@example.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install String::Trim::More, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell
For more information on module installation, please visit the detailed CPAN module installation guide.