استخدام string.gsub() للاستبدال

عند العمل مع السلاسل النصية، غالباً ما تحتاج إلى البحث عن نص واستبداله. تجعل دالة string.gsub() في لغة Lua هذا الأمر سهلاً من خلال إجراء استبدال عام — العثور على جميع حالات ظهور نمط معين واستبدالها بشيء آخر.

تأخذ الصيغة الأساسية ثلاث وسائط: السلسلة الأصلية، والنمط المراد البحث عنه، ونص الاستبدال:

local result = string.gsub(originalString, pattern, replacement)

إليك مثال بسيط يستبدل جميع المسافات بشرطات سفلية:

local text = "hello world from lua"
local cleaned = string.gsub(text, " ", "_")
print(cleaned)  -- النتيجة: hello_world_from_lua

تُعيد الدالة قيمتين: السلسلة النصية المعدلة وعدد عمليات الاستبدال التي تم إجراؤها. يمكنك الحصول على كليهما إذا لزم الأمر:

local result, count = string.gsub("foo bar foo", "foo", "baz")
print(result)  -- النتيجة: baz bar baz
print(count)   -- النتيجة: 2

على عكس بعض دوال السلاسل النصية التي تجد المطابقة الأولى فقط، تقوم string.gsub() باستبدال كل تكرار بشكل افتراضي، مما يجعلها مثالية لمهام تنظيف النصوص مثل إزالة الأحرف غير المرغوب فيها أو توحيد التنسيق.