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

search for in the

stripslashes> <stripcslashes
Last updated: Fri, 20 May 2011

view this page in

stripos

(PHP 5)

striposEncuentra la posición de la primera aparición de un string insensible a mayúsculas y minúsculas

Descripción

int stripos ( string $haystack , string $needle [, int $offset = 0 ] )

Devuelve la posición numérica de la primera aparición del needle en el string haystack.

A diferencia de strpos(), stripos() es insensible a mayúsculas y minúsculas.

Parámetros

haystack

El string en donde buscar.

needle

Nótese que needle puede ser un string de uno o más caracteres.

Si needle no es un string, será convertido a un integer y se aplicará como el valor ordinal de un caracter.

offset

El parámetro opcional offset permite especificar en cual caracter del haystack comenzar la búsqueda. La posición devuelta sigue siendo relativa al inicio del haystack.

Valores devueltos

Devuelve la posición como un integer. Si no se encuentra el needle, stripos() devolverá boolean FALSE.

Warning

Esta función quizá devuelve Boolean FALSE, pero quizá también devuelve un valor non-Boolean que se evaluará como FALSE, como 0 o "". Por favor lea la sección en Booleans para más información. Use el operador === para testear el valor devuelto por esta función.

Ejemplos

Example #1 Ejemplos de stripos()

<?php
$findme    
'a';
$mystring1 'xyz';
$mystring2 'ABC';

$pos1 stripos($mystring1$findme);
$pos2 stripos($mystring2$findme);

// No, 'a' sin duda no está en 'xyz'
if ($pos1 === false) {
    echo 
"The string '$findme' was not found in the string '$mystring1'";
}

// Nótese el uso de ===.  Usar sólo == no funcionará como se espera
// debido a que la posición de 'a' es el 0º (primer) caracter.
if ($pos2 !== false) {
    echo 
"We found '$findme' in '$mystring2' at position $pos2";
}
?>

Notas

Note: Esta función es segura binariamente.

Ver también

  • strpos() - Busca la posición de la primera ocurrencia de una cadena
  • strrpos() - Encuentra la posición de la última aparición de un substring en un string
  • strrchr() - Encuentra la última aparición de un caracter en un string
  • substr() - Devuelve parte de una cadena
  • stristr() - strstr insensible a mayúsculas y minúsculas
  • strstr() - Buscar la primera aparición de una cadena
  • strripos() - Encuentra la posición de la última aparición de un string insensible a mayúsculas y minúsculas en un string
  • str_ireplace() - Versión insensible a mayúsculas y minúsculas de str_replace



stripslashes> <stripcslashes
Last updated: Fri, 20 May 2011
 
add a note add a note User Contributed Notes stripos
guanfenglin at gmail dot com 29-Sep-2010 03:19
Just a friendly hint:

I came across to this scenario, check to see if an URL string contains http, if no then prepend "http" to the URL string

<?php
$url
= (stripos($url,"http")==false) ? "http".$url : $url;
?>

now, this will always add the http:// to the URL string even the URL string already has http

It is because stripos($url,"http") will return false if no http found, and stripos($url, "http") will return 0 if it is found (being at the start of the string) , and (0==false) is a true condition

therefore, to fix this problem, we have to use (===) to compare the value type as well:

<?php
$url
= (stripos($url,"http")===false) ? "http".$url : $url;
?>

James Lin
gireeshda at yahoo dot com 08-Jun-2010 05:12
function "stripos" not working in php file without .php extension.  Returns error. Seems to be a bug.

To ensure that stripos works in all php version/platforms in files without .php extension, use the following code:

strpos(strtolower($haystack), strtolower($needle), [ $offset = 0 ] )
vgiralt 19-Aug-2009 09:38
The mail validator example is NON CONFORMANT with SMTP mail RFCs. Valid characters for Internet e-mail address are more than the ones listed here. Implementing such lame validator is a big disservice to the whole Internet.

Those interested can read RFC 5322. In short, the valid characters are different on both sides of the @ sign, so, before applying this fast technique the address should be exploded into the two side strings, and then, use different valid character strings for the local-part and the domain.

A local part can be any alphabetic or digit US-ASCII character plus "!#$%&'*+-/=?^_`{|}~", and then, if it is enclosed in double-quotes ("), it can be any US-ASCII character except double-quote (") and back-slash(\).

The domain can be any printable US-ASCII characters not including "[", "]", or "\".

And then, this could be overridden with the advent of internationalized domains, that can use UTF-8 character sets.

