downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

addcslashes> <stream_wrapper_unregister
[edit] Last updated: Mon, 01 Nov 2010

view this page in

CLIV. String

Introdução

Todas estas funções manipulam strings de vários meios. Algumas seções mais especializadas podem ser encontradas nas seções de expressões regulares e Funções de URL.

Para informação de como as strings funcionam, especialmente sobre o uso de apóstrofo, aspas e sequências de escape veja Strings na seção Tipos do manual.

Dependências

Nenhuma biblioteca externa é necessária para compilar esta extensão.

Instalação

Não há nenhuma instalação necessária para utilizar estas funções, elas fazem parte do núcleo do PHP.

Constantes pré-definidas

As contantes abaixo são definidas por esta extensão e somente estarão disponíveis quando a extensão foi compilada com o PHP ou carregada dinamicamente durante a execução.

CRYPT_SALT_LENGTH integer

CRYPT_STD_DES integer

CRYPT_EXT_DES integer

CRYPT_MD5 integer

CRYPT_BLOWFISH integer

HTML_SPECIALCHARS (integer)

HTML_ENTITIES (integer)

ENT_COMPAT (integer)

ENT_QUOTES (integer)

ENT_NOQUOTES (integer)

CHAR_MAX (integer)

LC_CTYPE (integer)

LC_NUMERIC (integer)

LC_TIME (integer)

LC_COLLATE (integer)

LC_MONETARY (integer)

LC_ALL (integer)

LC_MESSAGES (integer)

STR_PAD_LEFT (integer)

STR_PAD_RIGHT (integer)

STR_PAD_BOTH (integer)

Veja também

Para funções de manuseio de string mais poderosas, de uma olhada em funções de expressão regular POSIX e funções de expressão regular compatíveis com Perl .

Índice
addcslashes -- String entre aspas com barras no estilo C
addslashes -- Adiciona barras invertidas a uma string
bin2hex --  Converte um dado binário em hexadecimal
chop -- Alias de rtrim()
chr -- Retorna um caracter específico
chunk_split -- Divide uma string em pequenos pedaços
convert_cyr_string --  Converte de um caracter cirílico para outro
convert_uudecode --  Decode a uuencoded string
convert_uuencode --  Uuencode a string
count_chars --  Retorna informações sobre os caracteres usados numa string
crc32 -- Calcula polinômio crc32 de uma string
crypt -- Único caminho de codificação de string (hashing)
echo -- Exibe uma ou mais strings
explode -- Divide uma string em strings
fprintf -- Escreve uma string formatada para um stream
get_html_translation_table --  Retorna a tabela de tradução usada por htmlspecialchars() e htmlentities()
hebrev --  Converte texto lógico Hebraico para texto visual
hebrevc --  Converte um texto lógico Hebráico para um texto visual com conversão newline
html_entity_decode --  Converte todas as entidades HTML para os seus caracteres
htmlentities --  Converte todos os caracteres para HTML entities
htmlspecialchars_decode --  Convert special HTML entities back to characters
htmlspecialchars --  Converte caracteres especiais para a realidade HTML
implode -- Junta elementos de uma matriz em uma string
join -- Sinônimo de implode()
levenshtein --  Calcula a distância Levenshtein entre duas strings
localeconv -- Obtém a informação da formatação numérica
ltrim --  Retira whitespace do início da string
md5_file -- Calcula hash md5 de um dado arquivo
md5 -- Calcula o "hash MD5" de uma string
metaphone -- Calcula a metaphone key de uma string
money_format -- Formata um número como uma string de moeda
nl_langinfo --  Retorna informação de linguagem e local
nl2br --  Insere quebras de linha HTML antes de todas newlines em uma string
number_format -- Formata um número com os milhares agrupados
ord -- Retorna o valor ASCII do caractere
parse_str -- Converte a string em variáveis
print -- Mostra uma string
printf -- Mostra uma string formatada
quoted_printable_decode --  Converte uma string quoted-printable para uma string de 8 bit
quotemeta -- Adiciona uma barra invertida antes dos meta caracteres
rtrim --  Retira espaço em branco do final da string
setlocale -- Define informações locais
sha1_file -- Calcula a hash sha1 de um arquivo
sha1 -- Calcula a hash sha1 de uma string
similar_text --  Calcula a similaridade entre duas strings
soundex -- Calcula a chave soundex de uma string
sprintf -- Retorna uma string formatada
sscanf --  Interpreta a entrada de uma string de acordo com um formato
str_ireplace --  Versão que não diferencia maiúsculas e minúsculas de str_replace().
str_pad --  Preenche uma string para um certo tamanho com outra string
str_repeat -- Repete uma string
str_replace --  Substitui todas as ocorrências da string de procura com a string de substituição
str_rot13 -- Executa a transformação rot13 em uma string
str_shuffle -- Mistura uma string aleatoriamente
str_split --  Converte uma string para um array
str_word_count --  Retorna informação sobre as palavras usadas em uma string
strcasecmp --  Comparação de strings sem diferenciar maiúsculas e minúsculas segura para binário
strchr --  Apelido para strstr()
strcmp -- Comparação de string segura para binário
strcoll -- Comparação de string baseada no local
strcspn --  Encontra o tamanho do segmento inicial que não contenha a mascara
strip_tags -- Retira as tags HTML e PHP de uma string
stripcslashes --  Desfaz o efeito de addcslashes()
stripos --  Encontra a primeira ocorrencia de uma string sem diferenciar maiúsculas e minúsculas
stripslashes --  Desfaz o efeito de addslashes()
stristr --  strstr() sem diferenciar maiúsculas e minúsculas
strlen -- Retorna o tamanho de uma string
strnatcasecmp --  Comparação de strings sem diferenciar maiúsculas/minúsculas usando o algoritmo "natural order"
strnatcmp --  Comparação de strings usando o algoritmo "natural order"
strncasecmp --  Comparação de string caso-sensitivo de Binário seguro dos primeiros n caracteres
strncmp --  Comparação de string segura para binário para os primeiros n caracteres
strpbrk --  Search a string for any of a set of characters
strpos --  Encontra a posição da primeira ocorrência de uma string
strrchr --  Encontra a ultima ocorrência de um caractere em uma string
strrev -- Reverte uma string
strripos --  Encontra a posição da última ocorrência de uma string case-insensitive em uma string
strrpos --  Encontra a posição da última ocorrência de um caractere em uma string
strspn --  Encontra o comprimento do segmento inicial combinando com a máscara
strstr -- Encontra a primeira ocorrencia de uma string
strtok -- Tokeniza uma string
strtolower -- Converte uma string para minúsculas
strtoupper -- Converte uma string para maiúsculas
strtr -- Traduz certos caracteres
substr_compare --  A comparação binária entre duas strings case-insensitive de um offset é guardada opcionalmente, até o limite do comprimento de caracteres
substr_count -- Conta o número de ocorrências de uma substring
substr_replace -- Substitui o texto dentro de uma parte de uma string
substr -- Retorna uma parte de uma string
trim --  Retira espaço no ínicio e final de uma string
ucfirst -- Converte para maiúscula o primeiro caractere de uma string
ucwords --  Converte para maiúsculas o primeiro caractere de cada palavra
vfprintf -- Write a formatted string to a stream
vprintf -- Mostra uma string formatada
vsprintf -- Retorna uma string formatada
wordwrap --  Quebra uma string em linhas usando um caractere de quebra de linha.


