str_ireplace

(PHP 5)

str_ireplace --  Case-insensitive version of str_replace().

Description

mixed str_ireplace ( mixed search, mixed replace, mixed subject [, int &count] )

This function returns a string or an array with all occurrences of search in subject (ignoring case) replaced with the given replace value. If you don't need fancy replacing rules, you should generally use this function instead of eregi_replace() or preg_replace() with the i modifier.

If subject is an array, then the search and replace is performed with every entry of subject, and the return value is an array as well.

If search and replace are arrays, then str_ireplace() takes a value from each array and uses them to do search and replace on subject. If replace has fewer values than search, then an empty string is used for the rest of replacement values. If search is an array and replace is a string; then this replacement string is used for every value of search.

例子 1. str_ireplace() example

<?php
$bodytag
= str_ireplace("%body%", "black", "<body text=%BODY%>");
?>

This function is binary safe.

注: As of PHP 5.0.0 the number of matched and replaced needles will be returned in count which is passed by reference. Prior to PHP 5.0.0 this parameter is not available.

See also: str_replace(), ereg_replace(), preg_replace(), and strtr().


add a note add a note User Contributed Notes
hans111
02-Aug-2006 04:25
<?php
if(!function_exists('str_ireplace')) {
   function
str_ireplace($search, $replacement, $string){
      
$delimiters = array(1,2,3,4,5,6,7,8,14,15,16,17,18,19,20,21,22,23,24,25,
      
26,27,28,29,30,31,33,247,215,191,190,189,188,187,186,
      
185,184,183,182,180,177,176,175,174,173,172,171,169,
      
168,167,166,165,164,163,162,161,157,155,153,152,151,
      
150,149,148,147,146,145,144,143,141,139,137,136,135,
      
134,133,132,130,129,128,127,126,125,124,123,96,95,94,
      
63,62,61,60,59,58,47,46,45,44,38,37,36,35,34);
       foreach (
$delimiters as $d) {
           if (
strpos($string, chr($d))===false){
              
$delimiter = chr($d);
               break;
           }
       }
       if (!empty(
$delimiter)) {
           return
preg_replace($delimiter.quotemeta($search).$delimiter.'i', $replacement, $string);
       }
       else { 
          
trigger_error('Homemade str_ireplace could not find a proper delimiter.', E_USER_ERROR);
       }
   }
}
?>
hfuecks at nospam dot org
04-Jul-2005 05:07
Note that character case is being defined by your server's locale setting, which effects strings containing non-ASCII characters.

See strtolower() - http://www.php.net/strtolower and comments - internally str_ireplace converts $search and $replace to lowercase to find matches.
daevid at daevid dot com
06-Apr-2005 04:14
here's a neat little function I whipped up to do HTML color coding of SQL strings.

<?php
/**
 * Output the HTML debugging string in color coded glory for a sql query
 * This is very nice for being able to see many SQL queries
 * @access    public
 * @return    void. prints HTML color coded string of the input $query.
 * @param    string $query The SQL query to be executed.
 * @author    Daevid Vincent [daevid@LockdownNetworks.com]
 *  @version    1.0
 * @date        04/05/05
 * @todo    highlight SQL functions.
 */
function SQL_DEBUG( $query )
{
   if(
$query == '' ) return 0;

   global
$SQL_INT;
   if( !isset(
$SQL_INT) ) $SQL_INT = 0;

  
//[dv] this has to come first or you will have goofy results later.
  
$query = preg_replace("/['\"]([^'\"]*)['\"]/i", "'<FONT COLOR='#FF6600'>$1</FONT>'", $query, -1);

  
$query = str_ireplace(
                           array (
                                  
'*',
                                  
'SELECT ',
                                  
'UPDATE ',
                                  
'DELETE ',
                                  
'INSERT ',
                                  
'INTO',
                                  
'VALUES',
                                  
'FROM',
                                  
'LEFT',
                                  
'JOIN',
                                  
'WHERE',
                                  
'LIMIT',
                                  
'ORDER BY',
                                  
'AND',
                                  
'OR ', //[dv] note the space. otherwise you match to 'COLOR' ;-)
                                  
'DESC',
                                  
'ASC',
                                  
'ON '
                                
),
                           array (
                                  
"<FONT COLOR='#FF6600'><B>*</B></FONT>",
                                  
"<FONT COLOR='#00AA00'><B>SELECT</B> </FONT>",
                                  
"<FONT COLOR='#00AA00'><B>UPDATE</B> </FONT>",
                                  
"<FONT COLOR='#00AA00'><B>DELETE</B> </FONT>",
                                  
"<FONT COLOR='#00AA00'><B>INSERT</B> </FONT>",
                                  
"<FONT COLOR='#00AA00'><B>INTO</B></FONT>",
                                  
"<FONT COLOR='#00AA00'><B>VALUES</B></FONT>",
                                  
"<FONT COLOR='#00AA00'><B>FROM</B></FONT>",
                                  
"<FONT COLOR='#00CC00'><B>LEFT</B></FONT>",
                                  
"<FONT COLOR='#00CC00'><B>JOIN</B></FONT>",
                                  
"<FONT COLOR='#00AA00'><B>WHERE</B></FONT>",
                                  
"<FONT COLOR='#AA0000'><B>LIMIT</B></FONT>",
                                  
"<FONT COLOR='#00AA00'><B>ORDER BY</B></FONT>",
                                  
"<FONT COLOR='#0000AA'><B>AND</B></FONT>",
                                  
"<FONT COLOR='#0000AA'><B>OR</B> </FONT>",
                                  
"<FONT COLOR='#0000AA'><B>DESC</B></FONT>",
                                  
"<FONT COLOR='#0000AA'><B>ASC</B></FONT>",
                                  
"<FONT COLOR='#00DD00'><B>ON</B> </FONT>"
                                
),
                          
$query
                        
);

   echo
"<FONT COLOR='#0000FF'><B>SQL[".$SQL_INT."]:</B> ".$query."<FONT COLOR='#FF0000'>;</FONT></FONT><BR>\n";

  
$SQL_INT++;

}
//SQL_DEBUG
?>
aidan at php dot net
21-Aug-2004 03:58
If you want to do string highlighting, for example highlighting search terms, try str_highlight().

http://aidan.dotgeek.org/lib/?file=function.str_highlight.php
aidan at php dot net
31-May-2004 01: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