Implementation of the validator is left as an exercise for the reader.
manualregexp 18-May-2009 10:52
Fast email validator using stripos to check for valid characters.

<?php
function validate_email($value) {
  
$chars="ABCDEFGHIJKLMNOPQRSTUVWXYZ".
                
"abcdefghijklmnopqrstuvwxyz0123456789@._";
  
$at=0/* at sign */
  
$dot=0; /* dot after at */
  
$end_pos = strlen($value)-1;

   for (
$i=0;$i<strlen($value);$i++) {
     
$c = $value[$i];
      if (
stripos($chars, $c)===false) return false;
      if (
$c=="@") $at++;
      if (
$at==1 && $c==".") $dot++;
      if (
$at>1) return false;
     
/* Don't start or end with an '@' or a '.'
       * No @'s or .'s next to each other.
       */
     
if (($c=="." || $c=="@") &&
             (
$i==0 || $i==$end_pos || $prev_c=="." || $prev_c=="@"))
              return
false;
     
$prev_c=$c;
   }
   return (
$at==1 && $dot>0);
}
?>
emperorshishire at gmail dot com 25-Feb-2009 03:31
I found myself needing to find the first position of multiple needles in one haystack.  So I wrote this little function:

<?php
function multineedle_stripos($haystack, $needles, $offset=0) {
    foreach(
$needles as $needle) {
       
$found[$needle] = stripos($haystack, $needle, $offset);
    }
    return
$found;
}

// It works as such:
$haystack = "The quick brown fox jumps over the lazy dog.";
$needle = array("fox", "dog", ".", "duck")
var_dump(multineedle_stripos($haystack, $needle));
/* Output:
   array(3) {
     ["fox"]=>
     int(16)
     ["dog"]=>
     int(40)
     ["."]=>
     int(43)
     ["duck"]=>
     bool(false)
   }
*/
?>
Ysangkok 06-Mar-2008 03:44
@henke:

No. It does NOT make a warning if the needle isn't found. This is false.
henke at henke37 dot cjb dot net 09-Dec-2007 06:48
This function will raise a warning if the needle was not found. Be sure to use @ to suppress it if you want the strpos like behavior of only returning false.
hpavon at gmail dot com 19-Jul-2007 07:54
To shane_at_51smith-dot-nl
Fine but not useful if you want to use stripos 3rd param òffset´ for instance to find all occurences of `needle´.
Again rchillet and heavyraptor solution is best though you'd better keep to-lowercase strings outside the function if you're planning to loop through `haystack´ like this:

$lower_haystack = strtolower($haystack);
$lower_needle = strtolower($needle);
$offset = 0;
//... looping over haystack
while ($offset !== false) {
    $offset = strpos($lower_haystack, $lower_needle, $offset);
    //... some funny stuff here
}

