append
Concatena duas strings e retorna o valor concatenado.
append
também pode ser usado com variáveis:
prepend
Adiciona a string especificada ao início de outra string.
prepend
também pode ser usado com variáveis:
capitalize
Torna o primeiro caractere de uma string maiúsculo.
capitalize
apenas capitaliza o primeiro caractere de uma string, então palavras posteriores não são afetadas:
upcase
Torna cada caractere em uma string maiúsculo. Não tem efeito em strings que já estão todas em maiúsculas.
downcase
Torna cada caractere em uma string minúsculo. Não tem efeito em strings que já estão todas em minúsculas.
strip
Remove todos os espaços em branco (tabs, espaços e quebras de linha) de ambos os lados esquerdo e direito de uma string. Não afeta espaços entre palavras.
lstrip
Remove todos os espaços em branco (tabs, espaços e quebras de linha) do lado esquerdo de uma string. Não afeta espaços entre palavras.
rstrip
Remove todos os espaços em branco (tabs, espaços e quebras de linha) do lado direito de uma string. Não afeta espaços entre palavras.
strip_newlines
Remove quaisquer caracteres de quebra de linha de uma string.
replace
Substitui toda ocorrência do primeiro argumento em uma string pelo segundo argumento.
replace_first
Substitui apenas a primeira ocorrência do primeiro argumento em uma string pelo segundo argumento.
replace_last
Substitui apenas a última ocorrência do primeiro argumento em uma string pelo segundo argumento.
remove
Remove toda ocorrência da substring especificada de uma string.
remove_first
Remove apenas a primeira ocorrência da substring especificada de uma string.
remove_last
Remove apenas a última ocorrência da substring especificada de uma string.
truncate
Encurta uma string até o número de caracteres passado como argumento. Se o número especificado de caracteres for menor que o comprimento da string, reticencias (…) são adicionadas à string e são incluídas na contagem de caracteres.
Basic Usage
Reticências personalizadas
truncate
aceita um segundo argumento opcional que especifica a sequência de caracteres a ser anexada à string truncada. Por padrão são reticências (…), mas você pode especificar uma sequência diferente.
O comprimento do segundo argumento conta contra o número de caracteres especificado pelo primeiro argumento. Por exemplo, se você quer truncar uma string para exatamente 10 caracteres, e usar reticências de 3 caracteres, use 13 para o primeiro argumento de truncate
, já que as reticências contam como 3 caracteres.
Sem reticências
Você pode truncar para o número exato de caracteres especificado pelo primeiro argumento e evitar mostrar caracteres finais passando uma string vazia como segundo argumento:split
Divide uma string em um array usando o argumento como separador. split
é comumente usado para converter itens separados por vírgula de uma string para um array.
truncatewords
Encurta uma string até o número de palavras passado como argumento. Se o número especificado de palavras for menor que o número de palavras na string, reticências (…) são anexadas à string.
Reticências personalizadas
truncatewords
aceita um segundo argumento opcional que especifica a sequência de caracteres a ser anexada à string truncada. Por padrão são reticências (…), mas você pode especificar uma sequência diferente.
Sem reticências
Você pode evitar mostrar caracteres finais passando uma string vazia como segundo argumento:normalize_whitespace
Substitui qualquer ocorrência de espaço em branco com um único espaço.
number_of_words
Conta o número de palavras em um texto. Este filtro aceita um argumento opcional para controlar o tratamento de caracteres chinês-japonês-coreano (CJK) na string de entrada:
- Passar
'cjk'
como argumento contará cada caractere CJK detectado como uma palavra independentemente de ser separado por espaço em branco. - Passar
'auto'
(detecção automática) funciona similar a'cjk'
mas é mais performático se o filtro for usado em uma string variável que pode ou não conter caracteres CJK.