# Trim suffix from string

## Description

This operation removes a specified suffix from the end of a string. If the input string ends with the given suffix, it is removed; otherwise, the string is returned unchanged.

This operation is useful for cleaning up text by eliminating known trailing substrings, such as file extensions, fixed markers, or punctuation.

***

## Data types

These are the input/output expected data types for this operation:

### Input data

![](https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FExtApHuiMxiHgaNWDLb2%2Fimage.png?alt=media\&token=5f4e1372-a2db-4d7e-b81b-976507cac896) - Strings to be trimmed.

### Output data

![](https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FyeZGvHDhYqskHKW5bdnp%2Fimage.png?alt=media\&token=d72665aa-3d46-4572-a463-a62344ee7f88) - The resulting string after removing the specified suffix.

***

## Parameters

These are the parameters you need to configure to use this operation (mandatory parameters are marked with a <mark style="color:red;">**\***</mark>):

<details>

<summary>Suffix to trim<mark style="color:red;"><strong>*</strong></mark></summary>

The suffix to remove from the end of the input string. If the input string doesn't end with this suffix, the string remains unchanged.

</details>

***

## Example

Suppose you want to **trim** your input strings by removing a specific **suffix**:

1. In your Pipeline, open the required [Action](https://docs.onum.com/the-workspace/pipelines/actions) configuration and select the input **Field**.
2. In the **Operation** field, choose **Trim suffix from string**.
3. Set **Suffix to trim** to `.txt`.
4. Give your **Output field** a name and click **Save**. The input strings will be trimmed, removing the specified suffix.

For example:

{% code overflow="wrap" %}

```
"report_final.txt" -> "report_final"
```

{% endcode %}

{% hint style="info" %}
You can try out operations with specific values using the **Input** field above the operation. You can enter the value in the example above and check the result in the **Output** field.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onum.com/the-workspace/pipelines/actions/transformation/field-transformation/field-transformation-operations/utils/trim-suffix-from-string.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.