str_ireplace

(PHP 5, PHP 7, PHP 8)

str_ireplace — Bir alt dizgenin bütün örneklerini yenisiyle değiştirirken harf büyüklüklerini dikkate almaz

Açıklama

str_ireplace(
    array|string $eski,
    array|string $yeni,
    string|array $konu,
    int &$sayı = null
): string|array

Harf büyüklüğüne duyarsız olarak konu dizgesi içindeki eski dizgelerinin her birini yeni dizgesiyle değiştirerek elde edilen dizi veya dizgeyi döndürür.

Metni sabit bir dizge yerine bir kalıba göre değiştirmek için preg_replace() işlevi i değiştiricisi ile kullanılabilir.

Bağımsız Değişkenler

Eğer eski ve yeni birer dizi ise str_replace() her diziden birer değer alıp bunları kullanarak konu dizgesinde arama ve yer değiştirme yapar. Eğer yeni dizisi eski dizisinden daha az değere sahipse eksik kalan yeni dizgelerin yerine boş dizgeler konur. Eğer eski bir dizi ve yeni bir dizge ise her eski dizgesinin yerine bu yeni dizgesi konur. Zıddı anlamlı değildir.

eski ve yeni birer dizi ise, elemanları baştan sona doğru işlenir.

eski

İğne olarak da bilinen, aranan değer. Birden çok iğneyi belirtmek için bir dizi kullanılabilir.

yeni

Bulunan eski değeriyle değiştirilecek değer. Çok sayıda yeni belirtmek için dizi kullanılabilir

konu

Samanlık olarak da bilinen, eskinin yenisiyle değiştirileceği dizi veya dizge.

konu bir dizi ise, eskiyi yenisi ile değiştirme işlemi dizinin her elemanına uygulanır ve dönen değer de bir dizi olur.

sayı

Eğer belirtilirse, değiştirilen dizgelerin sayısı bu bağımsız değişkende döndürülür.

Dönen Değerler

Yer değiştirmeler yapılmış dizge veya dizi döner.

Sürüm Bilgisi

Sürüm:	Açıklama
8.2.0	Büyük/küçük harf dönüşümü yalnızca ASCII karakterlere (baytlara) uygulandığından yerelin setlocale() ile atanması artık gerekmiyor. ASCII olmayan karakterlerin bayt değerleri karşılaştırılıyor.

Örnekler

Örnek 1 - str_ireplace() örneği

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

Notlar

Bilginize: Bu işlev ikil dosyalarla çalışırken dosya içeriğini değiştirmez.

Dikkat

Değiştirme sırası sorunsalı

str_ireplace() yer değiştirmeyi soldan sağa yaptığından, birden çok değiştirme yapılırken yenisi önceden yapılmış bir değişikliği değiştirebilir. str_replace() belgesindeki 2. örnek, bunun uygulamada sizi nasıl etkileyebileceğini gösterir.

Ayrıca Bakınız

str_replace() - Bir alt dizgenin bütün örneklerini yenisiyle değiştirir
preg_replace() - Düzenli ifadeye göre dizgede değişiklik yapar
strtr() - Belli karakterleri veya alt dizgeleri değiştirir

add a note

User Contributed Notes 11 notes

down

sawdust ¶

16 years ago


Here's a different approach to search result keyword highlighting that will match all keyword sub strings in a case insensitive manner and preserve case in the returned text. This solution first grabs all matches within $haystack in a case insensitive manner, and the secondly loops through each of those matched sub strings and applies a case sensitive replace in $haystack. This way each unique (in terms of case) instance of $needle is operated on individually allowing a case sensitive replace to be done in order to preserve the original case of each unique instance of $needle.

<?php
function highlightStr($haystack, $needle, $highlightColorValue) {
     // return $haystack if there is no highlight color or strings given, nothing to do.
    if (strlen($highlightColorValue) < 1 || strlen($haystack) < 1 || strlen($needle) < 1) {
        return $haystack;
    }
    preg_match_all("/$needle+/i", $haystack, $matches);
    if (is_array($matches[0]) && count($matches[0]) >= 1) {
        foreach ($matches[0] as $match) {
            $haystack = str_replace($match, '<span style="background-color:'.$highlightColorValue.';">'.$match.'</span>', $haystack);
        }
    }
    return $haystack;
}
?>

down

daevid at daevid dot com ¶

19 years ago


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

