APÊNDICE 01 - Funções para tratamento de strings

Funções relacionadas a HTML

htmlspecialchars

Funções relacionadas a arrays

string htmlspecialchars(string str);

Retorna a string fornecida, substituindo os seguintes caracteres:

& para '&'
" para '"'
< para '<'
> para ‘>'

htmlentities

string htmlentities(string str);

Funciona de maneira semelhante ao comando anterior, mas de maneira mais completa, pois converte todos os caracteres da string que possuem uma representação especial em html, como por exemplo:

º para 'º'
ª para 'ª'
á para 'á'
ç para ‘ç'

nl2br

string nl2br(string str);

Retorna a string fornecida substituindo todas as quebras de linha ( "\n ") por quebras de linhas em html ( "<br> ").

Exemplo:

echo nl2br( "Mauricio\ncosta\n ");

Imprime:

Guilherme<br>costa<br>

get_meta_tags

array get_meta_tags(string arquivo);

Abre um arquivo html e percorre o cabeçalho em busca de " meta " tags, retornando num array todos os valores encontrados.

Exemplo:

No arquivo teste.html temos:

...

<head>

...

</head>

...

a execução da função:

get_meta_tags( "teste.html ");

retorna o array:

array( "author "=> "jose ", "tags "=> "php3 documentation ")
;

strip_tags

string strip_tags(string str);

Retorna a string fornecida, retirando todas as tags html e/ou PHP encontradas.

Exemplo:

strip_tags('<a href= "teste1.php3 ">testando</a><br>');

Retorna a string " testando "

urlencode

string urlencode(string str);

Retorna a string fornecida, convertida para o formato urlencode. Esta função é útil para passar variáveis para uma próxima página.

urldecode

string urldecode(string str);

Funciona de maneira inversa a urlencode, desta vez decodificando a string fornecida do formato urlencode para texto normal.

Implode e join

string implode(string separador, array partes);

string join(string separador, array partes);

As duas funções são idênticas. Retornam uma string contendo todos os elementos do array fornecido separados pela string também fornecida.

Exemplo:

$partes = array( "a ", " casa número ", 13, " é azul ");

$inteiro = join( " " ,$partes);

$inteiro passa a conter a string:

"a casa número 13 é azul "
split

array split(string padrao, string str, int [limite]);

Retorna um array contendo partes da string fornecida separadas pelo padrão fornecido, podendo limitar o número de elementos do array.

Exemplo:

$data = " 11/14/1975 ";

$data_array = split( "/ ",$data);

O código acima faz com que a variável $data_array receba o valor:

array(11,14,1975)

explode

array explode(string padrao, string str);

Funciona de maneira bastante semelhante à função split, com a diferença que não é possível estabelecer um limite para o número de elementos do array.

Comparações entre strings

similar_text

int similar_text(string str1, string str2, double [porcentagem]);

Compara as duas strings fornecidas e retorna o número de caracteres coincidentes. Opcionalmente pode ser fornecida uma variável, passada por referência (ver tópico sobre funções), que receberá o valor percentual de igualdade entre as strings. Esta função é case sensitive, ou seja, maiúsculas e minúsculas são tratadas como diferentes.

Exemplo:

$num = similar_text( "teste ", " testando ",&$porc);

As variáveis passam a ter os seguintes valores:

$num == 4; $porc == 61.538461538462
strcasecmp

int strcasecmp(string str1, string str2);

Compara as duas strings e retorna 0 (zero) se forem iguais, um valor maior que zero se str1 > str2, e um valor menor que zero se str1 < str2. Esta função é case insensitive, ou seja, maiúsculas e minúsculas são tratadas como iguais.
strcmp

int strcasecmp(string str1, string str2);

Funciona de maneira semelhante à função strcasecmp, com a diferença que esta é case sensitive, ou seja, maiúsculas e minúsculas são tratadas como diferentes.

strstr

string strstr(string str1, string str2);

string strchr(string str1, string str2);

As duas funções são idênticas. Procura a primeira ocorrência de str2 em str1. Se não encontrar, retorna uma string vazia, e se encontrar retorna todos os caracteres de str1 a partir desse ponto.

Exemplo:

strstr( "Mauricio costa ", " Viv "); // retorna " costa "

stristr

string strstr(string str1, string str2);

Funciona de maneira semelhante à função strstr, com a diferença que esta é case insensitive, ou seja, maiúsculas e minúsculas são tratadas como iguais.

strpos

int strpos(string str1, string str2, int [offset] );

Retorna a posição da primeira ocorrência de str2 em str1, ou zero se não houver. O parâmetro opcional offset determina a partir de qual caracter de str1 será efetuada a busca. Mesmo utilizando o offset, o valor de retorno é referente ao início de str1.

strrpos

int strrpos(string haystack, char needle);

Retorna a posição da última ocorrência de str2 em str1, ou zero se não houver.

Funções para edição de strings

chop

string chop(string str);

Retira espaços e linhas em branco do final da string fornecida.

Exemplo:

chop( " Teste \n \n " ); // retorna " Teste "

ltrim

string ltrim(string str);

Retira espaços e linhas em branco do final da string fornecida.

Exemplo:

ltrim( " Teste \n \n " ); // retorna " Teste \n \n "

trim

string trim(string str);

Retira espaços e linhas em branco do início e do final da string fornecida.

Exemplo:

trim( " Teste \n \n " ); // retorna " Teste "

strrev

string strrev(string str);

Retorna a string fornecida invertida.

Exemplo:

strrev( "Teste "); // retorna " etseT "

strtolower

string strtolower(string str);

Retorna a string fornecida com todas as letras minúsculas.

Exemplo:

strtolower( "Teste "); // retorna " teste "

strtoupper

string strtoupper(string str);

Retorna a string fornecida com todas as letras maiúsculas.

Exemplo:

strtolower( "Teste "); // retorna " TESTE "

ucfirst

string ucfirst(string str);

Retorna a string fornecida com o primeiro caracter convertido para letra maiúscula.

Exemplo:

ucfirst( "teste de funcao "); // retorna " Teste de funcao "

ucwords

string ucwords(string str);

Retorna a string fornecida com todas as palavras iniciadas por letras maiúsculas.

Exemplo:

ucwords( "teste de funcao "); // retorna " Teste De Funcao "

str_replace

string str_replace(string str1, string str2, string str3);

Altera todas as ocorrências de str1 em str3 pela string str2.

Funções diversas

chr

string chr(int ascii);

Retorna o caracter correspondente ao código ASCII fornecido.

ord

int ord(string string);

Retorna o código ASCII correspontente ao caracter fornecido.

echo

echo(string arg1, string [argn]... );

Imprime os argumentos fornecidos.

print(string arg);

Imprime o argumento fornecido.

strlen

int strlen(string str);

Retorna o tamanho da string fornecida.;

APÊNDICE 01 - Funções para tratamento de strings

Funções relacionadas a HTML

voltar