Assistente de Texto
O Assistente de Texto contem funções que auxiliam no trabalho com texto.
Carregando este Assistente
Este assistente é carregado usando o seguinte código:
$this->load->helper('text');
As seguinte funções estão disponíveis:
word_limiter()
Trunca uma string para o número de palavras especificado. Exemplo
$string = "Aqui temos um belo texto de oito palavras.";
$string = word_limiter($string, 4);
// Retorna: Aqui temos um belo…
O terceiro parâmetro é um sufixo opcional adicionado à string. Por padrão adiciona-se reticências.
character_limiter()
Trunca uma string para o número de caracteres especificado. Mantem a integridade das palavras de modo que a contagem pode ter uma pequena variação para mais ou para menos do que você especificar. Exemplo:
$string = "Aqui temos um belo texto de oito palavras.";
$string = character_limiter($string, 20);
// Retorna: Aqui temos um belo …
O terceiro parâmetro é um sufixo opcional adicionado à string. Por padrão adiciona-se reticências.
ascii_to_entities()
Converte valores ASCII em character entities, incluindo high ASCII e caracteres MS Word que podem causar problemas quando usado em uma página da web, de modo que possam ser mostrados sem erros não obstante configurações do browser ou serem armazenados sem problemas em uma base de dados. Eiste algumas dependências no seu conjunto de caracteres suportados pelo servidor, portanto isto pode não ser 100% confiável, mas na maioria dos casos ele identificará corretamente os caracteres foram do escopo normal (acentuados por exemplo). Exemplo:
$string = ascii_to_entities($string);
entities_to_ascii()
Esta função faz o oposto da anterior, transforma character entities de volta em ASCII.
word_censor()
Habilita a censura de palavras de uma determinada string. O primeiro parâmetrp conterá a string original. O segundo conterá uma array de palavras proibidas. O terceiro (opcional) conterá um valor substituto para as palavras. Se não especificado elas serão subsituidas por sinal de "jogo da velha": ####. Exemplo:
$proibidas = array('tóxico', 'maconha', 'cocaina', 'cigarro');
$string = word_censor($string, $proibidas, 'eeeeeeepppaaaa!');
highlight_code()
Colore uma string de código(PHP, HTML, etc.). Exemplo:
$string = highlight_code($string);
A função usa a função highlight_string() do PHP, as cores usadas são as especificadas no seu arquivo php.ini.
highlight_phrase()
Destacará uma frase dentro de uma string de texto. O primeiro parâmetro conterá a string original, o segundo a frase que deseja destacar. Os terceiro e quarto parâmetros conterão as tags HTML de abertura e fechamento onde a frase estará contida. Exemplo:
$string = "Aqui está um belo texto sobre nada em especial.";
$string = highlight_phrase($string, "belo texto", '<span style="color:#990000">', '</span>');
O código acima retornará:
Aqui está um belo texto sobre nada em especial.
word_wrap()
Quebra a linha de texto conforme o número de caracteres especificados mantendo as palavras inteiras. Exemplo:
$string = "Aqui temos um string simples de texto que nos ajudará a demonstrar esta função";
echo word_wrap($string, 25);
// Produzirá:
Aqui temos um string simples
de texto que nos ajudará
a demonstrar esta função