Funções de cadeia de caracteres

Uma função de cadeia de caracteres executa operações em dados de texto. Utilize uma função de cadeia de caracteres para limpar dados, converter dados a um formato diferente, modificar o uso de maiúsculas, calcular métricas sobre os dados ou executar outras manipulações. Essas funções só podem ser usadas com dados do tipo cadeia de caracteres (qualquer um dos tipos String).

Contains

Contains(String, Target, CaseInsensitive=1): procura pela ocorrência de uma sequência-alvo dentro de uma cadeia de caracteres. Retorna verdadeiro se a cadeia de caracteres (String) contém a sequência-alvo (Target); senão, retorna falso.

CountWords

CountWords(string): retorna a contagem das palavras na cadeia de caracteres especificada. Palavras são definidas por caracteres separados por um espaço.

DecomposeUnicodeForMatch

DecomposeUnicodeForMatch(String): remove acentos e expande caracteres compostos ao convertê-los para estreitos. Essa função pega uma cadeia de caracteres Unicode e a converte em uma cadeia de caracteres estreita e com letras minúsculas. Todos os acentos e similares são removidos.

Essa função é útil somente para correspondência. O resultado não é considerado uma cadeia normalizada.

EndsWith

EndsWith(String, Target, CaseInsensitive=1): verifica se uma cadeia de caracteres termina com a sequência-alvo especificada. Retorna verdadeiro se a cadeia de caracteres (String) termina com a sequência-alvo (Target); senão, retorna falso. Por padrão, não diferencia maiúsculas de minúsculas.

FindString

FindString(String,Target): procura pela ocorrência de uma sequência-alvo em uma cadeia de caracteres e retorna a posição numérica dessa ocorrência.

Retorna o índice de base 0 da primeira ocorrência da sequência-alvo (Target) na cadeia de caracteres (String). Retorna -1 se não houver ocorrência.

GetWord

GetWord(string, n): retorna a enésima palavra (base 0) da cadeia de caracteres. Palavras são definidas como um grupo de caracteres separados por um espaço. O índice de base 0 significa que a primeira palavra está na posição 0.

Left

Left(String, len): retorna os primeiros caracteres (número determinado em len) da cadeia (String). Se len for menor que 0 ou maior que o comprimento da cadeia de caracteres, esta permanecerá inalterada.

Length

Length(String): retorna o comprimento da cadeia de caracteres (String).

LowerCase

LowerCase(String): converte a cadeia de caracteres para letras minúsculas.

MD5_ASCII

MD5_ASCII(String): calcula o hash MD5 da cadeia de caracteres. A cadeia de caracteres deve ter apenas caracteres estreitos. Caracteres largos são convertidos em “?” antes de calcular o hash. Use para o tipo String, não recomendado para o tipo WString. Evite usar essa função em cadeias de caracteres que podem conter caracteres largos.

MD5_UNICODE

MD5_UNICODE(String): tanto para o motor original quanto para o AMP, calcula o hash MD5 da cadeia armazenada como UTF-16.

MD5_UTF8

MD5_UTF8(String): calcula o hash MD5 da cadeia de caracteres armazenada como UTF-8.

PadLeft

PadLeft (String, len, char): preenche o lado esquerdo da cadeia de caracteres com o caractere especificado (char) até o comprimento especificado (len). Se o preenchimento definido em char for maior do que um caractere, somente o primeiro caractere será usado.

PadRight

PadRight (String, len, char): preenche o lado direito da cadeia de caracteres com o caractere especificado (char) até o comprimento especificado (len). Se o preenchimento definido em char for maior do que um caractere, somente o primeiro caractere será usado.

REGEX_CountMatches

REGEX_CountMatches(String,pattern,icase): retorna quantas vezes a cadeia de caracteres (String) corresponde ao padrão especificado (pattern).

icase é um parâmetro opcional. Quando especificado, há diferenciação entre maiúsculas e minúsculas. Por padrão, icase = 1, sem diferenciar maiúsculas de minúsculas. Quando definido como 0, há diferenciação.

Consulte a página Sintaxe de expressões regulares Regex Perl Boost para facilitar a construção da expressão.

REGEX_Match

REGEX_Match(String,pattern,icase): procura, em uma cadeia de caracteres (String), a ocorrência de um padrão de expressão regular (pattern).

Informa se a cadeia de caracteres coincide com o padrão do primeiro ao último caractere.

