PHP Coupé

Aprendendo

Classes

Coupe_String

Funções para manipulação de strings.

Nomeando

Remove Prefix

Remove o prefixo de uma string qualquer (ex: input_, select_).
Se o segundo parâmetro não for passado, '_' é usado como caracter separador.

Recebe: ($string=palavra, [$string=prefixo])
Retorna: STRING (palavra sem prefixo)

...
$Coupe->import('Coupe_String');
$palavra = 'fruta-abacaxi';
// retorna 'abacaxi'
return $Coupe->Coupe_String->removePrefix($palavra, '-');
...

Remove Suffix

Remove o sufixo de uma string qualquer.
Se o segundo parâmetro não for passado, '_' é usado como caracter separador.

Recebe: ($string=palavra, [$string=sufixo])
Retorna: STRING (palavra sem sufixo)

...
$Coupe->import('Coupe_String');
$palavra = 'fruta-abacaxi';
// retorna 'fruta'
return $Coupe->Coupe_String->removeSuffix($palavra, '-');
...

Transformando

Cut

Corta uma string até um tamanho definido.
Pode-se cortar seco (de acordo com o numero de caracteres) ou até o último espaço da string dentro do tamanho definido.

Recebe: ($string=frase, $int=tamanho, $bool=corte_seco)
Retorna: STRING (palavra cortada)

...
$Coupe->import('Coupe_String');
$frase = 'Essa é minha frase que será cortada';
// recebe 'Essa é min'
$corte 1 = $Coupe->Coupe_String->create($frase, 10, TRUE);
// recebe 'Essa é...'
$corte 2 = $Coupe->Coupe_String->create($frase, 10);
...

Camelize

Remove espaços de uma string colocando iniciais em maiúsculo.

Recebe: ($string=palavra_com_espacos)
Retorna: STRING (palavra sem espaços ou caracteres de divisão)

...
$Coupe->import('Coupe_String');
$frase = 'Casa Grande';
// retorna 'casaGrande'
return $Coupe->Coupe_String->camelize($frase);
...

Unixize

Substitui espaços de uma string pelo separador definido.
Se o segundo parâmetro não for passado, '-' é usado como caracter separador.

Recebe: ($string=palavra_com_espacos, [$string=caracter_de_divisao])
Retorna: STRING (palavra com espaços substituidos por caracteres de divisão)

...
$Coupe->import('Coupe_String');
$frase = 'Casa Pequena';
// retorna 'casa-pequena'
return $Coupe->Coupe_String->unixize($frase);
...

Humanize

Torna legíveis palavras que utilizam '_' ou '-'.
O segundo parâmetro dá opção de captalizar a primeira palavra da string.

Recebe: ($string=palavra_sem_espacos, [$bool=captaliza_string])
Retorna: STRING (palavra com caracteres de divisão substituídos por espaços)

...
$Coupe->import('Coupe_String');
$frase = 'casa-pequena,casaGrande';
// retorna 'Casa pequena,casa_grande'
return $Coupe->Coupe_String->humanize($frase, TRUE);
...

Remove Accent

Remove acentos de caracteres especiais.

Recebe: ($string=palavra_acentuada)
Retorna: STRING (palavra sem acentos)

...
$Coupe->import('Coupe_String');
$palavra = 'Parâmetros';
// retorna 'Parametros'
return $Coupe->Coupe_String->humanize($palavra);
...

Vetorizando

Vector

Separa uma string em array de acordo com um separador especificado
Se o segundo parâmetro não for passado, ',' é usado como caracter separador.

Recebe: ($string=palavra, $string=divisor)
Retorna: ARRAY (vetor com as palavras divididas)

...
$Coupe->import('Coupe_String');
$valores = 'valor1, valor2, valor3, valor4';
$array = $Coupe->Coupe_String->vector($valores);
...

Multi Values

Separa em array uma lista de índices e valores passados através de uma string.
Ex. de lista: (name1=value1, name2=value2, name3=value3, name4=value4).

Recebe: ($string=lista_valores, [$string=sinal_equivalencia], [$string=divisor])
Retorna: ARRAY (vetor com os valores separados e seus indices correspondentes)

...
$Coupe->import('Coupe_String');
$valores = 'name1=value1, name2=value2, name3=value3, name4=value4';
$array = $Coupe->Coupe_String->multiValues($valores);
...