addcslashes> <stream_wrapper_unregister
[edit] Last updated: Mon, 01 Nov 2010
 
add a note add a note User Contributed Notes String
Tomek Rychtyk 08-Feb-2012 09:58
Get the intersection of two strings using array_intersect

<?php

function string_intersect($string1, $string2)
{
   
$array1 = $array2 = array();

    for(
$i = 0, $j = 0, $s1_len = strlen($string1), $s2_len = strlen($string2);($i < $s1_len) || ($j < $s2_len); $i++, $j++) {
        if(
$i < $s1_len) {
           
$array1[] = $string1[$i];
        }
        if(
$j < $s2_len) {
           
$array2[] = $string2[$j];
        }
    }

    return
implode('', array_intersect($array1, $array2));
}

?>

For more advanced comparison you can use array_uintersect as well.
Peter -the pete- de Pijd 14-Oct-2009 05:01
get the intersection of two strings; may not have optimal performance

<?php
function mb_string_intersect($string1, $string2, $minChars = 5)
{
   
assert('$minChars > 1');

   
$string1 = trim($string1);
   
$string2 = trim($string2);

   
$length1 = mb_strlen($string1);
   
$length2 = mb_strlen($string2);

    if (
$length1 > $length2) {
       
// swap variables, shortest first

       
$string3 = $string1;
       
$string1 = $string2;
       
$string2 = $string3;

       
$length3 = $length1;
       
$length1 = $length2;
       
$length2 = $length3;

        unset(
$string3, $length3);
    }

    if (
$length2 > 255) {
        return
null; // to much calculation required
   
}

    for (
$l = $length1; $l >= $minChars; --$l) { // length
       
for ($i = 0, $ix = $length1 - $l; $i <= $ix; ++$i) { // index
           
$substring1 = mb_substr($string1, $i, $l);
           
$found = mb_strpos($string2, $substring1);
            if (
$found !== false) {
                return
trim(mb_substr($string2, $found, mb_strlen($substring1)));
            }
        }
    }

    return
null;
}
echo
mb_string_intersect("hello spencer", "hey spencer how are you?"); // output "spencer"
?>
Stephen Dewey 19-Nov-2008 05:33
If you want a function to return all text in a string up to the Nth occurrence of a substring, try the below function.

Works in PHP >= 5.

(Pommef provided another sample function for this purpose below, but I believe it is incorrect.)

<?php

// Returns all of $haystack up to (but excluding) the $n_occurrence occurrence of $needle. Therefore:
//        If there are < $n_occurrence occurrences of $needle in $haystack, the entire string will be returned.
//        If there are >= $n_occurrence occurrences of $needle in $haystack, the returned string will end before the $n_occurrence'th needle.
// This function only makes sense for $n_occurrence >= 1
function nsubstr($needle, $haystack, $n_occurrence)
{
   
// After exploding by $needle, every entry in $arr except (possibly) part of the last entry should have its content returned.
   
$arr = explode($needle,$haystack,$n_occurrence);
   
// Examine last entry in $arr. If it contains $needle, cut out all text except for the text before $needle.
   
$last = count($arr) - 1;
   
$pos_in_last = strpos($arr[$last],$needle);
   
    if (
$pos_in_last !== false)
       
$arr[$last] = substr($arr[$last],0,$pos_in_last);
   
    return
implode($needle,$arr);
}

