# PurgeChar - Função de script e de gráfico

PurgeChar() retorna uma string contendo todos os caracteres na string de entrada ('text'), exceto para qualquer caractere presente no segundo argumento ('remove\_chars').

Sintaxe:

PurgeChar(text, remove\_chars)

Tipo de dados de retorno: caractere

Argumentos

| Argumento | Descrição |
| --- | --- |
| text | A string original. |
| remove\_chars | Uma string contendo os caracteres no text a ser removido. |

Exemplo: expressões de gráfico

| Exemplo | Resultado |
| --- | --- |
| `PurgeChar( 'a1b2c3','123' )` | Retorna `abc` |
| `PurgeChar( 'a1b2c3','1234' )` | Retorna `abc` |
| `PurgeChar( 'a1b22c3','1234' )` | Retorna `abc` |
| `PurgeChar( 'a1b2c3','312' )` | Retorna `abc` |
| `PurgeChar ( 'a1b2c3','Abc' )` | Retorna `a123` |

## Exemplo - Fundamentos de PurgeChar

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/PurgeChar.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`.

* Os campos a seguir na tabela de dados:

  * `InputText`

  * `CharsToPurge`

Script de carregamento

```
Example:
Load * inline [
InputText, CharsToPurge
'a1b2c3', '123'
'a^b^c', '^'
'A^b^c', 'A^'
];
```

Resultados

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

* ` InputText
                                   `

* `CharsToPurge`

Crie a seguinte dimensão calculada:

* `=PurgeChar(InputText,CharsToPurge)` para calcular os caracteres em `InputText` que correspondam aos caracteres em `CharsToPurge` e retornar apenas os caracteres que não correspondem.

Results table

| InputText | CharsToPurge | PurgeChar(InputText,CharsToPurge) |
| --- | --- | --- |
| A^b^c | A^ | bc |
| a^b^c | ^ | abc |
| a1b2c3 | 123 | abc |

A saída da função `PurgeChar` retorna apenas os caracteres de `InputText` que não correspondem aos caracteres de `CharsToPurge`. Por exemplo, a primeira linha retorna `bc` e remove os outros caracteres.

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

#### Script de carregamento

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

```
Example:
Load
*, 
purgechar(String1, String2) as PurgeChar;
Load * inline [
String1, String2
'a1b2c3', '123'
];
```

Tabela de resultados

| String1 | String2 | PurgeChar |
| --- | --- | --- |
| a1b2c3 | 123 | abc |

## Exemplo - Cenário de PurgeChar

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

#### Expressão de gráfico

Visão geral

Um conjunto de dados contém nomes de clientes e números de telefone. Este exemplo analisa as strings de números de telefone para reter apenas caracteres numéricos e descartar todos os outros caracteres, como parênteses, traços, pontos, sinais de adição e espaços.

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:

  * `CustomerName`

  * `PhoneNumber`

Script de carregamento

```
Example:
Load * inline [
CustomerName, PhoneNumber
John Doe, (123) 456-7890
Jane Smith, 123-456-7890
Bob Johnson, 123.456.7890
Alice Brown, +1 (123) 456 7890
];
```

Resultados

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

* ` CustomerName
                                   `

* `PhoneNumber`

Crie a seguinte dimensão calculada:

* `=PurgeChar(PhoneNumber, '()- .+ ')` para extrair os caracteres não numéricos do campo `PhoneNumber` e retornar apenas caracteres numéricos.

Results table

| CustomerName | PhoneNumber | PurgeChar(PhoneNumber,'()-.+ ') |
| --- | --- | --- |
| Alice Brown | +1 (123) 456 7890 | 11234567890 |
| Bob Johnson | 123.456.7890 | 1234567890 |
| Jane Smith | 123-456-7890 | 1234567890 |
| John Doe | (123) 456-7890 | 1234567890 |

A saída da função `PurgeChar` removeu com sucesso todos os caracteres não numéricos da string `PhoneNumber` e retornou apenas números.

## Saiba mais

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