string.match()

Meskipun string.find() memberi tahu kamu di mana sebuah pola muncul dalam string, terkadang kamu perlu mengambil teks sebenarnya yang cocok. Di sinilah string.match() berperan, dan fungsinya menjadi lebih kuat saat dipadukan dengan tangkapan.

Capture memungkinkan kamu menandai bagian tertentu dari pola yang ingin kamu ekstrak. Kamu membuat capture dengan membungkus sebagian pola dalam tanda kurung (). Saat string.match() menemukan kecocokan, fungsi ini mengembalikan teks yang ditangkap, bukan hanya posisinya.

Berikut contoh sederhana untuk mengekstrak angka dari string:

local text = "Player score: 100"
local number = string.match(text, "%d+")
print(number)  -- output: 100

Pola %d+ berarti "satu digit atau lebih." + adalah pengubah yang cocok dengan satu atau lebih karakter dari kelas karakter sebelumnya, sehingga kamu bisa menangkap angka yang terdiri dari beberapa digit.

Kamu dapat menggunakan tangkapan untuk mengekstrak bagian tertentu dari pola yang lebih kompleks:

local message = "User: Alice sent a message"
local username = string.match(message, "User: (%a+)")
print(username)  -- output: Alice

Di sini, tanda kurung di sekitar %a+ memberi tahu Lua untuk menangkap rangkaian huruf yang muncul setelah "User: ". Bagian pola lainnya membantu menemukan posisi yang tepat, tetapi hanya bagian yang ditangkap yang dikembalikan.

Jika polamu memiliki beberapa penangkapan, string.match() mengembalikan semuanya sebagai nilai terpisah, yang dapat kamu tetapkan ke beberapa variabel sekaligus.