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

عند العمل مع string، تحتاج غالبًا إلى البحث عن نص واستبداله. تجعل الدالة 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

تُرجع function قيمتين: السلسلة النصية المعدَّلة وعدد الاستبدالات التي أُجريت. يمكنك التقاط القيمتين إذا لزم الأمر:

local result, count = string.gsub("foo bar foo", "foo", "baz")
print(result)  -- المخرجات: baz bar baz
print(count)   -- المخرجات: 2

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