# Funções de strings

## Adicionar preenchimento

Adiciona uma ou mais ocorrências de um caractere no início ou no final do conteúdo das células.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Repetir contagem | Número de vezes que o caractere escolhido será adicionado ao conteúdo da célula. |
| Adicionar caractere | Digite o caractere que você deseja adicionar ao conteúdo da célula como preenchimento. |
| Posição | Selecione onde deseja adicionar o caractere de preenchimento.<br><br><ul> <li> <p>Esquerda: o caractere escolhido será adicionado antes do conteúdo das células.</p> </li> <li> <p>Direita: o caractere escolhido será adicionado após o conteúdo das células.</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| TableRecipe | <ul> <li> <p>Contagem de repetições: 5</p> </li> <li> <p>Adicionar caractere 1</p> </li> <li> <p>Posição: Esquerda</p> </li> </ul> | 11111TableRecipe |

## Calcular comprimento

Calcula o número de caracteres de cada célula da coluna e gera o resultado em uma nova coluna.

Uma nova coluna contendo o resultado da função será criada para cada uma das colunas selecionadas. O nome padrão das novas colunas será `<original_column_name>_length`.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |

### Exemplo

| Entrada | Saída |
| --- | --- |
| TableRecipe | 11 |

## Alterar para minúsculas

Converte todo o texto das células da coluna para letras minúsculas.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Saída |
| --- | --- |
| Receita de tabela | receita de tabela |

## Alterar para caixa de título

Converte todo o texto das células da coluna para maiúsculas e minúsculas.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Saída |
| --- | --- |
| receita de tabela | Receita de tabela |

## Alterar para maiúsculas

Converte todo o texto das células da coluna para letras maiúsculas.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Saída |
| --- | --- |
| Receita de tabela | RECEITA DE TABELA |

## Concatenar colunas

Mescla o conteúdo de uma coluna com outra ou com um valor fixo..

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Prefixo | Opcionalmente, adicione um caractere ou uma string no início dos dados mesclados. |
| Usar com | <ul> <li> <p><span>Valor</span>: selecione esta opção para concatenar o conteúdo da coluna com um valor fixo, definido no campo <span>Valor</span>.</p> </li> <li> <p><span>Outra coluna</span>: selecione esta opção para concatenar o conteúdo da coluna com o conteúdo de outra coluna, definido na lista suspensa <span>Coluna</span>.</p> </li> </ul> |
| Separador | Insira qualquer caractere para atuar como separador dos dados mesclados. |
| Adicionar separador | Selecione a condição na qual o separador será aplicado. |
| Sufixo | Opcionalmente, adicione um caractere ou uma string no final dos dados mesclados. |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| <ul> <li> <p>Coluna A: Tabela</p> </li> <li> <p>Coluna B:&nbsp;Receita</p> </li> </ul> | <ul> <li> <p>Colunas para processar: A</p> </li> <li> <p>Prefixo: a</p> </li> <li> <p>Usar com: Outra coluna</p> </li> <li> <p>Coluna: B</p> </li> <li> <p>Separador: @</p> </li> <li> <p>Adicionar separador: Ambos os valores não estão vazios</p> </li> <li> <p>Sufixo: !</p> </li> </ul> | <ul> <li> <p>Coluna A: aTable@Recipe!</p> </li> <li> <p>Coluna B: Receita</p> </li> </ul> |
| <ul> <li> <p>Coluna A: Qlik</p> </li> <li> <p>Coluna B: Nuvem</p> </li> <li> <p>Coluna C: Análise</p> </li> </ul> | <ul> <li> <p>Colunas para processar: A, B</p> </li> <li> <p>Prefixo: #</p> </li> <li> <p>Usar com: Outra coluna</p> </li> <li> <p>Coluna: C</p> </li> <li> <p>Separador: +</p> </li> <li> <p>Adicionar separador: Ambos os valores não estão vazios</p> </li> <li> <p>Sufixo: !</p> </li> </ul> | <ul> <li> <p>Coluna A: #Qlik+Análise!</p> </li> <li> <p>Coluna&nbsp;B: #Nuvem+Análise!</p> </li> <li> <p>Coluna C: Análise</p> </li> </ul> |