$string = 'd24jkdslgjldk2424jgklsjg24jskgldjk24';

print
'S:  ' . $string . '<br>';
print
'1: ' . nsubstr('24',$string,1) . '<br>';
print
'2: ' . nsubstr('24',$string,2) . '<br>';
print
'3: ' . nsubstr('24',$string,3) . '<br>';
print
'4: ' . nsubstr('24',$string,4) . '<br>';
print
'5: ' . nsubstr('24',$string,5) . '<br>';
print
'6: ' . nsubstr('24',$string,6) . '<br>';
print
'7: ' . nsubstr('24',$string,7) . '<br>';

/*
// prints:
S: d24jkdslgjldk2424jgklsjg24jskgldjk24
1: d
2: d24jkdslgjldk
3: d24jkdslgjldk24
4: d24jkdslgjldk2424jgklsjg
5: d24jkdslgjldk2424jgklsjg24jskgldjk
6: d24jkdslgjldk2424jgklsjg24jskgldjk24
7: d24jkdslgjldk2424jgklsjg24jskgldjk24
*/

?>

Note that this function can be combined with wordwrap() to accomplish a routine but fairly difficult web design goal, namely, limiting inline HTML text to a certain number of lines. wordwrap() can break your string using <br>, and then you can use this function to only return text up to the N'th <br>.

You will still have to make a conservative guess of the max number of characters per line with wordwrap(), but you can be more precise than if you were simply truncating a multiple-line string with substr().

See example:

<?php

$text
= 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Pellentesque id massa. Duis sollicitudin ipsum vel diam. Aliquam pulvinar sagittis felis. Nullam hendrerit semper elit. Donec convallis mollis risus. Cras blandit mollis turpis. Vivamus facilisis, sapien at tincidunt accumsan, arcu dolor suscipit sem, tristique convallis ante ante id diam. Curabitur mollis, lacus vel gravida accumsan, enim quam condimentum est, vitae rutrum neque magna ac enim.';

$wrapped_text = wordwrap($text,100,'<br>',true);

$three_lines = nsubstr('<br>',$wrapped_text,3);

print
'<br><br>' . $three_lines;

$four_lines = nsubstr('<br>',$wrapped_text,4);

print
'<br><br>' . $four_lines;

/*
prints:

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Pellentesque id massa. Duis sollicitudin
ipsum vel diam. Aliquam pulvinar sagittis felis. Nullam hendrerit semper elit. Donec convallis
mollis risus. Cras blandit mollis turpis. Vivamus facilisis, sapien at tincidunt accumsan, arcu

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Pellentesque id massa. Duis sollicitudin
ipsum vel diam. Aliquam pulvinar sagittis felis. Nullam hendrerit semper elit. Donec convallis
mollis risus. Cras blandit mollis turpis. Vivamus facilisis, sapien at tincidunt accumsan, arcu
dolor suscipit sem, tristique convallis ante ante id diam. Curabitur mollis, lacus vel gravida

*/

?>
kriskra at gmail dot com 04-Aug-2008 04:10
In reference to Moe... best random string function
<?php
function random_string($l = 10){
   
$c = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxwz0123456789";
    for(;
$l > 0;$l--) $s .= $c{rand(0,strlen($c))};
    return
str_shuffle($s);
}
?>
Salomon 28-Mar-2008 02:43
If you want to indent a block of text with $level tabs, you can use

function str_indent($level, $text) {
    return str_repeat("\t", $level).str_replace("\n", "\n".str_repeat("\t", $level), $text);
}
Verdauga 19-Mar-2008 06:06
Just a note in regards to bloopletech a few posts down:

The word "and" should not be used when converting numbers to text.  "And" (at least in US English) should only be used to indicate the decimal place.

Example:
1,796,706 => one million, seven hundred ninety-six thousand, seven hundred six.
594,359.34 => five hundred ninety four thousand, three hundred fifty nine and thirty four hundredths
geek dot de at gmail dot com 07-Jan-2008 03:18
This took me quite some time to figure out and it is so obvious. So, I hope it helps someone out there like it would have helped me if I would have found it on this page:

I wanted to read a binary file and write it out with some modified bytes with their hex values. The easiest way I could come up with was the following:

read the file line by line, e.g. 400 bytes and then chuck it into an array with e.g.

<?php
$handle
= @fopen("/path/to/file.bin", "r");
if (
$handle) {
    while (!
feof($handle)) {
       
$buffer[] = fgets($handle, 400);
    }
   
fclose($handle);
   
$buffer[0][0] = chr(hexdec("FF")); // set the first byte to 0xFF
}
// write out the file from the array ...
?>

One could write a function for that, so that One can write a string of bytes. Don't have time for this now but you should get the idea.
m 26-Jul-2007 05:10
Regarding the code for the function beginsWith($str, $sub), I found that it has problems when only one character is present after the string searched for. I found that this works better instead:

<?php
function beginsWith($str, $sub) {
    return (
strncmp($str, $sub, strlen($sub)) == 0);
}
?>
Moe 10-Jul-2007 06:44
In responce to mike here is a better random string function

<?php
   
function random_string($max = 20){
       
$chars = "abcdefghijklmnopqrstuvwxwz0123456789_";
        for(
$i = 0; $i < $max; $i++){
           
$rand_key = mt_rand(0, strlen($chars));
           
$string  .= substr($chars, $rand_key, 1);
        }
        return
str_shuffle($string);
    }
