# TextFunção de script e de gráfico

Text() força o tratamento da expressão como texto, mesmo que seja possível uma interpretação numérica.

Sintaxe:

Text (expr)

Tipo de dados de retorno: caractere

Argumentos

| Argumento | Descrição |
| --- | --- |
| expr | Uma expressão a ser tratada como texto. |

Exemplo: expressões de gráfico

| Exemplo | Resultados |
| --- | --- |
| `Text( 1234 )` | Retorna `1234` como uma string. Não há valor numérico. |
| `Text( pi( ) )` | Retorna `3.1415926535898` como uma string. Não há valor numérico. |

## Exemplo – Fundamentos de Text

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

#### Script de carregamento

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`.

* Os campos a seguir na tabela de dados:

  * `ID`

  * `PostalCode`

* Um carregamento anterior que usa a função `Text` para criar um novo campo chamado `PostalCode_Text` para garantir que os códigos postais permaneçam como texto e não sejam convertidos em números.

Script de carregamento

```
Example:
LOAD
ID,
PostalCode,
Text(PostalCode) AS PostalCode_Text;
LOAD * INLINE [
ID, PostalCode
1, 12345
2, 54321
3, 67890
4, 11223
5, 33445
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* `ID`

* `PostalCode`

* `PostalCode_Text`

Results table

Results table

| ID | PostalCode | PostalCode\_Text |
| --- | --- | --- |
| 1 | 12345 | 12345 |
| 2 | 54321 | 54321 |
| 3 | 67890 | 67890 |
| 4 | 11223 | 11223 |
| 5 | 33445 | 33445 |

A saída do carregamento anterior usa a função `Text` para garantir que todos os valores numéricos sejam tratados como texto. Você pode ver que os valores na coluna `PostalCode_Text` são processados como texto e aparecem alinhados à esquerda por padrão, enquanto os valores na coluna `PostalCode` são números e aparecem alinhados à direita por padrão.

## Exemplo - Cenário de Text

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

#### Script de carregamento

Visão geral

Um conjunto de dados contém dados de faturas de clientes que são inseridos como valores numéricos, mas você deseja manter esses valores como texto.

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`.

* Os campos a seguir na tabela de dados:

  * `InvoiceNumber`

  * `CustomerName`

* Um carregamento anterior que usa a função `Text` para criar um novo campo nomeado `InvoiceNumber_Text` para garantir que os números da fatura sejam tratados como texto.

Script de carregamento

```
Example:
LOAD
InvoiceNumber,
CustomerName,
Text(InvoiceNumber) AS InvoiceNumber_Text;
LOAD * INLINE [
InvoiceNumber, CustomerName
10001, John Doe
10002, Jane Smith
10003, Bob Johnson
10004, Alice Brown
10005, Michael Green
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* `InvoiceNumber`

* `CustomerName`

* `InvoiceNumber_Text`

Results table

Results table

| InvoiceNumber | CustomerName | InvoiceNumber\_Text |
| --- | --- | --- |
| 10001 | John Doe | 10001 |
| 10002 | Jane Smith | 10002 |
| 10003 | Bob Johnson | 10003 |
| 10004 | Alice Brown | 10004 |
| 10005 | Michael Green | 10005 |

Os resultados mostram que os valores numéricos na coluna `InvoiceNumber` agora foram convertidos em valores de texto na coluna `InvoiceNumber_Text` e aparecem alinhados à esquerda.