## Contém texto

Verifica se as células contêm um valor específico. A função retornará TRUE se o texto selecionado for encontrado dentro da célula; caso contrário, retornará FALSE. Essa função diferencia maiúsculas de minúsculas.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Usar com | <ul> <li> <p><span>Valor</span>: selecione esta opção para verificar a coluna em relação a um valor fixo, definido no campo <span>Valor constante</span>.</p> </li> <li> <p><span>Coluna</span>: selecione esta opção para verificar a coluna em relação aos valores de outra coluna, definida na lista suspensa <span>Outra coluna</span>.</p> </li> </ul> |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| <ul> <li> <p>Receita de tabela</p> </li> <li> <p>Fluxo de dados</p> </li> </ul> | <ul> <li> <p>Usar com: Valor</p> </li> <li> <p>Valor constante: receita</p> </li> </ul> | <ul> <li> <p>TRUE</p> </li> <li> <p>FALSE</p> </li> </ul> |

## Converter em texto

Converte o tipo de strings contidas na coluna para que sejam interpretadas como texto no sistema.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

## Extrair um valor por índice

Extrai uma substring selecionada usando posições de índice para uma nova coluna.

Um índice representa um número de caracteres dos quais ou aos quais a seleção se aplica. O índice 0 corresponde ao primeiro caractere.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| De | Selecione como você deseja iniciar a seleção de valores:<br><br><ul> <li> <p><span>Desde o início</span> para usar o início da string como ponto de partida.</p> </li> <li> <p><span>Desde o índice</span> para especificar o número do caractere no qual a seleção será iniciada, definido no campo <span>Índice inicial</span> a seguir.</p> </li> <li> <p><span>Desde N antes do final</span> para especificar a quantos caracteres do fim da string você deve iniciar a seleção, definido no campo <span>Desde N antes do final</span> a seguir.</p> </li> </ul> |
| Até | Selecione como você deseja terminar a seleção de valores:<br><br><ul> <li> <p><span>Até o final</span> para usar o final da string como ponto final.</p> </li> <li> <p><span>Até o índice</span> para especificar o número do caractere no qual a seleção será terminada, definido no campo <span>Índice final</span> a seguir.</p> </li> <li> <p><span>Até N antes do final</span> para especificar a quantos caracteres do fim da string você deve terminar a seleção, definido no campo <span>Até N antes do final</span> a seguir.</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

## Fazer hash dos dados

