---
name: "Strings.trim"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Strings.trim"
---

# Strings.trim(3kaya)

Trim selected characters from both ends of a String

## NAME

Strings::trim - Trim selected characters from both ends of a String

## SYNOPSIS

**Void trim(** *var String x, Bool(Char) fn=isSpace* **)**

## ARGUMENTS

**x** The string to trim

**fn** The trimming function. Returns true if characters should be trimmed, false otherwise. The default function is **Prelude.isSpace (3kaya)** which trims whitespace.

## DESCRIPTION

Remove characters in-place from both ends of a String as determined by the trimming function.

-

   str = "  this string needs trimming   ";\
    trim(str);\
    // str = "this string needs trimming";

## AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/

## LICENSE

The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.

## RELATED

**Strings.ltrim (3kaya)**

**Strings.rtrim (3kaya)**