?>
mike &#34;eyes&#34; moe 17-Jun-2007 05:59
Here is a truly random string generator it uses the most common string functions it will work on anywhere.

<?php
   
function random_string($max = 20){
       
$chars = explode(" ", "a b c d e f g h i j k l m n o p q r s t u v w x y z 0 1 2 3 4 5 6 7 8 9");
        for(
$i = 0; $i < $max; $i++){
           
$rnd = array_rand($chars);
           
$rtn .= base64_encode(md5($chars[$rnd]));
        }
        return
substr(str_shuffle(strtolower($rtn)), 0, $max);
    }
?>
bloopletech at gmail dot com 22-May-2007 06:05
[Editor's Note: Remember that number names are locale-specific. Thus in the US 1,000,000,000 is called a billion, while in other countries this might be different (ie. miljard in Dutch). This function provides support only for the US locale]

If you want to convert a number, (int or float) to full spoken text, then you can use my num2text converter, at http://bloople.net/num2text

Examples:
40000 => forty thousand
1,796,706 => one million, seven hundred and ninety-six thousand, seven hundred and six.

If works for positive an negative integers/floats/doubles. The code is only a page long, and you don't have to install any modules or anything.

I hope this comes in handy for somebody!
benjamin at webbutvecklarna dot se 25-Mar-2007 04:23
An update to admin at fivestarbuy dot com's StrParse. Since php5.2.x the occurance of an object in the vardata will cause a "Catchable fatal error". Previously it has failed silently, so I added nullification of present objects.
I also updated comments to be more specific, I hope that's ok with you, admin at fivestarbuy dot com:

<?php
function StrParse($str,$vardata) {

# Variables present in $str is replaced by values of variables in $vardata
# typical use:
# $vardata = get_defined_vars();
# $str = some template code with variables present.
# uncomment the echo line to debug.

$getvarkeys=array_keys($vardata);
$ret=$str;
for (
$x=0; $x < count($getvarkeys); $x++) {
  
$myvar=$getvarkeys[$x];
   if(
is_object($vardata[$myvar])) $vardata[$myvar] = null;
  
#echo "Variable: " . $myvar . " [" . $vardata[$myvar] . "]<br>";
  
$ret=str_replace('$' . $myvar, $vardata[$myvar], $ret);
}
return
$ret;
}
?>
beggining pro 02-Aug-2006 11:00
Well for you egold users out ther I wrote this to just return the balance ONLY
If anyone knows a better way to write this lemme know as im a novice

    function _GetBalance($from, $frompass) {
   $defined_vars = get_defined_vars();

   $_url = 'https://www.e-gold.com/acct/balance.asp';

        $_url_p = "AccountID=" . $from . "&PassPhrase=" . $frompass ."";
           $ch = curl_init();

   curl_setopt($ch, CURLOPT_POST,1);
   curl_setopt($ch, CURLOPT_POSTFIELDS,$_url_p);
   curl_setopt($ch, CURLOPT_URL,$_url);
   curl_setopt($ch, CURLOPT_SSL_VERIFYHOST,  2);
   curl_setopt($ch, CURLOPT_USERAGENT, $defined_vars['HTTP_USER_AGENT']);
   curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
   $content = curl_exec ($ch);

   curl_close ($ch);
$content=strtolower($content);
$content=strstr($content,"</select></font></th></form></tr>");
$content=strip_tags($content);
$content=strrev($content);
$content=strstr($content,"eseht :eton");
$content=str_replace("eseht :eton","",$content);
$content=ltrim($content);
$content=rtrim($content);
$content=substr($content,0,11);
$content=strrev($content);
$content=ltrim($content);

   return $content;

    }
admin at rotarymulundeast dot org 30-Jul-2006 03:16
Here's an easier way to find nth...

function nth($numbex){
  if ($numbex%10 == 1 && $numbex%100 != 11) $sth='st';
  elseif ($numbex%10 == 2 && $numbex%100 != 12) $sth='nd';
  elseif ($numbex%10 == 3 && $numbex%100 != 13) $sth='rd';
  else $sth = 'th';
  return $sth;
}

there is is no need to check if the user has entered a non-integer as we may be using this function for expressing variables as well eg. ith value of x , nth root of z ,etc...
heavyraptor 27-Jul-2006 08:17
I think that
administrador(ensaimada)sphoera(punt)com's function is
too complicated. It's easier with regular expressions.
So I made this function, it isn't really the same,
it's even better because it returns an array with all the
matches found
If there are no matches, false is returned.

<?php
// bool/array str_between( string str, string
start_str, string end_str )
function
str_between($str,$start,$end) {
  if (
preg_match_all('/' . preg_quote($start) . '(.*?)' . preg_quote($end) . '/',$str,$matches)) {
   return
$matches[1];
  }
 
// no matches
 
return false;
}
?>

Enjoy
da (dot) blayde (a t) gmail (dot) com 19-Jul-2006 10:52
Sometimes when converting integers to strings, it looks better to have the number spelled out. I wrote this function that converts integers from -999 to 999 into spelled out strings:

