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.
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(text)
Chr() retorna o caractere Unicode correspondente ao inteiro de entrada, também mostrado como um ponto de código.
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 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(text, char_set[, count])
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(expr{, expression})
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(expr{, expression})
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(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 da esquerda para a direita, de 1 para cima.
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 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(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 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(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)