החלפה באמצעות 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() מחליפה כברירת מחדל כל מופע, ולכן היא מושלמת למשימות ניקוי טקסט כמו הסרת תווים לא רצויים או האחדת העיצוב.