مثال
کاراکترهای "world" را در رشته "Hello world!" با "پیتر":
echo str_replace("دنیا"،"پیتر"،"سلام دنیا!");
?>
این را خودتان امتحان کنید »
تعریف و استفاده
تابع str_replace() برخی از کاراکترها را با برخی از کاراکترهای دیگر در یک رشته جایگزین میکند.
این تابع طبق قوانین زیر کار می کند:
- اگر رشته مورد جستجو یک آرایه باشد، یک آرایه برمی گرداند
- اگر رشته مورد جستجو یک آرایه است، پیدا کردن و جایگزینی با هر عنصر آرایه انجام می شود
- اگر هم find و هم جایگزین آرایه هستند، و عنصر جایگزین کمتر از find باشد، یک رشته خالی به عنوان جایگزین استفاده می شود
- اگر find یک آرایه و جایگزین یک رشته باشد، رشته جایگزین برای هر مقدار find استفاده می شود
توجه: این تابع به حروف بزرگ و کوچک حساس است. از تابع str_ireplace() برای انجام یک
جستجوی غیر حساس به حروف کوچک و بزرگ.
توجه: این تابع باینری ایمن است.
نحو
str_replace(یافتن، جایگزینی، رشته، شمارش)
مقادیر پارامتر
| پارامتر | توضیح |
|---|---|
| یافتن | لازم است. مقدار پیدا کردن | را مشخص می کند
| جایگزین | شویدلازم است. مقداری را برای جایگزینی مقدار در مشخص می کند پیدا کنید |
| رشته | لازم است. رشته مورد جستجو را مشخص می کند |
| تعداد | اختیاری. متغیری که تعداد جایگزینها را شمارش میکند |
جزئیات فنی
| مقدار بازگشتی: | رشته یا آرایه ای را با مقادیر جایگزین شده برمی گرداند |
|---|---|
| نسخه PHP: | 4+ |
| تغییر: | پارامتر count در PHP 5.0 اضافه شد قبل از PHP 4.3.3، این تابع هنگام استفاده از آرایهها بهعنوان find و replace، که باعث شد از نمایه های خالی find بدون پیشبرد نشانگر داخلی در آرایه replace صرفنظر شود. نسخه های جدیدتر این مشکل را نخواهند داشت. از PHP 4.0.5، اکثر پارامترها اکنون می توانند یک آرایه باشند |
نمونه های بیشتر
مثال
استفاده از str_replace() با یک آرایه و یک متغیر count:
$arr = array("آبی"، "قرمز"، "سبز"، "زرد");
print_r(str_replace("قرمز"،"صورتی"،$arr،$i));
echo "Replacements: $i";
?>
خودت امتحانش کن »
مثال
استفاده از str_replace() با عناصر جایگزین کمتر از find:
$find = array("Hello","world");
$replace = آرایه ("B");
$arr = array("سلام"،"جهان"،"!");
print_r(str_replace($find,$replace,$arr));
?>
خودت امتحان کن »
❮ مرجع رشته PHP