الفرق بين المراجعتين لصفحة: «Ruby/String/gsub-21»

مراجعة 10:10، 26 مارس 2019

يبدل التابع gsub!‎ قيمة (أو قيم) محدَّدة مكان جميع الأنماط المتطابقة في السلسلة النصية التي استدعي معها.

هذا التابع مماثل تمامًا للتابع gsub ولكن يعدل على السلسلة المعطاة نفسها.

البنية العامة

gsub!(pattern, replacement) → str or nil
gsub!(pattern, hash) → str or nil
gsub!(pattern) {|match| block } → str or nil
gsub!(pattern) → an_enumerator

المعاملات

`pattern`

يكون عادةً تعبيرًا نمطيًّا. إن كان سلسلة نصية، فستُفسَّر أية محارف خاصة بالتعبيرات النمطية الموجودة فيها حرفيًّا؛ أي '‎\\d' سيطابق خط مائل عكسي يتبعه الحرف 'd' مباشرةً بدلًا من عددٍ.

`replacement`

إن كان سلسلة نصية، فسيحل مكان النصي المتطابق. قد يحوي على مراجع خلفية (back-references) للمجموعات الملتقطة عبر النمط pattern مثل النموذج ‎\\d إذ d هو عدد المجموعة أو ‎\\k<n>‎ إذ n هو اسم المجموعة. إن كان سلسلة نصية مقتبسة بعلامتي اقتباس مزدوجتين، يجب أن يُسبّق كلا المرجعين الخلفيين بخط مائل عكسي إضافي. على أي حال، لن تشير المتغيرات الخاصة بالمجموعات الملتقطة (المتطابقة) - مثل ‎$&‎ - إلى العنصر الملتقط الحالي.

`hash`

جدول Hash. إن مُرِّر كمعامل ثاني إلى التابع وكانت إحدى القيم المتطابقة مساويةً لإحدى قيم مفاتيحه، فستُبدَل به القيمة المقابلة لهذا المفتاح. أي تُمثِّل تلك القيمة المقابلة سلسلة الاستبدال.

القيمة المعادة

تعاد السلسلة النصية المعطاة نفسها بعد تبديل القيمة replacment أو hash مكان جميع الأنماط المتطابقة عبر pattern في السلسلة النصية المعطاة.

إن لم تُعطَ كتلة ولم يُمرَّر معامل ثانٍ (المعامل replacement أو hash)، فسيُعاد كائن من النوع Enumerator.

انظر أيضًا

التابع gsub: يعيد نسخة من السلسلة النصية التي استدعيت معه مع تبديل قيمة (أو قيم) محدَّدة مكان جميع الأنماط المتطابقة فيها.
التابع reverse!‎: يعدل على السلسلة النصية التي استدعي معها بعكس ترتيب المحارف فيها.
التابع scrub!‎: يستبدل البايتات غير الصالحة في السلسلة النصية التي استدعي معها بمحرف محدَّد أو بالقيمة التي تعيدها الكتلة إن أعطيت.
التابع slice!‎: يقتطع محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.

مصادر

قسم التابع ‎gsub!‎ في الصنف String في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby String]]
-يعيد التابع <code>gsub!‎</code> ب
+يبدل التابع <code>gsub!‎</code> قيمة (أو قيم) محدَّدة مكان جميع الأنماط المتطابقة في السلسلة النصية التي استدعي معها.
+هذا التابع مماثل تمامًا للتابع <code>[[Ruby/String/gsub|gsub]]</code> ولكن يعدل على السلسلة المعطاة نفسها.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">gsub!(pattern, replacement) → str or nil
@@ سطر 9: / سطر 11: @@
 gsub!(pattern) {|match| block } → str or nil
 gsub!(pattern) → an_enumerator</syntaxhighlight>
+== المعاملات ==
+=== <code>pattern</code> ===
+يكون عادةً [[Ruby/Regexp|تعبيرًا نمطيًّا]]. إن كان [[Ruby/String|سلسلة نصية]]، فستُفسَّر أية محارف خاصة بالتعبيرات النمطية الموجودة فيها حرفيًّا؛ أي '‎\\d' سيطابق خط مائل عكسي يتبعه الحرف 'd' مباشرةً بدلًا من عددٍ.
+=== <code>replacement</code> ===
+إن كان [[Ruby/String|سلسلة نصية]]، فسيحل مكان النصي المتطابق. قد يحوي على مراجع خلفية (back-references) للمجموعات الملتقطة عبر النمط <code>pattern</code> مثل النموذج ‎<code>\\d</code> إذ <code>d</code> هو عدد المجموعة أو ‎<code>\\k<n>‎</code> إذ <code>n</code> هو اسم المجموعة. إن كان سلسلة نصية مقتبسة بعلامتي اقتباس مزدوجتين، يجب أن يُسبّق كلا المرجعين الخلفيين بخط مائل عكسي إضافي. على أي حال، لن تشير المتغيرات الخاصة بالمجموعات الملتقطة (المتطابقة) - مثل ‎<code>$&‎</code> - إلى العنصر الملتقط الحالي.
+=== <code>hash</code> ===
+[[Ruby/Hash|جدول Hash]]. إن مُرِّر كمعامل ثاني إلى التابع وكانت إحدى القيم المتطابقة مساويةً لإحدى قيم مفاتيحه، فستُبدَل به القيمة المقابلة لهذا المفتاح. أي تُمثِّل تلك القيمة المقابلة سلسلة الاستبدال.
 ==القيمة المعادة==
-يعاد
+تعاد السلسلة النصية المعطاة نفسها بعد تبديل القيمة <code>replacment</code> أو <code>hash</code> مكان جميع الأنماط المتطابقة عبر <code>pattern</code> في السلسلة النصية المعطاة.
+إن لم تُعطَ كتلة ولم يُمرَّر معامل ثانٍ (المعامل <code>replacement</code> أو <code>hash</code>)، فسيُعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>.
-==انظر أيضا==
+==انظر أيضًا==
+* التابع <code>[[Ruby/String/gsub|gsub]]</code>: يعيد نسخة من السلسلة النصية التي استدعيت معه مع تبديل قيمة (أو قيم) محدَّدة مكان جميع الأنماط المتطابقة فيها.
+* التابع <code>[[Ruby/String/reverse-21|reverse!‎]]</code>: يعدل على السلسلة النصية التي استدعي معها بعكس ترتيب المحارف فيها.
+* التابع <code>[[Ruby/String/scrub-21|scrub!‎]]</code>: يستبدل البايتات غير الصالحة في السلسلة النصية التي استدعي معها بمحرف محدَّد أو بالقيمة التي تعيدها الكتلة إن أعطيت.
+* التابع <code>[[Ruby/String/slice-21|slice!‎]]</code>: يقتطع محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/String.html#method-i-gsub-21 قسم التابع ‎gsub!‎ في الصنف String في توثيق روبي الرسمي.]