---
name: "String::Trim::More"
section: "3pm"
platform: "linux"
package: "libstring-trim-more-perl"
version: "0.03-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/String::Trim::More"
---

# String::Trim::More(3pm)

Various string trimming utilities

## NAME

String::Trim::More - Various string trimming utilities

## VERSION

This document describes version 0.03 of String::Trim::More (from Perl distribution String-Trim-More), released on 2017-01-27.

## DESCRIPTION

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.

## FUNCTIONS

### ltrim($str) =\> STR

Trim whitespaces (including newlines) at the beginning of string. Equivalent to:

```
 $str =~ s/\A\s+//s;
```

### ltrim\_lines($str) =\> STR

Trim whitespaces (not including newlines) at the beginning of each line of string. Equivalent to:

```
 $str =~ s/^\s+//mg;
```

### rtrim($str) =\> STR

Trim whitespaces (including newlines) at the end of string. Equivalent to:

```
 $str =~ s/[ \t]+\z//s;
```

### rtrim\_lines($str) =\> STR

Trim whitespaces (not including newlines) at the end of each line of string. Equivalent to:

```
 $str =~ s/[ \t]+$//mg;
```

### trim($str) =\> STR

ltrim + rtrim.

### trim\_lines($str) =\> STR

ltrim\_lines + rtrim\_lines.

### trim\_blank\_lines($str) =\> STR

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.

### ellipsis($str\[, $maxlen, $ellipsis\]) =\> STR

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.

## HOMEPAGE

Please visit the project's homepage at \<https://metacpan.org/release/String-Trim-More\>.

## SOURCE

Source repository is at \<https://github.com/perlancar/perl-String-Trim-More\>.

## BUGS

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.

## SEE ALSO

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).

## AUTHOR

perlancar \<perlancar@cpan.org\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2017 by perlancar@cpan.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.