• Para procurar por algo que não está necessariamente no início da cadeia de caracteres, inicie o padrão com ".*".
• Para procurar por algo que não vai necessariamente até o final da cadeia de caracteres, termine o padrão com ".*".

Consulte a página Sintaxe de expressões regulares Regex Perl Boost para obter mais informações sobre como construir uma expressão regular.

icase é um parâmetro opcional. Quando especificado, há diferenciação entre maiúsculas e minúsculas. Por padrão, icase = 1, sem diferenciar maiúsculas de minúsculas. Quando definido como 0, há diferenciação.

REGEX_Replace

REGEX_Replace(String, pattern, replace, icase): permite substituir texto usando expressões regulares e retorna a cadeia de caracteres resultante das funções RegEx de encontrar padrão (pattern) e substituir cadeia de caracteres (replace). Todas as ocorrências são substituídas, não apenas a primeira.

Consulte a página Sintaxe de expressões regulares Regex Perl Boost para facilitar a construção da expressão. O parâmetro "replace" pode ser tanto um valor especificado, como mostrado abaixo, ou um grupo marcado, como "$1".

icase é um parâmetro opcional. Quando especificado, há diferenciação entre maiúsculas e minúsculas. Por padrão, icase = 1, sem diferenciar maiúsculas de minúsculas. Quando definido como 0, há diferenciação.

Replace

Replace(String, Target, Replacement): retorna a cadeia de caracteres (String) após substituir todas as ocorrências da sequência-alvo (Target) pela sequência de substituição (Replacement).

ReplaceChar

ReplaceChar(String, y, z): retorna a cadeia de caracteres (String) após substituir todas as ocorrências de qualquer caractere em y pelo caractere em z. Se z for uma cadeia com mais de um caractere, apenas o primeiro será usado. Se z estiver vazio, todos os caracteres da cadeia que corresponderem a quaisquer caracteres em y serão simplesmente removidos.

ReplaceFirst

ReplaceFirst(String, Target, Replacement): retorna a cadeia de caracteres (String) após substituir a primeira ocorrência da sequência-alvo (Target) pela sequência de substituição (Replacement).

ReverseString

ReverseString(String): inverte todos os caracteres da cadeia de caracteres (String).

Right

Right(String, len): retorna os últimos caracteres (número determinado em len) da cadeia. Se len for menor que 0 ou maior que o comprimento da cadeia de caracteres, esta permanecerá inalterada.

StartsWith

StartsWith(String, Target, CaseInsensitive=1): verifica se uma cadeia de caracteres começa com a sequência-alvo especificada. Retorna verdadeiro se a cadeia de caracteres (String) inicia com a sequência-alvo (Target); senão, retorna falso.

STRCSPN

STRCSPN(String, y): retorna o comprimento da porção inicial da cadeia de caracteres (String) consistindo em caracteres que não estão em y.

StripQuotes

StripQuotes(String): remove um par de aspas ou apóstrofos das extremidades da cadeia de caracteres (String).

STRSPN

STRSPN(String, y): retorna o comprimento da porção inicial da cadeia de caracteres (String) consistindo em caracteres que estão em y.

Substring

Substring(String, start, length): retorna a subcadeia da cadeia de caracteres (String), começando em start e parando após o comprimento informado em length, se informado.

TitleCase

TitleCase(String) : converte a primeira letra de cada palavra da cadeia de caracteres (String) para maiúscula.

Trim

Trim(String, y): remove o(s) caractere(s) em y do início e do fim da cadeia de caracteres (String). O parâmetro y é opcional: por padrão, essa função remove espaços em branco. Observe, nos exemplos da função TRIM, que os caracteres especificados são removidos. Não importa a ordem em que os caracteres estão.

TrimLeft

TrimLeft(String, y): remove os caracteres em y do início da cadeia de caracteres (String). O parâmetro y é opcional: por padrão, essa função remove espaços em branco.

TrimRight

TrimRight(String, y): remove os caracteres em y do final da cadeia de caracteres (String). O parâmetro y é opcional: por padrão, essa função remove espaços em branco.

Mesmo que você queira cortar um grupo de caracteres em sequência, as funções Trim não respeitam a ordem dos caracteres – elas tratam a cadeia em "y" como uma simples lista. Portanto, elas cortam TODOS os caracteres especificados na lista. Se você quiser substituir uma sequência como um todo, use uma função Replace ou uma função Regex em sua expressão.

Uppercase

Uppercase(String): converte uma cadeia de caracteres (String) para letras minúsculas.

Uuid

UuidCreate(): cria um identificador exclusivo.