function int2str($int=0){
 $doOnes=true;
 $neg=$int<0?true:false;
 $int=abs(round($int));
 $str='';
 switch(strlen($int)){
  case 1:$int='0'.$int;
  case 2:$int='0'.$int;
  case 3:$int.='';break;
  default:return $int;
 }
 switch($int{0}){
  case 1:$str.='one-hundred-';break;
  case 2:$str.='two-hundred-';break;
  case 3:$str.='three-hundred-';break;
  case 4:$str.='four-hundred-';break;
  case 5:$str.='five-hundred-';break;
  case 6:$str.='six-hundred-';break;
  case 7:$str.='seven-hundred-';break;
  case 8:$str.='eight-hundred-';break;
  case 9:$str.='nine-hundred-';break;
 }
 switch($int{1}){
  case 1:
   switch($int{2}){
    case 0:$str.='ten-';break;
    case 1:$str.='eleven-';break;
    case 2:$str.='twelve-';break;
    case 3:$str.='thirteen-';break;
    case 4:$str.='fourteen-';break;
    case 5:$str.='fifteen-';break;
    case 6:$str.='sixteen-';break;
    case 7:$str.='seventeen-';break;
    case 8:$str.='eighteen-';break;
    case 9:$str.='nineteen-';break;
   }
   $doOnes=false;
  break;
  case 2:$str.='twenty-';break;
  case 3:$str.='thirty-';break;
  case 4:$str.='forty-';break;
  case 5:$str.='fifty-';break;
  case 6:$str.='sixty-';break;
  case 7:$str.='seventy-';break;
  case 8:$str.='eighty-';break;
  case 9:$str.='ninety-';break;
 }
 if($doOnes){
  switch($int{2}){
   case 1:$str.='one-';break;
   case 2:$str.='two-';break;
   case 3:$str.='three-';break;
   case 4:$str.='four-';break;
   case 5:$str.='five-';break;
   case 6:$str.='six-';break;
   case 7:$str.='seven-';break;
   case 8:$str.='eight-';break;
   case 9:$str.='nine-';break;
 }}
 $str=substr($str,0,-1);
 if($neg){
  $str='negative '.$str;
 }
 if($int=='000'){
  $str='zero';
 }
 return $str;
}

Hope this helps someone,
-Blayde
mickycole at hotmail dot com 19-Jul-2006 12:01
In responce to James Baker's sencence case function.
Great function however i would make one slight variation being that it doesn't take into account the fact that a capital is required after a new paragraph so i modified it to check for /r and /n as follows:
<?PHP
/*/ Author : James Baker /*/
function sentenceCase($s){
  
$str = strtolower($s);
  
$cap = true;
 
   for(
$x = 0; $x < strlen($str); $x++){
      
$letter = substr($str, $x, 1);
       if(
$letter == "." || $letter == "!" || $letter == "?" || $letter == "\n" || $letter == "\r"){
          
$cap = true;
       }elseif(
$letter != " " && $cap == true){
          
$letter = strtoupper($letter);
          
$cap = false;
       }
     
      
$ret .= $letter;
   }
 
   return
$ret;
}
?>
administrador(ensaimada)sphoera(punt)com 02-Mar-2006 06:10
I've prepared this simple function to obtain a string delimited between tags (not only XML tags!). Anybody needs something like this?.

<?php

function get_string_between($string, $start, $end){
   
$string = " ".$string;
    
$ini = strpos($string,$start);
     if (
$ini == 0) return "";
    
$ini += strlen($start);    
    
$len = strpos($string,$end,$ini) - $ini;
     return
substr($string,$ini,$len);
}

$string = "this [custom] function is useless!!";
echo
get_string_between($string,"[","]");
// must return "custom";
?>
more functions at http://www.sphoera.com
SteveRusin 24-Feb-2006 11:00
The functions below:

function beginsWith( $str, $sub )
function endsWith( $str, $sub )

Are correct, but flawed.  You'd need to use the === operator instead:

function beginsWith( $str, $sub ) {
   return ( substr( $str, 0, strlen( $sub ) ) === $sub );
}
function endsWith( $str, $sub ) {
   return ( substr( $str, strlen( $str ) - strlen( $sub ) ) === $sub );
}

Otherwise, endsWith would return "foobar.0" ends with ".0" as well as "0" or "00" or any amount of zeros because numerically .0 does equal 0.
navarr at gmail dot com 20-Dec-2005 06:24
stripos for PHP4.x

<?php
 
function stripos($haystack,$needle) {
    return
strpos(strtoupper($haystack),strtoupper($needle));
  }
?>
dkflbk at nm dot ru 11-Dec-2005 08:58
I needed str2bin() function for one of my project, so if some one else is want to use it, have fun :)

<?php
/**
 *    Returns an ASCII string containing
 *    the binary representation of the input data .
**/
function str2bin($str, $mode=0) {
   
$out = false;
    for(
$a=0; $a < strlen($str); $a++) {
       
$dec = ord(substr($str,$a,1));
       
$bin = '';
        for(
$i=7; $i>=0; $i--) {
            if (
$dec >= pow(2, $i) ) {
               
$bin .= "1";
               
$dec -= pow(2, $i);
            } else {
               
$bin .= "0";
            }
        }
       
/* Default-mode */
       
if ( $mode == 0 ) $out .= $bin;
       
/* Human-mode (easy to read) */
       
if ( $mode == 1 ) $out .= $bin . " ";
       
/* Array-mode (easy to use) */
       
if ( $mode == 2 ) $out[$a] = $bin;
    }
    return
$out;
}
?>
admin at fivestarbuy dot com 21-Oct-2005 09:18
This example lets you parse an unparsed strings variables. Warning: This could cause security leaks if you allow users to pass $variables through this engine. I recommend only using this for your Content Management System.

