# Trim Função de script e de gráfico

Trim() retorna a string de entrada destituída de espaços à esquerda e à direita.

Sintaxe:

Trim(text)

Tipo de dados de retorno: caractere

Argumentos

| Argumento | Descrição |
| --- | --- |
| text | A string a ser avaliada. |

Exemplo: expressão de gráfico

| Exemplo | Resultado |
| --- | --- |
| `Trim( ' abc' )` | Retorna `abc` |
| `Trim( 'abc ' )` | Retorna `abc` |
| `Trim( ' abc ' )` | Retorna `abc` |

## Exemplo - Fundamentos de Trim

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Trim.htm)

#### Expressão de gráfico

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Um campo na tabela de dados chamado `InputText`.

Script de carregamento

```
Set verbatim=1;
Example:
Load * inline [
InputText
'   abc    '
' def  '];
```

Nota informativaA instrução "Set verbatim=1" está incluída no exemplo para garantir que os espaços não sejam aparados automaticamente antes da demonstração da função trim. Consulte [Verbatim](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemVariables/Verbatim.htm) para obter mais informações.

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

* ` InputText
                                   `

Crie a seguinte dimensão calculada:

* `=Trim(InputText)` para remover quaisquer espaços extras à esquerda ou à direita de `InputText`.

Tabela de resultados

| InputText | Trim(InputText) |
| --- | --- |
| ' abc ' | 'abc' |
| ' def ' | 'def' |

A saída da função `Trim` remove todos os espaços à esquerda e à direita.

## Exemplo - Cenário de Trim

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Trim.htm)

#### Expressão de gráfico

Visão geral

Um sistema de gerenciamento de relacionamento com o cliente (CRM) contém registros com entrada de dados inconsistente que incluem espaços extras à esquerda. Para fins de relatório, os dados precisam ser limpos para remover esses espaços e para garantir a classificação e o agrupamento adequados dos nomes dos clientes.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* 

  Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Um campo na tabela de dados chamado `CustomerName`.

Script de carregamento

```
Set verbatim=1;
Example:
Load * inline [
CustomerName
'  John Doe '
'Jane Smith '
'   Michael Johnson'
'Emily Davis'
];
```

Nota informativaA instrução "Set verbatim=1" está incluída no exemplo para garantir que os espaços não sejam aparados automaticamente antes da demonstração da função trim. Consulte [Verbatim](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemVariables/Verbatim.htm) para obter mais informações.

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

* ` CustomerName
                                   `

Crie a seguinte dimensão calculada:

* `=Trim(CustomerName)` para remover quaisquer espaços extras à esquerda ou à direita de `CustomerName`.

Tabela de resultados

| CustomerName | Trim(CustomerName) |
| --- | --- |
| ' Michael Johnson' | 'Michael Johnson' |
| ' John Doe ' | 'John Doe' |
| 'Emily Davis' | 'Emily Davis' |
| 'Jane Smith ' | 'Jane Smith' |

A saída mostra que a função `Trim` removeu todos os espaços à direita e à esquerda dos valores originais da string em `CustomerName`.

## Exemplo - Cenário avançado de Trim

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Trim.htm)

#### Expressão de gráfico

Visão geral

Este exemplo remove todos os espaços à direita e à esquerda da string de texto original. A expressão de gráfico inclui medidas que usam a função `Len` para contar os caracteres na string antes e depois de usar a função `Trim`.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Um campo na tabela de dados chamado `String`.

Script de carregamento

```
Set verbatim=1;
Example:
Load * inline [
String
'   abc    '
' def  '];
```

Nota informativaA instrução "Set verbatim=1" está incluída no exemplo para garantir que os espaços não sejam aparados automaticamente antes da demonstração da função trim. Consulte [Verbatim](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemVariables/Verbatim.htm) para obter mais informações.

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

* ` String
                                   `

Crie a seguinte dimensão calculada:

* `=Trim(String)`, para remover quaisquer espaços extras à esquerda ou à direita

Crie as seguintes medidas:

* `=Len(String)`, para contar o comprimento da string original

* `=Len(Trim(String))`, para contar o comprimento da string depois que os espaços forem removidos.

Tabela de resultados

| String | Trim(String) | Len(String) | Len(Trim(String)) |
| --- | --- | --- | --- |
| ​' abc ' | 'abc' | 10 | 3 |
| ​' def ' | 'def' | 6 | 3 |

Ao comparar a saída da função `Trim` com os valores originais da string no script, você pode ver como todos os espaços à direita e à esquerda foram removidos.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Trim.htm)

#### Script de carregamento

O código a seguir mostra como usar a função em um script de carregamento.

```
Set verbatim=1;
Example:
Load *, len(TrimString) as TrimStringLength;
Load *, trim(String) as TrimString;
Load *, len(String) as StringLength;
Load * inline [
String
'   abc    '
' def  '](delimiter is '\t');
```

Nota informativaA instrução "Set verbatim=1" está incluída no exemplo para garantir que os espaços não sejam aparados automaticamente antes da demonstração da função trim. Consulte [Verbatim](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemVariables/Verbatim.htm) para obter mais informações.

Tabela de resultados

| String | StringLength | TrimString | TrimStringLength |
| --- | --- | --- | --- |
| abc | 10 | abc | 3 |
| def | 6 | def | 3 |