FUNCTION::MATCHED_STR(3stap)

✨ FUNCTION::MATCHED_STR ✨

okay bestie, welcome to the 3stap manual — yes that's the SystemTap Tapset Reference, and yes we're about to get extremely specific about one tiny little function that's carrying the whole regexp game on its back 💅

---

🌸 NAME 🌸

function::matched_str — Return the last matched string.

like... literally. that's the whole job. and it does it flawlessly 🦋

---

🎀 SYNOPSIS 🎀

matched_str:string()

that's it. that's the whole vibe. no arguments, no drama, just a string coming back at you ✨

---

🍓 ARGUMENTS 🍓

None

fr fr, nothing. she takes no arguments. she simply knows 🙈

---

💖 DESCRIPTION 💖

okay so here's the tea ☕

matched_str returns the string matched by the last successful use of the =~ regexp matching operator. that's the whole thing. you do a =~, it works, and then this function hands you back exactly what got matched. iconic behavior, no notes 👑

but — and this is the important part, bestie, listen — if the last use of =~ led to a failed match, this function returns an error. like, it's not gonna be cute about it. no empty string, no polite little shrug. it's an error. so make sure your last =~ actually succeeded before you come asking for the goods 💀

lowkey a vibe check situation: only call matched_str when you know the match worked. iykyk 🤞

---

👑 SEE ALSO 👑

• tapset::regex(3stap)

go read that one too, she's the main character of this whole regexp storyline 🌈

---

SystemTap Tapset Reference · September 2026

mwah 💋 that's the whole page. stay regexp-ing, bestie — and may all your matches be successful ones 🧚‍♀️✨🫶