str_ireplace
تابع str_ireplace در متن، جایگزینی را بدون توجه به حروف بزرگ کوچک انجام می دهد. یعنی Case-Insensitive است. مثل جستجو در گوشی که به اندازه حروف اهمیت نمی دهد.
تعریف و کاربرد
این تابع در رشته یا آرایه می گردد و مقدارهای پیدا شده را جایگزین می کند.
نکته: اگر ورودی یک آرایه باشد، خروجی هم آرایه است. همچنین این تابع Binary-Safe است؛ یعنی با بایت ها دقیق کار می کند.
قوانین مهم جایگزینی
- آرایه بدهی، روی همه اعضا جایگزینی می شود.
- اگر find و replace آرایه باشند و replace کوتاه باشد، کمبود با رشته خالی پر می شود.
- اگر find آرایه و replace رشته باشد، همان رشته برای همه استفاده می شود.
سینتکس
str_ireplace(find, replace, string, count)
پارامترها
- find: مقدار یا مقادیر مورد جستجو.
- replace: مقدار جایگزین برای find.
- string: رشته یا آرایه هدف جستجو.
- count: متغیر شمارنده تعداد جایگزینی ها.
مثال 1: جایگزینی ساده بدون حساسیت به حروف
<?php
echo str_ireplace("WORLD", "Peter", "Hello world!");
?>
مثال 2: آرایه و شمارش تعداد جایگزینی
<?php
$arr = array("blue", "red", "green", "yellow");
$result = str_ireplace("RED", "pink", $arr, $i);
print_r($result);
echo "Replacements: $i";
?>
مثال 3: replace کوتاه تر از find
<?php
$find = array("HELLO", "WORLD");
$replace = array("B");
$arr = array("Hello", "world", "!");
print_r(str_ireplace($find, $replace, $arr));
?>
گام های عملی
- متن یا آرایه هدف را مشخص کن.
- find و replace را تعیین کن.
- در صورت نیاز، count را بده.
- نتیجه را چاپ یا ذخیره کن.
نکته: اگر به حساسیت نیاز داری، از str_replace استفاده کن. برای قالب دهی خروجی، صفحه sprintf را ببین.
جمع بندی سریع
- حساسیت به حروف ندارد.
- با رشته و آرایه کار می کند.
- کمبود replace با رشته خالی جبران می شود.
- count تعداد تغییرات را می دهد.