<?
$mytime
=time();
$mydog="My Dog Ate My PHP!";

# Your Parsing String:
$s1 = 'Hyphen Variable Preserving: $mytime, and $mydog';
echo
"Before: <br><br>$s1<br><br>";

# Remember, wherever you define this, it will not be defined GLOBAL into the function
# which is why we define it here. Defining it global could lead to security issues.
$vardata=get_defined_vars();

# Parse the string
$s1 = StrParse($s1,$vardata);

echo
"After: <br><br>$s1";

function
StrParse($str,$vardata) {
# Takes a string, or piece of data, that contains PHP Variables
 
 # For example, unparsed variables like:  Test using time: $mytime
 # This example shows $mytime, and not the actual variable value.
 # The end result shows the actual variable value of $mytime.

 # This is useful for building a content management system,
 # and directing your variables into your content data,
 # where content is stored in a file or database, unparsed.
 # Of course this could slow down page loads, but it's a good way
 # to parse data from current variables into your loaded new data
 # making it compatible.
 
# Then the variables are replaced with the actual variable..
$getvarkeys=array_keys($vardata);
$ret=$str;
for (
$x=0; $x < count($getvarkeys); $x++) {
   
$myvar=$getvarkeys[$x];
   
#echo "Variable: " . $myvar . " [" . $vardata[$myvar] . "]<br>";
   
$ret=str_replace('$' . $myvar, $vardata[$myvar], $ret);
}
return
$ret;

}

?>
17-Oct-2005 03:27
to: james dot d dot baker at gmail dot com

PHP has a builtin function  for doing what your function does,

http://php.net/ucfirst
http://php.net/ucwords
14-Oct-2005 08:24
Updated; used to test for input as an array, should have been a string, added some validation of the input while I was at it.  Enjoy.

<?php
/*----------        Directory Tree to Array        ----------//
  Takes base directory, returns an associative array
       containing each directory name as an associative key
       and each file as an indexed entry in the appropriate
       directory.
  If no path is provided, it uses the current directory
  If $style == 1, it will return a sorted, non-associative
       array

  By Peter Dolan
  www.peterd.net
  Updated 2005-10-12

  Use it as much as you like for whatever
  For my own entertainment, please let me know if you do
//-----------------------------------------------------------*/
function dirTreeToArray( $path = "./", $style="0" ) {
     if ( !
is_string($path) or !($style==0 or $style==1) ) die("Improper arguments in function dirTreeToArray(string \$path, \$style = {0, 1})");
     else {
       
$path = trim($path);
       
$path = str_replace("\\", "/", $path);
        if(
'/' == $path{strlen($path)-1} || '\'' == $path{strlen($path)-1} ) $path = substr($path, 0, strlen($path)-1);
     }
    
$tree = array();
    
$arrayPointer = & $tree;
   if (
$handle = opendir($path) ) {
       while (
$fileName = readdir($handle) ) {
             if (
$fileName != "." and $fileName != ".." ) {
                      
$newPath = "$path/$fileName";        // Used for testing directory or file property
                
if ( is_dir($newPath) ) {
                  
$dummyPointer = & $arrayPointer;        // Save the current pointer
                    
if ( $style == 0 ) $arrayPointer = & $arrayPointer[$fileName];    // Drop the pointer into a subdirectory
                    
elseif ( $style == 1 ) $arrayPointer = & $arrayPointer[];        // Drop the pointer into a subdirectory
                    
$arrayPointer = dirTreeToArray($newPath, $style);            // Process the new subdirectory
                  
if ( $style == 1 ) sort($arrayPointer);    // Sort it if we're in a non-associative mode
                    
$arrayPointer = & $dummyPointer;        // Bring the pointer back up a level
              
}
                 elseif (
is_file($newPath) ) $arrayPointer[] = $fileName;    // Enter the files
          
}
       }
               return
$tree;
   }
   else die(
"Failed to open directory $path in function dirTreeToArray(string \$path, \$style = {0, 1})");
}
?>
tim_meredith at s4s dot org 13-Oct-2005 01:32
--Convert MSWord Quotes--
Use this before any conversion to HTML entities or characters to clean up a form entry cut and pasted from MSWord.

function fixword($scratch)
{
    $start=chr(226).chr(128);
    $word=array();$fixword=array();
    $word[]=$start.chr(152);$fixword[]="'";
    $word[]=$start.chr(153);$fixword[]="'";
    $word[]=$start.chr(156);$fixword[]="\"";
    $word[]=$start.chr(157);$fixword[]="\"";
    return str_replace($word, $fixword, $scratch);
}
webmaster at cafe-clope dot net 13-Aug-2005 04:40
A comprehensive concatenation function, that works with array and strings

<?php
function str_cat() {
 
$args = func_get_args() ;
   
 
// Asserts that every array given as argument is $dim-size.
  // Keys in arrays are stripped off.
  // If no array is found, $dim stays unset.
 
foreach($args as $key => $arg) {
    if(
is_array($arg)) {
      if(!isset(
$dim))
       
$dim = count($arg) ;
      elseif(
$dim != count($arg))
        return
FALSE ;
     
$args[$key] = array_values($arg) ;
    }
  }
       
 
// Concatenation
 
if(isset($dim)) {
   
$result = array() ;
    for(
$i=0;$i<$dim;$i++) {
     
$result[$i] = '' ;
      foreach(
$args as $arg)
       
$result[$i] .= ( is_array($arg) ? $arg[$i] : $arg ) ;
    }
    return
$result ;
  } else {
    return
implode($args) ;
  }
}
?>

