مفید String methods اور bang (!) variants کیا ہیں؟

Question

Accepted Answer

Ruby strings میں manipulation کے لیے methods کا ایک بھرپور مجموعہ ہے، اور بہت سے دو صورتوں میں آتے ہیں: ایک معمول کی صورت (ایک **نیا** string واپس کرتا ہے) اور ایک **bang (`!`)** صورت (string کو **in place** modify کرتا ہے، اصل کو تبدیل کرتا ہے)۔ اس فرق کو سمجھنا درستگی اور bugs سے بچنے کے لیے اہم ہے۔

## عام string methods

```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 (!) فرق: in-place mutation

```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) versions اصل string کو in place میں mutate کرتے ہیں**، جبکہ non-bang versions ایک نیا string واپس کرتے ہیں اور اصل کو unchanged رکھتے ہیں۔ یہ ایک حتمی فرق ہے — `upcase!` استعمال کرنا جب آپ کو `upcase` کا مطلب تھا (یا اس کے برعکس) اس بات کو تبدیل کرتا ہے کہ آیا اصل modify ہو، جو ظریف bugs کا سبب بن سکتا ہے۔

## ایک bang gotcha: nil return جب کوئی تبدیلی نہ ہو

```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
```

ایک ظریف gotcha: bang methods **`nil`** واپس کرتے ہیں اگر انہوں نے کوئی تبدیلی نہیں کی — تو ان کی return value سے chaining ٹوٹ سکتی ہے۔

## یہ کیوں اہم ہے

String manipulation programming میں سرہ ہے، تو Ruby کے بھرپور string methods کو جاننا روز مرہ مفید علم ہے — لیکن سب سے اہم نقطہ **bang (`!`) بمقابلہ non-bang فرق** کو سمجھنا ہے، جو Ruby naming convention اور bugs کا ایک بار بار ہونے والا ذریعہ ہے۔

Non-bang version ایک **نیا** string واپس کرتا ہے (اصل کو unchanged رکھتے ہوئے)، جبکہ **bang version اصل کو in place میں mutate کرتا ہے** — اور انہیں confuse کرنا اس بات کو بدلتا ہے کہ آیا اصل object modify ہو، جو ظریف، مشکل سے debug ہونے والے bugs کا سبب بنتا ہے (مثال کے طور پر اصل کو unchanged کی توقع لیکن `upcase!` استعمال کرنا اسے mutate کرتا ہے، یا mutation کی توقع لیکن `upcase` اصل کو untouched رکھتا ہے)۔

چونکہ Ruby strings mutable ہیں اور بہت سے methods دونوں forms میں ہیں، یہ فرق سمجھنا درستگی کے لیے اہم ہے — یہ جاننا کہ `!` عام طور پر "in place میں modify کرتا ہے / خطرناک version ہے" (ایک convention جو strings سے آگے دوسرے Ruby methods جیسے `map!`، `sort!` تک پھیلتی ہے) آپ کو mutation behavior کو predict اور control کرنے کی اجازت دیتا ہے۔

یہ اضافی **gotcha** کہ bang methods `nil` واپس کرتے ہیں جب وہ کوئی تبدیلی نہیں کرتے (جو method chaining کو توڑ سکتا ہے) جاننا بھی قیمتی ہے۔

Ruby کے مفید string methods کو سمجھنا اور خاص طور پر **bang/non-bang mutation فرق** (ایک core Ruby convention جو اس بات کو متاثر کرتا ہے کہ آیا اصل modify ہو) صحیح Ruby لکھنے کے لیے اہم ہے جو strings کو محفوظ طریقے سے handle کرے — یہ mutation bugs کا ایک بار بار ہونے والا ذریعہ ہے، اور `!` convention ایک بنیادی Ruby idiom ہے جو in-place بمقابلہ new-object semantics کی سمجھ کو ظاہر کرتا ہے، اسے Ruby میں constant string کام کے لیے عملی طور پر متعلقہ علم اور distinctive، bug-prone Ruby convention کے بارے میں ایک عام موضوع بناتے ہوئے۔