DevSecOps

13 dez, 2002

Funções para tratamento de strings

Publicidade

Funções relacionadas
à HTML

htmlspecialchars
string htmlspecialchars(string
str);

Devolve 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);

Devolve a string fornecida substituindo
todas as quebras de linha ("
") por quebras
de linhas em html ("
").

Exemplo:
echo nl2br("Mauricio
Vivas
");

Imprime:
Maurício
Vivas

get_meta_tags
array get_meta_tags(string
ficheiro);

Abra um ficheiro html e percorra o cabeçalho
em busca de "meta" tags, devolvendo num array
todos os valores encontrados.

Exemplo:
No ficheiro teste.html temos:






a execução da função:

get_meta_tags("teste.html");

Devolve o array:

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

strip_tags
string strip_tags(string
str);

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

Exemplo:
strip_tags(‘testando
’);

Devolve a string "testando"

urlencode
string urlencode(string
str);

Devolve 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.

 

Funções relacionadas
à arrays

Implode e join
string implode(string separador,
array partes);
string join(string separador, array partes);

As duas funções são
idênticas. Devolvem 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]);

Devolve 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
devolve 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 Devolve 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, Devolve uma
string vazia, e se encontrar Devolve todos os caracteres
de str1 a partir desse ponto.

Exemplo:
strstr("Mauricio Vivas",
"Viv"); // Devolve "Vivas"

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] );

Devolve 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);

Devolve 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

");
// Devolve " Teste"

ltrim
string ltrim(string str);

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

Exemplo:
ltrim(" Teste

");
// Devolve "Teste

"

trim
string trim(string str);

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

Exemplo:
trim(" Teste

");
// Devolve "Teste"

strrev
string strrev(string
str);

Devolve a string fornecida invertida.

Exemplo:
trrev("Teste"); // Devolve
"etseT"


strtolower
string strtolower(string
str);

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

Exemplo:
strtolower("Teste");
// Devolve "teste"

strtoupper
string strtoupper(string
str);

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

Exemplo:
strtolower("Teste");
// Devolve "TESTE"

ucfirst
string ucfirst(string str);

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

Exemplo:
ucfirst("teste de funcao");
// Devolve "Teste de funcao"

ucwords
string ucwords(string str);

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

Exemplo:
ucwords("teste de funcao");
// Devolve "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);

Devolve o caracter correspondente ao
código ASCII fornecido.

ord
int ord(string string);

Devolve o código ASCII correspontente
ao caracter fornecido.

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

Imprime os argumentos fornecidos.

print
print(string arg);

Imprime o argumento fornecido.

strlen
int strlen(string str);

Devolve o tamanho da string fornecida.