# Funções de string Esta seção descreve as funções para lidar e manipular strings. Todas as funções podem ser usadas no script de carregamento de dados e em expressões do gráfico, com exceção de Evaluate, que só pode ser usada no script de carregamento de dados. Use a caixa suspensa em cada função para ver uma breve descrição e a sintaxe de cada função. Clique no nome da função na descrição da sintaxe para obter detalhes. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Capitalize A função do Capitalize() returns the string with all words in initial uppercase letters. converte o primeiro caractere de cada palavra em uma string de texto em maiúsculas e converte todos os outros caracteres em minúsculas. [**Capitalize**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Capitalize.htm)(text) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Chr Chr() retorna o caractere Unicode correspondente ao inteiro de entrada, também mostrado como um ponto de código. [**Chr**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Chr.htm)(int) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### CountRegEx CountRegEx() retorna o número de ocorrências do padrão de expressão regular especificado no texto da string de entrada. Se não houver uma correspondência, será retornado 0. [**CountRegEx**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/CountRegEx.htm)(text, regex) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Evaluate Evaluate() verifica se a string de texto de entrada pode ser avaliada com uma expressão Qlik Sense válida e, se puder, retorna o valor da expressão com uma string. Se a string de entrada não for uma expressão válida, NULL será retornado. [**Evaluate**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Evaluate.htm)(expression\_text) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### ExtractRegEx ExtractRegEx() extrai texto de uma expressão de string de entrada usando o padrão de expressão regular especificado. A função retorna um valor nulo se nenhuma correspondência for encontrada. [**ExtractRegEx**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/ExtractRegEx.htm)(text, regex [, field\_no]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### ExtractRegExGroup ExtractRegExGroup() extrai texto de uma expressão de string de entrada usando o padrão de expressão regular composta especificado. Ao usar a função, especifique o grupo a ser usado na regex composta. A função retorna um valor nulo se nenhuma correspondência for encontrada. [**ExtractRegExGroup**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/ExtractRegExGroup.htm)(text, regex, group [, field\_no]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### FindOneOf FindOneOf() busca uma string para localizar a posição da ocorrência de qualquer caractere a partir de um conjunto de caracteres fornecidos. A posição da enésima ocorrência de qualquer caractere do conjunto de pesquisa é retornada, em que N é o terceiro parâmetro opcional da função. Se nenhum terceiro parâmetro for fornecido, será retornada a primeira ocorrência. Se não for encontrada correspondência, será retornado 0. [**FindOneOf**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/FindOneOf.htm)(text, char\_set[, count]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Hash128 Hash128() retorna um valor de hash de 128 bits dos valores combinados de expressão de entrada. O resultado é uma string de 22 caracteres. [**Hash128**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Hash128.htm)(expr{, expression}) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Hash160 Hash160() retorna um valor de hash de 160 bits dos valores combinados de expressão de entrada. O resultado é uma string de 27 caracteres. [**Hash160**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Hash160.htm)(expr{, expression}) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Hash256 Hash256() retorna um valor de hash de 256 bits dos valores combinados de expressão de entrada. O resultado é uma string de 43 caracteres. [**Hash256**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Hash256.htm)(expr{, expression}) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Index Index() busca uma string para localizar a posição inicial da enésima ocorrência de uma subsequência fornecida. Um terceiro argumento opcional fornece o valor de n, que é 1 se for omitido. Um valor negativo busca a partir do final da string. As posições na string são numeradas da esquerda para a direita, de 1 para cima. [**Index**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Index.htm) (text, substring[, count]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### IndexRegEx IndexRegEx() pesquisa a string de entrada e retorna a posição inicial da enésima ocorrência do padrão de expressão regular especificado. Um terceiro argumento opcional count fornece o valor de n, que é 1 se for omitido. As posições na string são numeradas da esquerda para a direita, de 1 para cima. Se nenhuma correspondência for encontrada, a função retornará 0. [**IndexRegEx**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/IndexRegEx.htm)(text, regex [, count]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### IndexRegExGroup ExtractRegExGroup() extrai texto de uma expressão de string de entrada usando o padrão de expressão regular composta especificado. Ao usar a função, especifique o grupo a ser usado na regex composta. A função retorna um valor nulo se nenhuma correspondência for encontrada. [**IndexRegExGroup**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/IndexRegExGroup.htm)(text, regex, group [, count]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### IsJson IsJson() testa se uma string especificada contém dados JSON (JavaScript Object Notation) válidos. Você também pode validar um tipo de dados JSON específico. [**IsJson**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/IsJson.htm)(json [, type]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### IsRegEx IsRegEx() retorna se o texto especificado é uma expressão regular válida. [**IsRegEx**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/IsRegEx.htm)(expr [, debug) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### JsonGet JsonGet() retorna o caminho de uma string de dados JSON (JavaScript Object Notation). Os dados devem ser JSON válidos, mas podem conter espaços extras ou novas linhas. [**JsonGet**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/JsonGet.htm)(json, path) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### JsonSet JsonSet() modifica uma string contendo dados JSON (JavaScript Object Notation). Ele pode definir ou inserir um valor JSON com o novo local especificado pelo caminho. Os dados devem ser JSON válidos, mas podem conter espaços extras ou novas linhas. [**JsonSet**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/JsonSet.htm)(json, path, value) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### KeepChar KeepChar() retorna uma string que consiste em qualquer um dos caracteres da primeira string que correspondem aos caracteres da segunda string. Essa função diferencia maiúsculas de minúsculas. [**KeepChar**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/KeepChar.htm)(text, keep\_chars) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Left Left() retorna uma string que consiste nos primeiros caracteres (os mais à esquerda) da string de entrada, em que o número de caracteres é determinado pelo segundo argumento. [**Left**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Left.htm)(text, count) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Len Len() retorna o comprimento da cadeia de caracteres de entrada. [**Len**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Len.htm)(text) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### LevenshteinDist LevenShteInst() retorna a distância Levenshtein entre duas strings. Ela é definida como o número mínimo de edições de caractere único (inserções, exclusões ou substituições) necessárias para transformar uma string na outra. Essa função é útil para comparações de strings difusas. [**LevenshteinDist**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/LevenshteinDist.htm)(text1, text2) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Lower Lower() converte todos os caracteres na string de entrada em minúsculos. [**Lower**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Lower.htm)(text) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### LTrim LTrim() retorna a string de entrada destituída de espaços à esquerda. [**LTrim**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/LTrim.htm)(text) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### MatchRegEx MatchRegEx() compara uma string de entrada (text) com uma ou mais expressões regulares (regex). Retorna a localização numérica dos padrões de expressão regular que correspondem. Retorna uma resposta de correspondência somente se a avaliação da expressão regular corresponder a toda a entrada de texto. Se nenhuma correspondência for encontrada, a função retornará 0. [**MatchRegEx**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/MatchRegEx.htm)(text, regex1 [ , regex2,...regexN]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Mid Mid() retorna a parte da string iniciando na posição do caractere definido pelo segundo argumento, "start", com o comprimento da string definido pelo terceiro argumento, '"count". Se "count" for omitido, será retornado o restante da string de entrada. O primeiro caractere na string de entrada é o de número 1. [**Mid**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Mid.htm)(text, start[, count]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Ord Ord() retorna o valor numérico (ASCII ou Unicode) do primeiro caractere de uma string. Essa função é útil para avaliar ou comparar strings com base em seus códigos de caracteres subjacentes, por exemplo, ao classificar ou filtrar strings com caracteres não padrão. [**Ord**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Ord.htm)(text) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### PurgeChar PurgeChar() retorna uma string contendo todos os caracteres na string de entrada ('text'), exceto para qualquer caractere presente no segundo argumento ('remove\_chars'). [**PurgeChar**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/PurgeChar.htm)(text, remove\_chars) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Repeat Repeat() forma uma string que consiste em uma string de entrada, repetido o número de vezes definido pelo segundo argumento. [**Repeat**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Repeat.htm)(text[, repeat\_count]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Replace 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. [**Replace**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Replace.htm)(text, from\_str, to\_str) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### ReplaceRegEx ReplaceRegEx() retorna uma string após substituir uma ou mais correspondências entre uma string de entrada e um padrão de expressão regular especificado. O texto que substitui o texto correspondente é especificado no argumento to\_str. A função funciona da esquerda para a direita, mas, se você especificar um valor occurrence negativo, as funções serão lidas da direita para a esquerda. [**ReplaceRegEx**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/ReplaceRegEx.htm)(text, regex, to\_str [, occurrence]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### ReplaceRegExGroup ReplaceRegExGroup() retorna uma string após substituir uma ou mais correspondências entre uma string de entrada e o padrão de expressão regular composta especificado. O texto que substitui o texto correspondente é especificado no argumento to\_str. A função funciona da esquerda para a direita, mas, se você especificar um valor occurrence negativo, as funções serão lidas da direita para a esquerda. [**ReplaceRegExGroup**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/ReplaceRegExGroup.htm)(text, regex, to\_str, group [, occurrence]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Right Right() retorna uma string que consiste nos últimos caracteres (mais à direita) da string de entrada, em que o número de caracteres é determinado pelo segundo argumento. [**Right**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Right.htm)(text, count) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### RTrim RTrim() retorna a string de entrada destituída de espaços à direita. [**RTrim**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/RTrim.htm)(text) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### SubField SubField() é usado para extrair componentes de substring a partir de um campo primário de string, em que os campos de registro originais consistem em duas ou mais partes separadas por um separador. [**SubField**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/SubField.htm)(text, delimiter[, field\_no ]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### SubFieldRegEx SubFieldRegEx() extrai texto de uma expressão de string de entrada, usando o padrão de expressão regular especificado como delimitador. A função retorna um valor nulo se nenhuma correspondência for encontrada. [**SubFieldRegEx**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/SubFieldRegEx.htm)(text, regex\_delimiter [, field\_no]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### SubStringCount SubStringCount() retorna o número de ocorrências da subsequência especificada no texto da string de entrada. Se não houver uma correspondência, será retornado 0. [**SubStringCount**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/SubStringCount.htm)(text, substring) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### TextBetween TextBetween() retorna o texto na string de entrada que ocorre entre os caracteres especificados como delimitadores. [**TextBetween**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/TextBetween.htm)(text, delimiter1, delimiter2[, n]) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Trim Trim() retorna a string de entrada destituída de espaços à esquerda e à direita. [**Trim**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Trim.htm)(text) [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/string-functions.htm) #### Upper Upper() converte todos os caracteres na string de saída para maiúsculos em todos os caracteres de texto na expressão. Números e símbolos são ignorados. [**Upper**](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Upper.htm)(text)