Funções para manipulação, pesquisa e formatação de texto.
len
(text) Retorna o comprimento, ou a quantidade de caracteres, de uma string.
| Parâmetros | | text | string | A string a ser medida | |
| Retorno | número |
| Exemplos | |
left
(text, count) Retorna os primeiros N caracteres de uma string.
| Parâmetros | | text | string | A string de origem | | count | number | Quantidade de caracteres a extrair | |
| Retorno | texto |
| Exemplos | left("ProcessMind", 7) → Process |
| Veja também | |
right
(text, count) Retorna os últimos N caracteres de uma string.
| Parâmetros | | text | string | A string de origem | | count | number | Quantidade de caracteres a extrair | |
| Retorno | texto |
| Exemplos | right("ProcessMind", 4) → Mind |
| Veja também | |
mid
(text, start, count) Retorna uma substring do meio de uma string, começando em uma posição baseada em 1 e extraindo uma quantidade especificada de caracteres.
| Parâmetros | | text | string | A string de origem | | start | number | Posição inicial (baseada em 1) | | count | number | Quantidade de caracteres a extrair | |
| Retorno | texto |
| Exemplos | mid("ProcessMind", 8, 4) → Mind mid("Hello World", 1, 5) → Hello |
| Veja também | |
lower
(text) Converte uma string para letras minúsculas.
| Parâmetros | | text | string | A string a ser convertida | |
| Retorno | texto |
| Exemplos | |
| Veja também | |
upper
(text) Converte uma string para letras maiúsculas.
| Parâmetros | | text | string | A string a ser convertida | |
| Retorno | texto |
| Exemplos | |
| Veja também | |
proper
(text) Converte uma string para o formato de título, colocando em maiúscula a primeira letra de cada palavra.
| Parâmetros | | text | string | A string a ser convertida | |
| Retorno | texto |
| Exemplos | proper("hello world") → Hello World proper("HELLO WORLD") → Hello World |
| Veja também | |
trim
(text) Remove espaços em branco das duas extremidades de uma string.
| Parâmetros | | text | string | A string a ser ajustada | |
| Retorno | texto |
| Exemplos | |
| Veja também | |
trimStart
(text) Remove espaços em branco do início de uma string.
| Parâmetros | | text | string | A string a ser ajustada | |
| Retorno | texto |
| Exemplos | trimStart(" hello") → hello |
| Veja também | |
trimEnd
(text) Remove espaços em branco do final de uma string.
| Parâmetros | | text | string | A string a ser ajustada | |
| Retorno | texto |
| Exemplos | trimEnd("hello ") → hello |
| Veja também | |
replace
(text, search, replacement) Substitui todas as ocorrências de uma string de pesquisa por uma string de substituição.
| Parâmetros | | text | string | A string de origem | | search | string | A string a ser encontrada | | replacement | string | A string de substituição | |
| Retorno | texto |
| Exemplos | replace("Hello World", "World", "ProcessMind") → Hello ProcessMind replace("a-b-c", "-", "_") → a_b_c |
concat
(text1, text2, ...?) Concatena duas ou mais strings.
| Parâmetros | | text1 | string | Primeira string | | text2 | string | Segunda string | | ... (opcional) | string | Strings adicionais, até 6 no total | |
| Retorno | texto |
| 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 | A string a ser pesquisada | | search | string | A string a ser encontrada | |
| Retorno | booleano |
| Exemplos | contains("ProcessMind", "Mind") → true contains("Hello", "xyz") → false |
| Veja também | |
startsWith
(text, prefix) Verifica se uma string começa com um prefixo especificado.
| Parâmetros | | text | string | A string a ser verificada | | prefix | string | O prefixo a ser encontrado | |
| Retorno | booleano |
| Exemplos | startsWith("ProcessMind", "Process") → true |
| Veja também | |
endsWith
(text, suffix) Verifica se uma string termina com um sufixo especificado.
| Parâmetros | | text | string | A string a ser verificada | | suffix | string | O sufixo a ser encontrado | |
| Retorno | booleano |
| Exemplos | endsWith("ProcessMind", "Mind") → true |
| Veja também | |
indexOf
(text, search) Retorna a posição, começando em 1, da primeira ocorrência da substring ou 0 se ela não for encontrada.
| Parâmetros | | text | string | A string a ser pesquisada | | search | string | A string a ser encontrada | |
| 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 da substring.
| Parâmetros | | search | string | A string a ser encontrada | | text | string | A string a ser pesquisada | |
| Retorno | número |
| Exemplos | find("Mind", "ProcessMind") → 8 |
| Observações | Observe que a ordem dos parâmetros é invertida em relação a indexOf. |
| Veja também | |
padLeft
(text, length, char?) Preenche uma string à esquerda até atingir um comprimento especificado.
| Parâmetros | | text | string | A string a ser preenchida | | length | number | O comprimento desejado | | char (opcional) | string | O caractere usado no preenchimento (padrão: " " (espaço)) | |
| Retorno | texto |
| Exemplos | padLeft("42", 5, "0") → 00042 |
| Veja também | |
padRight
(text, length, char?) Preenche uma string à direita até atingir um comprimento especificado.
| Parâmetros | | text | string | A string a ser preenchida | | length | number | O comprimento desejado | | char (opcional) | string | O caractere usado no preenchimento (padrão: " " (espaço)) | |
| Retorno | texto |
| Exemplos | padRight("Hi", 5, ".") → Hi... |
| Veja também | |
Tópicos relacionados