Funções para manipular, pesquisar e formatar textos. Você pode testá-las no Editor de expressões com um teste grátis.
len
(text) Retorna o comprimento de um texto em caracteres.
| Parâmetros | | text | string | Texto a medir | |
| Retorno | número |
| Exemplos | |
left
(text, count) Retorna os primeiros N caracteres de um texto.
| Parâmetros | | text | string | Texto de origem | | count | number | Quantidade de caracteres a extrair | |
| Retorno | string |
| Exemplos | left("ProcessMind", 7) → Process |
| Veja também | |
right
(text, count) Retorna os últimos N caracteres de um texto.
| Parâmetros | | text | string | Texto de origem | | count | number | Quantidade de caracteres a extrair | |
| Retorno | string |
| Exemplos | right("ProcessMind", 4) → Mind |
| Veja também | |
mid
(text, start, count) Retorna uma parte do texto a partir do meio, começando na posição indicada (a partir de 1) e extraindo a quantidade especificada de caracteres.
| Parâmetros | | text | string | Texto de origem | | start | number | Posição inicial (a partir de 1) | | count | number | Quantidade de caracteres a extrair | |
| Retorno | string |
| Exemplos | mid("ProcessMind", 8, 4) → Mind mid("Hello World", 1, 5) → Olá |
| Veja também | |
lower
(text) Converte uma string para letras minúsculas.
| Parâmetros | | text | string | String a converter | |
| Retorno | string |
| Exemplos | |
| Veja também | |
upper
(text) Converte uma string para letras maiúsculas.
| Parâmetros | | text | string | String a converter | |
| Retorno | string |
| Exemplos | |
| Veja também | |
proper
(text) Converte uma string para o formato de capitalização de títulos, deixando a primeira letra de cada palavra em maiúscula.
| Parâmetros | | text | string | String a converter | |
| Retorno | string |
| Exemplos | proper("hello world") → Hello World proper("HELLO WORLD") → Hello World |
| Veja também | |
trim
(text) Remove os espaços em branco do início e do fim de uma string.
| Parâmetros | | text | string | String a aparar | |
| Retorno | string |
| Exemplos | |
| Veja também | |
trimStart
(text) Remove os espaços em branco do início de uma string.
| Parâmetros | | text | string | String a aparar | |
| Retorno | string |
| Exemplos | trimStart(" hello") → hello |
| Veja também | |
trimEnd
(text) Remove os espaços em branco do fim de uma string.
| Parâmetros | | text | string | String a aparar | |
| Retorno | string |
| Exemplos | trimEnd("hello ") → hello |
| Veja também | |
replace
(text, search, replacement) Substitui todas as ocorrências de uma string de busca por outra string.
| Parâmetros | | text | string | Texto de origem | | search | string | String a localizar | | replacement | string | String de substituição | |
| Retorno | string |
| Exemplos | replace("Hello World", "World", "ProcessMind") → Hello ProcessMind replace("a-b-c", "-", "_") → a_b_c |
concat
(text1, text2, ...?) Junta duas ou mais strings.
| Parâmetros | | text1 | string | Primeira string | | text2 | string | Segunda string | | ... (opcional) | string | Strings adicionais, até 6 no total | |
| Retorno | string |
| Exemplos | concat("Hello", " ", "World") → Hello World |
| Observações | Você também pode usar o operador + para concatenar strings. |
contains
(text, search) Verifica se uma string contém outra string.
| Parâmetros | | text | string | String a pesquisar | | search | string | String a localizar | |
| Retorno | boolean |
| Exemplos | contains("ProcessMind", "Mind") → true contains("Hello", "xyz") → false |
| Veja também | |
startsWith
(text, prefix) Verifica se uma string começa com o prefixo especificado.
| Parâmetros | | text | string | String a verificar | | prefix | string | Prefixo a localizar | |
| Retorno | boolean |
| Exemplos | startsWith("ProcessMind", "Process") → true |
| Veja também | |
endsWith
(text, suffix) Verifica se uma string termina com o sufixo especificado.
| Parâmetros | | text | string | String a verificar | | suffix | string | Sufixo a localizar | |
| Retorno | boolean |
| Exemplos | endsWith("ProcessMind", "Mind") → true |
| Veja também | |
indexOf
(text, search) Retorna a posição, começando em 1, da primeira ocorrência de uma substring ou 0 se ela não for encontrada.
| Parâmetros | | text | string | String a pesquisar | | search | string | String a localizar | |
| Retorno | número |
| Exemplos | indexOf("ProcessMind", "Mind") → 8 indexOf("Hello", "xyz") → 0 |
| Veja também | |
find
(search, text) Alias de indexOf. Retorna a posição, começando em 1, da primeira ocorrência de uma substring.
| Parâmetros | | search | string | String a localizar | | text | string | String a pesquisar | |
| Retorno | número |
| Exemplos | find("Mind", "ProcessMind") → 8 |
| Observações | Observe que a ordem dos parâmetros é inversa à de indexOf. |
| Veja também | |
padLeft
(text, length, char?) Adiciona caracteres à esquerda de uma string até atingir o comprimento especificado.
| Parâmetros | | text | string | String a preencher | | length | number | Comprimento desejado | | char (opcional) | string | Caractere de preenchimento (padrão: " " (espaço)) | |
| Retorno | string |
| Exemplos | padLeft("42", 5, "0") → 00042 |
| Veja também | |
padRight
(text, length, char?) Adiciona caracteres à direita de uma string até atingir o comprimento especificado.
| Parâmetros | | text | string | String a preencher | | length | number | Comprimento desejado | | char (opcional) | string | Caractere de preenchimento (padrão: " " (espaço)) | |
| Retorno | string |
| Exemplos | padRight("Hi", 5, ".") → Hi... |
| Veja também | |
Tópicos relacionados