A simple example :

<?php
str_cat
(array(1,2,3), '-', array('foo' => 'foo', 'bar' => 'bar', 'noop' => 'noop')) ;
?>

will return :
Array (
  [0] => 1-foo
  [1] => 2-bar
  [2] => 3-noop
)

More usefull :

<?php
$myget
= $_GET ; // retrieving previous $_GET values
$myget['foo'] = 'b a r' ; // changing one value
$myget = str_cat(array_keys($myget), '=', array_map('rawurlencode', array_values($myget))) ;
$querystring = implode(ini_get('arg_separator.output'), $myget)) ;
?>

will return a valid querystring with some values changed.

Note that <?php str_cat('foo', '&', 'bar') ; ?> will return 'foo&bar', while <?php str_cat(array('foo'), '&', 'bar') ; ?> will return array(0 => foo&bar)
t0russ at gmail dot com 14-Jun-2005 10:38
to kristin at greenaple dot on dot ca:
thanx for sharing.
your function in recursive form proved to be slightly faster and it returns false (as it should) when the character is not found instead of number 0:
<?php
function strnposr($haystack, $needle, $occurance, $pos = 0) {
    return (
$occurance<2)?strpos($haystack, $needle, $pos):strnposr($haystack,$needle,$occurance-1,strpos($haystack, $needle, $pos) + 1);
}
?>
rh at richardhoward dot net 05-Jun-2005 11:41
<?php
/**
Utility class: static methods for cleaning & escaping untrusted (i.e.
user-supplied) strings.

Any string can (usually) be thought of as being in one of these 'modes':

pure = what the user actually typed / what you want to see on the page /
       what is actually stored in the DB
gpc  = incoming GET, POST or COOKIE data
sql  = escaped for passing safely to RDBMS via SQL (also, data from DB
       queries and file reads if you have magic_quotes_runtime on--which
       is rare)
html = safe for html display (htmlentities applied)

Always knowing what mode your string is in--using these methods to
convert between modes--will prevent SQL injection and cross-site scripting.

This class refers to its own namespace (so it can work in PHP 4--there is no
self keyword until PHP 5). Do not change the name of the class w/o changing
all the internal references.

Example usage: a POST value that you want to query with:
$username = Str::gpc2sql($_POST['username']);
*/

//This sets SQL escaping to use slashes; for Sybase(/MSSQL)-style escaping
// ( ' --> '' ), set to true.
define('STR_SYBASE', false);

class
Str {
    function
gpc2sql($gpc, $maxLength = false)
    {
        return
Str::pure2sql(Str::gpc2pure($gpc), $maxLength);
    }
    function
gpc2html($gpc, $maxLength = false)
    {
        return
Str::pure2html(Str::gpc2pure($gpc), $maxLength);
    }
    function
gpc2pure($gpc)
    {
        if (
ini_get('magic_quotes_sybase'))
           
$pure = str_replace("''", "'", $gpc);
        else
$pure = get_magic_quotes_gpc() ? stripslashes($gpc) : $gpc;
        return
$pure;
    }
    function
html2pure($html)
    {
        return
html_entity_decode($html);
    }
    function
html2sql($html, $maxLength = false)
    {
        return
Str::pure2sql(Str::html2pure($html), $maxLength);
    }
    function
pure2html($pure, $maxLength = false)
    {
        return
$maxLength ? htmlentities(substr($pure, 0, $maxLength))
                          :
htmlentities($pure);
    }
    function
pure2sql($pure, $maxLength = false)
    {
        if (
$maxLength) $pure = substr($pure, 0, $maxLength);
        return (
STR_SYBASE)
               ?
str_replace("'", "''", $pure)
               :
addslashes($pure);
    }
    function
sql2html($sql, $maxLength = false)
    {
       
$pure = Str::sql2pure($sql);
        if (
$maxLength) $pure = substr($pure, 0, $maxLength);
        return
Str::pure2html($pure);
    }
    function
sql2pure($sql)
    {
        return (
STR_SYBASE)
               ?
str_replace("''", "'", $sql)
               :
stripslashes($sql);
    }
}
?>
james dot d dot baker at gmail dot com 27-May-2005 10:45
<?php
/*
Written By James Baker, May 27th 2005

sentenceCase($string);
    $string: The string to convert to sentence case.

Converts a string into proper sentence case (First letter of each sentance capital, all the others smaller)

Example Usage:
echo sentenceCase("HELLO WORLD!!! THIS IS A CAPITALISED SENTENCE. this isn't.");

Returns:
Hello world!!! This is a capitalised sentence. This isn't.
*/

function sentenceCase($s){
   
$str = strtolower($s);
   
$cap = true;
   
    for(
$x = 0; $x < strlen($str); $x++){
       
$letter = substr($str, $x, 1);
        if(
$letter == "." || $letter == "!" || $letter == "?"){
           
$cap = true;
        }elseif(
$letter != " " && $cap == true){
           
$letter = strtoupper($letter);
           
$cap = false;
        }
       
       
$ret .= $letter;
    }
   
    return
$ret;
}
?>
php at moechofe dot com 26-Apr-2005 06:34
<?php
 
