string.find()

تُعدّ الدالة string.find() أداة قوية للبحث داخل السلاسل النصية. تتيح لك البحث عن سلسلة نصية أصغر (تُسمى نمطًا) داخل سلسلة نصية أكبر، وتخبرك بالمكان الذي عُثر عليها فيه بالضبط.

إليك الصياغة الأساسية:

string.find(text, pattern)

عندما تحدد string.find() النمط بنجاح، فإنها تُرجع عددين: موضع بداية التطابق وموضع نهايته. وإذا لم يُعثر على النمط، فإنها تُرجع nil.

إليك مثالًا بسيطًا:

local sentence = "The treasure is hidden here"
local start_pos, end_pos = string.find(sentence, "treasure")
print(start_pos, end_pos)  -- المخرجات: 5 12

في هذا المثال، تبدأ الكلمة «treasure» عند الموضع 5 وتنتهي عند الموضع 12 في الجملة.

هناك أمر عليك معرفته: النص الذي تبحث عنه هو نمط، وليس نصًا عاديًا. لبعض المحارف معانٍ خاصة في الأنماط: . % - + * ? [ ] ^ $ ( ). ستتعرف إليها لاحقًا في الدورة. تطابق الأحرف والأرقام والمسافات نفسها، كما في المثال أعلاه، لكن قد يطابق المحرف الخاص أكثر مما قصدت:

print(string.find("Score: 105", "1.5"))  -- الناتج: 8 10 (طابقت . الرقم 0)

للبحث عن النص تمامًا كما كُتب، أضف وسيطين آخرين: 1 (ابدأ من الحرف الأول) وtrue (بحث عادي، بلا أحرف خاصة):

print(string.find("Score: 105", "1.5", 1, true))   -- الناتج: nil
print(string.find("Version 1.5", "1.5", 1, true))  -- الناتج: 9 11