Mascara as informações contidas em uma coluna. Os dados de entrada são substituídos usando uma versão de 256 bits do algoritmo Fowler-Noll-Vo.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Saída |
| --- | --- |
| Receita de tabela | G=HE!D)EV^\*H2%ZB-.(,I?.4+4J`Q%M]B&G_L5D0?2- |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| TableRecipe | <ul> <li> <p>De: Do começo</p> </li> <li> <p>Até: Até o índice</p> </li> <li> <p>Índice final: 5</p> </li> </ul> | Tabela |
| QlikCloudAnalytics | <ul> <li> <p>De: Do índice</p> </li> <li> <p>Índice inicial: 4</p> </li> <li> <p>Até: Até o índice</p> </li> <li> <p>Índice final: 9</p> </li> </ul> | Nuvem |

## Padrão de correspondência

Verifica se a célula é semelhante a um padrão específico. A função retornará TRUE se o padrão selecionado for encontrado dentro da célula; caso contrário, retornará FALSE.

Uma nova coluna contendo o resultado da função será criada para cada uma das colunas selecionadas. O nome padrão das novas colunas será `<original_column_name>_matches`.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Padrão | Selecione um dos padrões regex predefinidos ou outra combinação de operador e valor:<br><br><ul> <li> <p>[a-z]+ (uma palavra em minúscula)</p> </li> <li> <p>[A-Z]+ (uma palavra em maiúscula)</p> </li> <li> <p>[0-9]+ (número)</p> </li> <li> <p>[a-zA-Z]+ (uma palavra, sem distinção entre maiúsculas e minúsculas)</p> </li> <li> <p>[a-zA-Z0-9]+ (qualquer literal com caracteres alfanuméricos)</p> </li> <li> <p>Outro</p> </li> </ul> |
| Operador | Se você selecionou Outro como Padrão, poderá selecionar um dos operadores a seguir e definir seu valor personalizado no campo Valor a seguir:<br><br><ul> <li> <p>Igual</p> </li> <li> <p>Contém</p> </li> <li> <p>Começa com</p> </li> <li> <p>Termina com</p> </li> <li> <p>Regex</p> </li> </ul> |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| <ul> <li> <p>992424254-8</p> </li> <li> <p>ISBN 2-22605257-7</p> </li> </ul> | <ul> <li> <p>Padrão: Outro</p> </li> <li> <p>Operador: Regex</p> </li> <li> <p>^[ISBN]{4}[ ]{0,1}[0-9]{1}[-]{1}[0-9]{3}[-]{1}[0-9]{5}[-]{1}[0-9]{0,1}$</p> </li> </ul> | <ul> <li> <p>FALSE</p> </li> <li> <p>TRUE</p> </li> </ul> |
| <ul> <li> <p>Terminador</p> </li> <li> <p>Terminador&nbsp;2</p> </li> </ul> | <ul> <li> <p>Padrão: [a-zA-Z]+ (uma palavra, sem distinção entre maiúsculas e minúsculas)</p> </li> </ul> | <ul> <li> <p>TRUE</p> </li> <li> <p>FALSE</p> </li> </ul> |

## Corresponder texto semelhante

Verifica se a célula é semelhante a um valor específico. A função retornará TRUE se o texto selecionado for encontrado dentro da célula; caso contrário, retornará FALSE.

Uma nova coluna contendo o resultado da função será criada para cada uma das colunas selecionadas. O nome padrão das novas colunas será `<original_column_name>_matches`.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Usar com | <ul> <li> <p><span>Valor</span>: selecione esta opção para verificar a coluna em relação a um valor fixo, definido no campo <span>Referência</span>.</p> </li> <li> <p><span>Outra coluna</span>: selecione esta opção para verificar a coluna em relação aos valores de outra coluna, definida na lista suspensa <span>Coluna</span>.</p> </li> </ul> |
| Imprecisão | Defina um número que corresponda à distância de Levenshtein que você deseja usar para a verificação. A distância de Levenshtein representa o número de edições que você precisa fazer para transformar uma string em outra. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| <ul> <li> <p>Observação</p> </li> <li> <p>Remodelação</p> </li> </ul> | <ul> <li> <p>Usar com: Valor</p> </li> <li> <p>Referência: Refazer</p> </li> <li> <p>Imprecisão: 2</p> </li> </ul> | <ul> <li> <p>TRUE</p> </li> <li> <p>FALSE</p> </li> </ul> |

## Remover caracteres não alfanuméricos

Remove todos os caracteres que não sejam 0-9, Aa-Zz e letras acentuadas do conteúdo de uma célula. Os caracteres a seguir, bem como os espaços em branco, são mantidos: 1234567890abcdefghijklmnopqrstuvwxyzáàâäãåæçéèêëíìîïñóòôöõøœßúùûüABCDEFGHIJKLMNOPQRSTUVWXYZÁÀÂÄÃÅÆÇÉÈÊËÍÌÎÏÑÓÒÔÖÕØŒSSÚÙÛÜ.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Saída |
| --- | --- |
| Q=+L\*\*€IK#$ 12%3,4 | QLIK 1234 |

## Remover caracteres não numéricos

Remove todos os caracteres que não sejam de 0 a 9. Separadores decimais e espaços em branco também são mantidos.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Saída |
| --- | --- |
| Q=+L\*\*€IK#$12%3,4 | 123,4 |

## Remover parte do texto

Remove as strings especificadas das células da coluna.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Operador | Selecione o operador que será usado para fazer a correspondência com o texto a ser removido:<br><br><ul> <li> <p>Igual</p> </li> <li> <p>Contém</p> </li> <li> <p>Começa com</p> </li> <li> <p>Termina com</p> </li> </ul> |
| Valor | Digite o caractere ou a string a ser removida. |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| <ul> <li> <p>New York</p> </li> <li> <p>New york</p> </li> <li> <p>Yorkshire</p> </li> </ul> | <ul> <li> <p>Operador: Contém</p> </li> <li> <p>Valor: York </p> </li> </ul> | <ul> <li> <p>Novo</p> </li> <li> <p>New york</p> </li> <li> <p>shire</p> </li> </ul> |

## Remover caracteres iniciais e finais

Remove espaços à direita e à esquerda ou outros caracteres especificados.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Caractere de preenchimento | <ul> <li> <p>Espaço em branco: os espaços em branco desnecessários no início e no final das células serão removidos.</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Saída |
| --- | --- |
| [][]TableRecipe[] | TableRecipe |

## Pesquisar e substituir

Substitui células ou partes de células que contêm um valor específico por outro.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Operador | Selecione o operador que será usado para fazer a correspondência com o texto a ser pesquisado:<br><br><ul> <li> <p>Igual</p> </li> <li> <p>Contém</p> </li> <li> <p>Começa com</p> </li> <li> <p>Termina com</p> </li> <li> <p>Corresponde ao regex</p> </li> <li> <p>Corresponde ao curinga</p> </li> </ul> |
| Valor | Digite o caractere ou a string a ser pesquisada. |
| Substituir | Selecione o comportamento da ação de substituição:<br><br><ul> <li> <p>Correspondência de texto com valor de substituição</p> </li> <li> <p>Célula inteira com valor de substituição</p> </li> <li> <p>Célula inteira com nulo</p> </li> </ul> |
| Substituir por | Insira o valor com o qual deseja substituir as strings especificadas. |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

Nota de dicaComo alternativa, você pode iniciar uma operação de pesquisa e substituição em uma coluna clicando com o botão direito do mouse em uma célula da tabela e selecionando a opção Substituir este valor nesta coluna. Em seguida, é aberta uma etapa de receita em que a cadeia a ser substituída já está definida. Conclua a configuração da etapa e clique em Aplicar.

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| <ul> <li> <p>França</p> </li> <li> <p>Canadá</p> </li> <li> <p>Estados Unidos da América</p> </li> <li> <p>Estados Unidos</p> </li> </ul> | <ul> <li> <p>Operador: Contém</p> </li> <li> <p>Valor: América</p> </li> <li> <p>Substituir por: USA</p> </li> <li> <p>Sobrescrever célula inteira</p> </li> </ul> | <ul> <li> <p>França</p> </li> <li> <p>Canadá</p> </li> <li> <p>EUA</p> </li> <li> <p>Estados Unidos</p> </li> </ul> |

## Dividir coluna

Divide o conteúdo de uma célula em várias colunas, com base em um separador.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Partes | Digite o número de colunas que você deseja criar.<br><br>Se a string original contiver mais partes do que o especificado por você no campo Partes, a string restante será retornada na última coluna criada. |
| Separador | Na lista suspensa, selecione o caractere usado como base para a divisão:<br><br><ul> <li> <p>,</p> </li> <li> <p>:</p> </li> <li> <p>;</p> </li> <li> <p>.</p> </li> <li> <p>-</p> </li> <li> <p>@</p> </li> <li> <p>Espaço</p> </li> <li> <p>Outro (string). Ao usar essa opção, digite seu valor personalizado no campo <span>Separador personalizado</span>.</p> </li> </ul> |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| Coluna A: 12/07/1998 | <ul> <li> <p>Partes: 3</p> </li> <li> <p>Separador: outro (string)</p> </li> <li> <p>Separador de coluna: /</p> </li> </ul> | <ul> <li>Coluna A: 12/07/1998</li> <li> <p>Coluna B: 12</p> </li> <li> <p>Coluna C: 07</p> </li> <li> <p>Coluna D: 1998</p> </li> </ul> |
| Coluna A: 20-03-2025 | <ul> <li> <p>Partes: 2</p> </li> <li> <p>Separador: -</p> </li> </ul> | <ul> <li>Coluna A: 20-03-2025</li> <li> <p>Coluna B: 20</p> </li> <li> <p>Coluna C: 03-2025</p> </li> </ul> |