ما هي طرق String المفيدة ومتغيراتها bang (!)؟

Question

Accepted Answer

تحتوي سلاسل Ruby على مجموعة غنية من الطرق للتعديل، والعديد منها يأتي في شكلين: نسخة عادية (ترجع **سلسلة جديدة**) ونسخة **bang (`!`)**  (تعدل السلسلة **في المكان**، مما يغير الأصلية). فهم هذا التمييز مهم للصحة وتجنب الأخطاء.

## طرق السلسلة الشائعة

```ruby
"hello".upcase           # "HELLO"
"HELLO".downcase          # "hello"
"  hi  ".strip             # "hi" — remove surrounding whitespace
"hello".reverse           # "olleh"
"hello".length            # 5
"hello world".split(" ")  # ["hello", "world"]
["a", "b"].join("-")       # "a-b"
"hello".sub("l", "L")      # "heLlo" — replace FIRST
"hello".gsub("l", "L")     # "heLLo" — replace ALL (global)
"hello".include?("ell")    # true
"hello".start_with?("he")  # true
"hello".chars             # ["h", "e", "l", "l", "o"]
"42".to_i; "3.14".to_f      # convert to number
"Hi #{name}"               # interpolation
```

## التمييز الحاسم bang (!): الطفرة في المكان

```ruby
str = "hello"

# normal version — returns a NEW string, original UNCHANGED
upper = str.upcase        # upper = "HELLO", but str is STILL "hello"
puts str                  # "hello" — unchanged

# BANG version — modifies the original IN PLACE (mutates it)
str.upcase!               # str is NOW "HELLO" — the original changed!
puts str                  # "HELLO"
```

**نسخ `!` (bang) تطفر السلسلة الأصلية في المكان**، بينما النسخ غير bang ترجع سلسلة جديدة وتترك الأصلية دون تغيير. هذا تمييز حاسم — استخدام `upcase!` عندما تقصد `upcase` (أو العكس) يغير ما إذا كانت الأصلية معدلة، مما قد يسبب أخطاء دقيقة.

## مشكلة bang: إرجاع nil عندما لا يكون هناك تغيير

```ruby
"hello".upcase!     # "HELLO"
"HELLO".upcase!     # nil! — bang methods return nil if NOTHING changed
# → don't chain off a bang method's return value carelessly
str.strip!&.upcase  # be careful — strip! returns nil if there was nothing to strip
```

مشكلة دقيقة: طرق bang ترجع **`nil`** إذا لم تحدث أي تغيير — لذلك السلسلة على قيمتها المرجعة قد تنقطع.

## لماذا يهم

تعديل السلاسل منتشر في البرمجة، لذا معرفة طرق السلاسل الغنية في Ruby معرفة يومية مفيدة — لكن النقطة الأهم هي فهم **التمييز بين bang (`!`) وغير bang**، وهو كل من اتفاقية تسمية Ruby ومصدر متكرر للأخطاء.

النسخة غير bang ترجع **سلسلة جديدة** (تترك الأصلية دون تغيير)، بينما **نسخة bang تطفر الأصلية في المكان** — والخلط بينهما يغير ما إذا كان الكائن الأصلي معدلاً، مما يسبب أخطاء دقيقة يصعب تتبعها (مثل توقع عدم تعديل الأصلية لكن استخدام `upcase!` يطفرها، أو توقع الطفرة لكن استخدام `upcase` يترك الأصلية دون تغيير).

بما أن سلاسل Ruby قابلة للطفرة والعديد من الطرق لها كلا الشكلين، فهم هذا التمييز مهم للصحة — معرفة أن `!` عادة تعني "تعديل في المكان / هي النسخة الخطيرة" (اتفاقية تتجاوز السلاسل إلى طرق Ruby أخرى مثل `map!`، `sort!`) تتيح لك التنبؤ والتحكم في سلوك الطفرة.

المشكلة الإضافية **أن طرق bang ترجع `nil` عندما لا تحدث أي تغيير (مما قد ينقطع السلسلة)** قيمة أيضاً لمعرفتها.

فهم طرق Ruby المفيدة للسلاسل وخاصة **التمييز بين bang وغير bang للطفرة** (اتفاقية Ruby الأساسية التي تؤثر على ما إذا كانت الأصلية معدلة) مهم لكتابة Ruby صحيح يتعامل مع السلاسل بأمان — إنه مصدر متكرر لأخطاء الطفرة، واتفاقية `!` اتفاقية Ruby أساسية تعكس فهم دلالات البدء في المكان مقابل الكائن الجديد، مما يجعله معرفة عملية لعمل السلاسل المستمر في Ruby ومواضيع شائعة حول اتفاقية Ruby مميزة وعرضة للأخطاء.