String::Trim(3pm) User Contributed Perl Documentation String::Trim(3pm)

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.

2022-11-20 perl v5.36.0