Using rchillet-heavyraptor function here would slow down performance. Solution: don't invent any function
shane_at_51smith-dot-nl 03-Jul-2007 07:46
Yet another stripos for php4 alternative:
<?php
function stripos($haystack, $needle){
    return
strpos($haystack, stristr( $haystack, $needle ));
}
$strTest = "The brown fox jumped over the Fence";
echo
stripos($strTest, 'fence');//30
?>
grf at post dot cz 20-Mar-2007 12:57
(i'm very sorry for some mistakes in my yesterday's post :'[ )

this would to work with any language, i hope.
tested on czech (eastern europe) lang.

<?php
/****************************************
*    SAFE HIGHLIGHT
****************************************/
/**
 * function finds and encase every string in a $needleArr array with
 * strings $shearLft (from the left side) and $shearRgt (guess from which
 * side).
 * already encased needles are IGNORED for any other step, so order
 * of needles in $needleArr is pretty important.
 *
 * function is searching needles in case-insensitive mode,
 * but case in the subject is saved.
 *
 * can you do it better? so, do it.
 *
 * @param array $needleArr array of needles
 * @param string $shearLft left shear
 * @param string $shearRgt right shear
 * @param string $subject subject
 * @param string $encoding encoding ('utf-8' is default)
 *
 * @author griffin
 */
function safeHighlight( $needleArr, $shearLft, $shearRgt, $subject, $encoding = 'utf-8')
{
   
   
// encoding
   
$e = $encoding;
   
   
// oh, no needles
   
if( !is_array( $needleArr))
        return
$subject;
       
   
// empty keys throw-off, only unique, reindex
   
$nA = array_values(
           
array_unique(
               
array_diff( $needleArr, array(''))
            )
        );
   
   
// needle count
   
if( !($nC = count( $nA)))
        return
$subject; // nothing to hl
       
    // shear length
   
if( !(($rLL = mb_strlen( $rL = $shearLft, $e))
    + (
$rRL = mb_strlen( $rR = $shearRgt, $e))))
        return
$subject; // no shears
   
    // subject length
   
if( !($sL = mb_strlen( $s = $subject, $e)))
        return
null; // empty subject
       
    // subject in lowercase (we need to aviod
    // using mb_stripos due to PHP version)
   
$sW = mb_strtolower( $s, $e);
   
   
// masking ~ 0=not changed, 1=changed
   
$m = str_repeat( '0', $sL);
   
   
// loop for each needle
   
for( $n=0; $n<$nC; $n++)
    {
       
       
// needle string loWercase
       
$nW = mb_strtolower( $nA[ $n], $e);
       
       
$o = 0; // offset
       
$nL = mb_strlen( $nW, $e); // needle length

        // search needle
       
while( false !== ($p = mb_strpos( $sW, $nW, $o, $e)))
        {
           
// oh hurrey, needle found on $p position
           
            // is founded needle already modified? (in full-length)
           
for( $q=$p; $q<($p+$nL); $q++)
                if(
$m[ $q])
                {
                   
// ai, caramba. already modified, jump over
                   
$o+= $nL;
                   
                   
// continue for while() loop - not for for() loop!
                   
continue 2;
                }
           
           
// explode subject and mask into three parts
            // partA|needle|partB
           
$sE[0] = mb_substr( $s, 0, $p, $e);
           
$sE[1] = mb_substr( $s, $p, $nL, $e);
           
$sE[2] = mb_substr( $s, $p+$nL, $sL-$p-$nL, $e);
           
           
// mask
            // partA|partB (needle not needed)
           
$mE[0] = mb_substr( $m, 0, $p, $e);
           
$mE[1] = mb_substr( $m, $p+$nL, $sL-$p-$nL, $e);
           
           
// apply shears
           
$sE[1] = $rL.$sE[1].$rR;
           
           
// update sunject length
           
$sL+= $rLL + $rRL;
           
           
// update mask
           
$m = $mE[0] . str_repeat( '1', $rLL + $nL + $rRL) . $mE[1];
           
           
// implode into a subject
           
$s = implode( $sE);
           
           
// update lowercase subject
           
$sW = mb_strtolower( $s, $e);
           
           
// increase offset
           
$o+= $rLL + $nL + $rRL;
           
           
// end of string reached
           
if( $o>=$sL)
                break;
           
        }
// while()
       
   
} // for( $n=0; $n<$nC; $n++)
   
    // oouu yeaaa, kick the subject out of the function
   
return $s;
   
}
// function safeHighlight()
/****************************************
*    END: SAFE HIGHLIGHT
****************************************/
?>
dazzle 16-Aug-2006 02:20
I recommend using the solution by rchillet for <PHP5

michiels solution is quite slow if you use it for long strings or call it many times.
michiel at mb-it dot nl 10-Jul-2006 11:03
Since the stripos-function is PHP5-only, the function below could give PHP4-users the same functionallity:

function stripos($string,$word)
{
   $retval = false;
   for($i=0;$i<=strlen($string);$i++)
   {
       if (strtolower(substr($string,$i,strlen($word))) == strtolower($word))
       {
           $retval = true;
       }
   }
   return $retval;
}
rchillet at hotmail dot com 28-Apr-2006 08:45
improvement the function of heavyraptor with int offset parametre.

if (!function_exists("stripos")) {
  function stripos($str,$needle,$offset=0)
  {
      return strpos(strtolower($str),strtolower($needle),$offset);
  }
}
heavyraptor 21-Mar-2006 02:59
If you're using PHP < 5, you can use this alternate function, same thing like stripos:

<?php
if (!function_exists("stripos")) {
  function
stripos($str,$needle) {
   return
strpos(strtolower($str),strtolower($needle));
  }
}
?>

Such a logical function but I hope it helps ...
sim 02-Oct-2004 05:17
Just to be explicit, the position index returned by strpos starts at 0, not 1. e.g. strpos('abc','a') returns 0.
aidan at php dot net 30-May-2004 05:36
This functionality is now implemented in the PEAR package PHP_Compat.

More information about using this function without upgrading your version of PHP can be found on the below link:

http://pear.php.net/package/PHP_Compat

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