How to Trim Whitespace From a String in Swift

Why this happens

Developers coming from JavaScript, Python, or Java often expect " abc ".trim() to work out of the box in Swift. Calling .trim() on a String without defining it first produces the compiler error Value of type 'String' has no member 'trim'.

Swift’s standard library keeps the core String API minimal and delegates locale-aware and character-set operations to Foundation. In Apple’s frameworks, trimming is bridged from NSString through the trimmingCharacters(in:) method, which accepts a CharacterSet describing which characters to remove from both ends of the string.

Because trimmingCharacters(in:) is a non-mutating method, it returns a new String and leaves the original value untouched. It also only removes matching characters from the start and end of the string, preserving any spaces or line breaks in the middle.

How to fix it

1. Use Foundation’s trimmingCharacters(in:)

For almost all iOS, macOS, watchOS, and visionOS projects, the simplest solution is to import Foundation and call trimmingCharacters(in:).

Use .whitespacesAndNewlines when you want to remove spaces, tabs (\t), and line breaks (\n, \r) from both ends of a string:

import Foundation

let rawInput = "  \t\t  Let's trim all the whitespace  \n \t  \n  "
let trimmed = rawInput.trimmingCharacters(in: .whitespacesAndNewlines)
// Result: "Let's trim all the whitespace"

If you want to keep trailing or leading newlines intact and only remove horizontal whitespace such as spaces and tabs, pass .whitespaces instead:

import Foundation

let line = "   Hello World   \n"
let spacesOnly = line.trimmingCharacters(in: .whitespaces)
// Result: "Hello World   \n"

You can also pass a custom CharacterSet if you need to strip specific symbols, punctuation, or characters from the edges of a string:

import Foundation

let path = "///users/profile///"
let cleanPath = path.trimmingCharacters(in: CharacterSet(charactersIn: "/"))
// Result: "users/profile"

Keep in mind that trimmingCharacters(in:) does not modify the string in place. If you are cleaning up a var property, assign the result back to the variable.

2. Add a reusable String extension

If you trim strings frequently—for example, when validating TextField input in SwiftUI or parsing form fields—writing .trimmingCharacters(in: .whitespacesAndNewlines) repeatedly adds noise. You can wrap it in a String extension in a shared utilities file.

Following Swift’s API Design Guidelines, use a past-participle or noun-like name (trimmed()) for the method that returns a new string, and a verb (trim()) for the mutating version that modifies the string in place:

import Foundation

extension String {
    func trimmed() -> String {
        trimmingCharacters(in: .whitespacesAndNewlines)
    }

    mutating func trim() {
        self = trimmed()
    }
}

You can then use either style depending on whether you need a new constant or an in-place update:

let username = "  alex  \n".trimmed()
// username == "alex"

var bio = "  iOS Developer  "
bio.trim()
// bio == "iOS Developer"

If your team prefers a shorter call site and only needs the non-mutating behavior, you can name the non-mutating method trim() instead—just avoid mixing both conventions in the same codebase so callers know whether the value is mutated.

3. Trim without importing Foundation (pure Swift)

If you are writing a lightweight Swift package, a command-line tool, or server-side Swift code where you want to avoid importing Foundation, you can trim whitespace using Swift’s standard library Character.isWhitespace property.

extension String {
    func trimmedPureSwift() -> String {
        guard let first = firstIndex(where: { !$0.isWhitespace }),
              let last = lastIndex(where: { !$0.isWhitespace }) else {
            return ""
        }
        return String(self[first...last])
    }
}

let result = " \t Swift 6 \n ".trimmedPureSwift()
// result == "Swift 6"

In the Swift standard library, Character.isWhitespace follows the Unicode White_Space property, which matches standard spaces, tabs, non-breaking spaces, and newline characters. By finding the first and last non-whitespace indices, this approach slices the string once and avoids allocating intermediate arrays.

If you only want to strip spaces and tabs without removing newlines in pure Swift, check { !$0.isWhitespace || $0.isNewline } inside firstIndex(where:) and lastIndex(where:).

How to prevent it

• Sanitize user input at the boundary: Trim TextField and UITextField values right before validation, database writes, or network requests so accidental trailing spaces do not cause login or search mismatches.
• Default to .whitespacesAndNewlines: Use .whitespacesAndNewlines instead of .whitespaces for user-entered text, since pasted content often includes trailing newline characters.
• Check for empty strings after trimming: A string containing only spaces (" ") has isEmpty == false. Always call .trimmingCharacters(in: .whitespacesAndNewlines).isEmpty when checking whether a required field is blank.
• Follow Swift naming conventions in extensions: Pair trimmed() (non-mutating) with mutating func trim() so other developers on your project immediately know whether a call modifies the variable.

FAQ

Does trimmingCharacters(in:) remove spaces in the middle of a string?

No. trimmingCharacters(in:) only strips matching characters from the beginning and end of the string. If you want to remove all spaces throughout a string, use replacingOccurrences(of: " ", with: "") or filter characters directly.

What is the difference between .whitespaces and .whitespacesAndNewlines?

CharacterSet.whitespaces matches horizontal whitespace such as spaces and tabs (\t), while CharacterSet.whitespacesAndNewlines also includes line breaks (\n, \r, and Unicode line separators). For most form inputs and pasted text, .whitespacesAndNewlines is the safer choice.

Does trimmingCharacters(in:) modify the original String?

No. String is a value type in Swift, and trimmingCharacters(in:) returns a new String without changing the original instance. To update an existing variable, assign the return value back to it or define a mutating extension method.