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.
Capitalize() retorna a string com todas as palavras em letras iniciais maiúsculas.
Capitalize(text)
Chr() retorna o caractere Unicode correspondente ao inteiro de entrada.
Chr(int)
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(text, regex)
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(expression_text)
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(text, regex [, field_no])
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(text, regex, group [, field_no])
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 primeira ocorrência de qualquer caractere do conjunto de pesquisa é retornada, a não ser que um terceiro argumento (com um valor maior que 1) seja fornecido. Se não for encontrada correspondência, será retornado 0.
FindOneOf(text, char_set[, count])
Hash128() retorna um hash de 128 bits dos valores combinados de entrada da expressão. O resultado é uma string de 22 caracteres.
Hash128(expr{, expression})
Hash160() retorna um hash de 160 bits dos valores combinados de expressão de entrada. O resultado é uma string de 27 caracteres.
Hash160(expr{, expression})
Hash256() retorna um hash de 256 bits dos valores combinados de expressão de entrada. O resultado é uma string de 43 caracteres.
Hash256(expr{, expression})
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 de 1 em diante.
Index (text, substring[, count])
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(text, regex [, count])
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(text, regex, group [, count])
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(json [, type])
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(json, path)
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(json, path, value)
KeepChar() retorna uma string que consiste na primeira string, "text", menos qualquer caractere NÃO contido na segunda string, "keep_chars".
KeepChar(text, keep_chars)
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(text, count)
Len() retorna o comprimento da cadeia de caracteres de entrada.
Len(text)
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(text1, text2)
Lower() converte todos os caracteres na string de entrada em minúsculos.
Lower(text)
LTrim() retorna a string de entrada destituída de espaços à esquerda.
LTrim(text)
MatchRegEx() compara a string de entrada com um ou mais padrões de expressão regular especificados e retorna a localização numérica dos padrões de expressão regular correspondentes. Se nenhuma correspondência for encontrada, a função retornará 0. Essa função procura apenas correspondências exatas.
MatchRegEx(text, regex1 [ , regex2,...regexN])
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(text, start[, count])
Ord() retorna o número de ponto do código Unicode do primeiro caractere da string de entrada.
Ord(text)
PurgeChar() retorna uma string contendo todos os caracteres na string de entrada ('text'), exceto para qualquer caractere presente no segundo argumento ('remove_chars').
PurgeChar(text, remove_chars)
Repeat() forma uma string que consiste em uma string de entrada, repetido o número de vezes definido pelo segundo argumento.
Repeat(text[, repeat_count])
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(text, from_str, to_str)
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(text, regex, to_str [, occurrence])
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 de occurrence negativo, as funções serão lidas da direita para a esquerda.
ReplaceRegExGroup(text, regex, to_str, group [, occurrence])
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(text, count)
RTrim() retorna a string de entrada destituída de espaços à direita.
RTrim(text)
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(text, delimiter[, field_no ])
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(text, regex_delimiter [, field_no])
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(text, substring)
TextBetween() retorna o texto na string de entrada que ocorre entre os caracteres especificados como delimitadores.
TextBetween(text, delimiter1, delimiter2[, n])
Trim() retorna a string de entrada destituída de espaços à esquerda e à direita.
Trim(text)
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(text)