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

Replace() retorna uma string depois de substituir todas as ocorrências de uma determinada subsequência dentro da string de entrada com outra subsequência. A função não é recursiva e funciona da esquerda para a direita.

Sintaxe:

Replace(text, from\_str, to\_str)

Tipo de dados de retorno: caractere

Argumentos

| Argumento | Descrição |
| --- | --- |
| text | A string original. |
| from\_str | Uma string que pode ocorrer uma ou mais vezes dentro da string de entrada text. |
| to\_str | A string que substituirá todas as ocorrências de from\_str dentro da string text. |

Exemplo: expressão de gráfico

| Exemplo | Resultado |
| --- | --- |
| `Replace( 'abccde','cc','xyz' )` | Retorna `abxyzde` |

## Exemplo - Fundamentos de Replace

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

#### Expressão de gráfico

Visão geral

Um conjunto de dados de nomes de clientes contém alguns erros de ortografia. Este exemplo usa a função `Replace` para processar e substituir qualquer ocorrência incorreta de "Jhon" por "John".

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:

  * `CustomerID`

  * `CustomerName`

Script de carregamento

```
Example:
Load * inline [
CustomerID, CustomerName
1, Jhon Smith
2, Jhon Doe
3, John Williams
4, Jhonathan Harris
];
```

Resultados

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

* ` CustomerID
                                       `

* `CustomerName`

Crie a seguinte dimensão calculada:

* `=Replace(CustomerName,'Jhon','John')` para substituir todas as instâncias de `Jhon` por `John`.

Tabela de resultados

| CustomerID | CustomerName | Replace(CustomerName,'Jhon','John') |
| --- | --- | --- |
| 1 | Jhon Smith | John Smith |
| 2 | Jhon Doe | John Doe |
| 3 | John Williams | John Williams |
| 4 | Jhonathan Harris | Johnathan Harris |

A saída da função `Repeat` encontra e corrige todas as instâncias de `Jhon` com `John`.

## Exemplo - Cenário de Replace

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

#### Expressão de gráfico

Visão geral

Um conjunto de dados de produtos usa rotulagem inconsistente para os códigos de categoria. Por exemplo, os produtos elétricos têm diversas variações de código, como `ELEC`, `ELC` e `elc`. Para padronizar os códigos, a função `Replace` é usada para corrigir todos os códigos de categoria inconsistentes para produtos elétricos e móveis.

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:

  * `ProductID`

  * `CategoryCode`

Script de carregamento

```
Example:
Load * inline [
ProductID, CategoryCode
1, ELEC
2, ELC
3, FURN
4, FRN
5, ELEC
6, ELC
7, elc
];
```

Resultados

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

* ` ProductID
                                       `

* `CategoryCode`

Crie a seguinte dimensão calculada:

* `=Replace(Replace(Upper(CategoryCode), 'ELC', 'ELEC'),'FRN', 'FURN')` para substituir todas as instâncias de `ELC` por `ELEC` e todas as instâncias de `FRN` por `FURN`.

Tabela de resultados

| ProductID | CategoryCode | Replace(Replace(Upper(CategoryCode), 'ELC', 'ELEC'),'FRN', 'FURN') |
| --- | --- | --- |
| 1 | ELEC | ELEC |
| 2 | ELC | ELEC |
| 3 | FURN | FURN |
| 4 | FRN | FURN |
| 5 | ELEC | ELEC |
| 6 | ELC | ELEC |
| 7 | elc | ELEC |

A saída da função `Replace` substituiu todas as instâncias de `ELC` por `ELEC` e de `FRN` por `FURN`. Observe que o código `elc` também foi substituído. Embora a função `Replace` diferencie maiúsculas de minúsculas, a fórmula da dimensão usa a função `Upper` para conformar a capitalização de todos os `CategoryCodes` antes de substituir a string. Isso efetivamente faz com que a substituição da string não diferencie maiúsculas e minúsculas.

## Saiba mais

* [Replace](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/Replace.htm)