/*
  * str_match
  *
  * return a string with only cacacteres defined in a expression return false if the expression is not valid
  *
  * @param $str string the string
  * @param $match the expression based on the class definition off a PCRE regular expression.
  *   the '[', ']', '\' and '^' at class start need to be escaped.
  *   like : -a-z0-9_@.
  */
 
function str_match( $str, $match )
  {
   
$return = '';
    if(
eregi( '(.*)', $match, $class ) )
    {
     
$match = '['.$regs[1].']';
      for(
$i=0; $i<strlen($str); $i++ )
      if(
ereg( '['.$class[1].']', $str[$i] ) )
     
$return .= $str{$i};
      return
$return;
    }
    else return
false;
  }

 
/*
  * example
  * accept only alphanum caracteres from the GET/POST parameters 'a'
  */

 
if( ! empty($_REQUEST['a']) )
   
$_REQUEST['a'] = str_match( $_REQUEST['a'], 'a-zA-Z0-9' );
  else
   
$_REQUEST['a'] = 'default';
?>
Pommef 19-Mar-2005 01:15
Example: Give me everything up to the fourth occurance of '/'.

<?php

   $haystack
= "/home/username/www/index.php";
  
$needle = "/";
 
   function
strnpos($haystack, $needle, $occurance, $pos = 0) {
       
       
$res = implode($needle,$haystack);
       
       
$res = array_slice($res, $pos$occurance);
       
        return
explode ($needle,$res);
    }
?>
kristin at greenapple dot on dot ca 02-Jan-2005 08:32
I really searched for a function that would do this as I've seen it in other languages but I couldn't find it here. This is particularily useful when combined with substr() to take the first part of a string up to a certain point.

strnpos() - Find the nth position of needle in haystack.

<?php

   
function strnpos($haystack, $needle, $occurance, $pos = 0) {
       
        for (
$i = 1; $i <= $occurance; $i++) {
           
$pos = strpos($haystack, $needle, $pos) + 1;
        }
        return
$pos - 1;
       
    }

?>

Example: Give me everything up to the fourth occurance of '/'.

<?php

    $haystack
= "/home/username/www/index.php";
   
$needle = "/";
   
   
$root_dir = substr($haystack, 0, strnpos($haystack, $needle, 4));
   
    echo
$root_dir;
   
?>

Returns: /home/username/www

Use this example with the server variable $_SERVER['SCRIPT_NAME'] as the haystack and you can self-discover a document's root directory for the purposes of locating global files automatically!
20-Dec-2004 08:31
In response to hackajar <matt> yahoo <trot> com,

No string-to-array function exists because it is not needed. If you reference a string with an offset like you do with an array, the character at that offset will be return. This is documented in section III.11's "Strings" article under the "String access and modification by character" heading.
andy a t onesandzeros d o t biz 09-Nov-2004 02:54
I use these little doo-dads quite a bit. I just thought I'd share them and maybe save someone a little time. No biggy. :)

// returns true if $str begins with $sub
function beginsWith( $str, $sub ) {
    return ( substr( $str, 0, strlen( $sub ) ) == $sub );
}

// return tru if $str ends with $sub
function endsWith( $str, $sub ) {
    return ( substr( $str, strlen( $str ) - strlen( $sub ) ) == $sub );
}

// trims off x chars from the front of a string
// or the matching string in $off is trimmed off
function trimOffFront( $off, $str ) {
    if( is_numeric( $off ) )
        return substr( $str, $off );
    else
        return substr( $str, strlen( $off ) );
}

// trims off x chars from the end of a string
// or the matching string in $off is trimmed off
function trimOffEnd( $off, $str ) {
    if( is_numeric( $off ) )
        return substr( $str, 0, strlen( $str ) - $off );
    else
        return substr( $str, 0, strlen( $str ) - strlen( $off ) );
}
[tab!] 27-Oct-2004 12:29
//
// string strtrmvistl(  string str, [int maxlen = 64],
//                      [bool right_justify = false],
//                      [string delimter = "<br>\n"])
//
// splits a long string into two chunks (a start and an end chunk)
// of a given maximum length and seperates them by a given delimeter.
// a second chunk can be right-justified within maxlen.
// may be used to 'spread' a string over two lines.
//

function strtrmvistl($str, $maxlen = 64, $right_justify = false, $delimter = "<br>\n") {
    if(($len = strlen($str = chop($str))) > ($maxlen = max($maxlen, 12))) {
        $newstr = substr($str, 0, $maxlen - 3);

        if($len > ($maxlen - 3)) {
            $endlen = min(($len - strlen($newstr)), $maxlen - 3);
            $newstr .= "..." . $delimter;

            if($right_justify)
                $newstr .= str_pad('', $maxlen - $endlen - 3, ' ');

            $newstr .= "..." . substr($str, $len - $endlen);
        }

        return($newstr);
    }

    return($str);
}
terry dot greenlaw at logicalshift dot com 11-Aug-2004 10:52
Here's a simpler "simplest" way to toggle through a set of 1..n colors for web backgrounds:

<?php
$colours
= array('#000000', '#808080', '#A0A0A0', '#FFFFFF');

// Get a colour
$color = next($colors) or $color = reset($colors);
?>

The code doesn't need to know anything about the number of elements being cycled through. That way you won't have to tracking down all the code when changing the number of colors or the color values.

 
show source | credits | sitemap | contact | advertising | mirror sites