String::Trim - trim whitespace from your strings
Contents
Availability
The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit
<http://www.perl.com/CPAN/> to find a CPAN site near you, or see
<http://search.cpan.org/dist/String-Trim/>.
The development version lives at <http://github.com/doherty/String-Trim> and may be cloned from
<git://github.com/doherty/String-Trim.git>. Instead of sending patches, please fork this project using
the standard git and github infrastructure.
Bugs And Limitations
No bugs have been reported.
Please report any bugs or feature requests through the web interface at
<https://github.com/doherty/String-Trim/issues>.
Copyright And License
This software is copyright (c) 2010 by Mike Doherty.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5
programming language system itself.
perl v5.36.0 2022-11-20 String::Trim(3pm)
Credits
This module was inspired by code at <http://www.perlmonks.org/?node_id=36684> written by japhy (Jeff
Pinyan), dragonchild, and Aristotle. This Perl module was written by Mike Doherty.
Description
"String::Trim" trims whitespace off your strings. chomp trims only $/ (typically, that's newline), but
"trim" will trim all leading and trailing whitespace.
Functions
trim
Returns the string with all leading and trailing whitespace removed. Trimming undef gives you undef.
Alternatively, you can trim in-place.
my $var = ' my string ';
my $trimmed = trim($var);
# OR
trim($var);
"trim" also knows how to trim an array or arrayref:
my @to_trim = (' one ', ' two ', ' three ');
my @trimmed = trim(@to_trim);
# OR
trim(@to_trim);
# OR
my $trimmed = trim(\@to_trim);
# OR
trim(\@to_trim);
Name
String::Trim - trim whitespace from your strings
Rationale
"trim" is often used by beginners, who may not understand how to spin their own. While String::Util does
have a "trim" function, it depends on Debug::ShowStuff, which depends on Taint, which fails the test
suite, and doesn't appear to be maintained. This module installs, is actively maintained, and has no
non-core dependencies.
Other options include Text::Trim and String::Strip (which is implemented in XS, and is therefore likely
to be very fast, but requires a C compiler).
Source
The development version is on github at <http://github.com/doherty/String-Trim> and may be cloned from
<git://github.com/doherty/String-Trim.git>
Synopsis
use String::Trim;
print "Do it? ";
trim(my $response = <>);
print "'$response'\n";
Version
version 0.005
