String::Trim - trim whitespace from your strings
version 0.005
use String::Trim;
print "Do it? ";
trim(my $response = <>);
print "'$response'\n";
String::Trim trims whitespace off your strings. chomp trims only $/ (typically, that's newline), but trim will trim all leading and trailing whitespace.
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);
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).
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.
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
No bugs have been reported.
Please report any bugs or feature requests through the web interface at https://github.com/doherty/String-Trim/issues.
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.
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.
