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

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

Sintaxe:

LTrim(text)

Tipo de dados de retorno: caractere

Argumentos

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

Exemplo: expressões de gráfico

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

## Exemplo - Fundamentos de LTrim

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/LTrim.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 ` LTrim  `. Consulte [Verbatim](https://help.qlik.com/pt-BR/cloud-services/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:

* `=LTrim(InputText)` para remover os espaços iniciais de `InputText`.

Tabela de resultados

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

A saída da função `LTrim` removeu todos os espaços à esquerda do texto original, mas manteve todos os espaços à direita.

## Exemplo - Cenário de LTrim

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/LTrim.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 ` LTrim  `. Consulte [Verbatim](https://help.qlik.com/pt-BR/cloud-services/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:

* `=LTrim(CustomerName)` para remover quaisquer espaços à esquerda de `CustomerName`.

Tabela de resultados

| CustomerName | LTrim(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 `LTrim` removeu todos os espaços à esquerda dos valores originais da string em `CustomerName`.

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

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

#### Expressão de gráfico

Visão geral

Este exemplo remove todos os espaços à 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 `LTrim`.

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 `LTrim`. Consulte [Verbatim](https://help.qlik.com/pt-BR/cloud-services/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:

* `=LTrim(String)`, para remover quaisquer espaços extras à esquerda.

Crie as seguintes medidas:

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

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

Tabela de resultados

| String | LTrim(String) | Len(String) | Len(LTrim(String)) |
| --- | --- | --- | --- |
| ​' abc ' | 'abc ' | 10 | 7 |
| ' def ' | 'def ' | 6 | 5 |

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

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/LTrim.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(LtrimString) as LtrimStringLength;      
Load *,
ltrim(String) as LtrimString;
Load *,
len(String) as StringLength;               
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 ltrim. Consulte [Verbatim](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemVariables/Verbatim.htm) para obter mais informações.

Tabela de resultados

| String | StringLength | LtrimString | LtrimStringLength |
| --- | --- | --- | --- |
| abc | 10 | abc | 7 |
| def | 6 | def | 5 |

## Saiba mais

* [RTrim Função de script e de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/RTrim.htm)