?>

down

Anteaus ¶

9 years ago


If you follow the instructions given here you will end up with code which works in php5.3 but which bugs-out in php5.4. Reason is that '&$count' (explicit pass by reference) is now an illegal construct.
Nasty, especially it leads to unreliable code which may work on test but not in production. Manual needs corrected!

down

aidan at php dot net ¶

20 years ago


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

down

ishutko at gmail dot com ¶

15 years ago


For function work with cirilic

setlocale (LC_ALL, 'ru_RU');

down

stepanic dot matija at gmail dot com ¶

14 years ago


FIX-ed problem with highlighting second 'o' OR 'a', in this string



<?php

function highlight_string ($haystack, $needle, $highlight_class) {

         // return $haystack if there is no highlight color or strings given, nothing to do.

        

        $first_encode='XXXXXXXXXXXXXXX';     //ENCODE string



        $second_encode='YYYYYYYYYYYYYYY';

        

        preg_match_all("/$needle+/i", $haystack, $matches);

        if (is_array($matches[0]) && count($matches[0]) >= 1) {

            foreach ($matches[0] as $match) {

                $haystack = str_replace($match, $first_encode.$match.$second_encode, $haystack);

            }

        }

        

        $haystack=str_replace(array($first_encode,$second_encode),

array('<font class="'.$highlight_class.'" >','</font>'),$haystack);

        

        return $haystack;

}

?>

down

Psudo - thepsudo at gmail dot com ¶

13 years ago


For highlighting without the overhead of regex and without destroying capitalization, try this:



<?php

function highlight($needle, $haystack){

    $ind = stripos($haystack, $needle);

    $len = strlen($needle);

    if($ind !== false){

        return substr($haystack, 0, $ind) . "<b>" . substr($haystack, $ind, $len) . "</b>" .

            highlight($needle, substr($haystack, $ind + $len));

    } else return $haystack;

}

?>



This example uses HTML bold tags, but you can easily change the highlighting method.

down

-2

Michael dot Bond at mail dot wvu dot edu ¶

16 years ago


This function will highlight search terms (Key Words in Context). 



The difference between this one and the ones below is that it will preserve the original case of the search term as well. So, if you search for "american" but in the original string it is "American" it will retain the capital "A" as well as the correct case for the rest of the string. 



<?php

function kwic($str1,$str2) {

    

    $kwicLen = strlen($str1);



    $kwicArray = array();

    $pos          = 0;

    $count       = 0;



    while($pos !== FALSE) {

        $pos = stripos($str2,$str1,$pos);

        if($pos !== FALSE) {

            $kwicArray[$count]['kwic'] = substr($str2,$pos,$kwicLen);

            $kwicArray[$count++]['pos']  = $pos;

            $pos++;

        }

    }



    for($I=count($kwicArray)-1;$I>=0;$I--) {

        $kwic = '<span class="kwic">'.$kwicArray[$I]['kwic'].'</span>';

        $str2 = substr_replace($str2,$kwic,$kwicArray[$I]['pos'],$kwicLen);

    }

        

    return($str2);

}

?>

down

-3

hfuecks at nospam dot org ¶

19 years ago


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.

down

-7

holblin at holblin dot com ¶

13 years ago


Warning with highlighting ...



I used :



<?php

$text = preg_replace('/('.$q.')/i','<span class=highlighting "">$1</span>' , $text);

?>



Because this line do not allow to highlight uppercase and lowercase correctly (transform uppercase to lowercase for exemple)



<?php

 $text = str_ireplace( $q , '<span class=highlighting "">'.$q.'</span>', $text);

?>



But when $q contain some regex you have some problems ... for exemple :

<?php $q = '('; ?>



So you must use preg_replace to highlight correctly the text and you must create a function for escape bad regex caracters !



I think that a better function can be found but this works I guess :



<?php

function regex_escape( $q )

{

    return preg_replace('/([\[\]\(\)\{\}\-\.\*\?\|\^\$])/', '\$1', $q);

}

?>

down

-12

triplepoint at gmail dot com ¶

14 years ago


Regarding maintaining the case of the find/replace for search-highlighting purposes:

if the performance hit of a regular expression isn't a big problem, there's something like:

<?php
function highlight_matches($find_text, $text) {
  return preg_replace("/($find_text)/i", '<span class="search_item">$1</span>', $text);
}
?>

add a note