تُعد الدالة str.replace() إحدى الدوال الأساسية والفعالة في بايثون لمعالجة السلاسل النصية. تتيح لك هذه الدالة استبدال جزء معين من سلسلة نصية بجزء آخر بكفاءة عالية، مع إرجاع نسخة جديدة من السلسلة المعدلة دون تغيير السلسلة الأصلية.
تعريف الدالة
تقوم الدالة str.replace() بإرجاع نسخة جديدة من السلسلة النصية التي تم استدعاؤها عليها، بعد استبدال جميع أو عدد محدد من التكرارات للنص القديم (old) بالنص الجديد (new).
بناء الدالة (Syntax)
البناء العام للدالة هو كالتالي: str.replace(old, new[, count])
البارامترات (Parameters)
تستقبل الدالة str.replace() البارامترات التالية:
old: (مطلوب) السلسلة النصية التي نرغب في البحث عنها واستبدالها داخل السلسلة الأصلية.new: (مطلوب) السلسلة النصية التي ستحل محل السلسلة القديمة في النسخة الجديدة من السلسلة.count: (اختياري) عدد صحيح يحدد الحد الأقصى لعدد مرات الاستبدال. إذا تم تحديد قيمة لـcount، فسيتم استبدال أولcountتكرار فقط من اليسار إلى اليمين. إذا لم يتم تحديده، فسيتم استبدال جميع التكرارات الموجودة في السلسلة.
قيمة الإرجاع (Return Value)
ترجع الدالة str.replace() نسخة جديدة من السلسلة النصية بعد إجراء عمليات الاستبدال. من المهم ملاحظة أن السلسلة الأصلية لا تتغير.
المثال الأول: استبدال جميع التكرارات
يوضح هذا المثال كيفية استخدام الدالة str.replace() لاستبدال جميع تكرارات كلمة 'java' بكلمة 'python' في سلسلة نصية.
s = 'java is easy to learn. anyone can learn java.'
print(s)
print(s.replace('java', 'python'))النتيجة:
java is easy to learn. anyone can learn java.
python is easy to learn. anyone can learn python.المثال الثاني: استبدال أول تكرار فقط
يوضح هذا المثال كيفية استخدام البارامتر count لاستبدال أول تكرار فقط لكلمة 'java' بكلمة 'python'.
s = 'java is easy to learn. anyone can learn java.'
print(s)
print(s.replace('java', 'python', 1))النتيجة:
java is easy to learn. anyone can learn java.
python is easy to learn. anyone can learn java.