FUNCTI...XT_STRN(3stap)

💖 NAME 💖

function::text_strn — escape any non-printable chars in a string ✨

okay so bestie, this is a page from the SystemTap tapset manual, section 3stap, and it's literally just here to tell you about one lil function that cleans up your strings. no cap. 🎀

---

🌸 SYNOPSIS 🌸

text_strn:string(input:string,len:long,quoted:long)

that's the whole vibe right there. three args, one string back. slay. 💅

---

🦋 ARGUMENTS 🦋

• input — the string you wanna escape. the main character of this whole operation. 👑
• len — the maximum length of the string that gets returned to you. and listen, if you pass 0, that lowkey means MAXSTRINGLEN. so don't be confused when zero doesn't mean zero bestie. 🙈
• quoted — this one wraps your string in double quotes. but here's the tea: if your input string ends up getting truncated, it's gonna have "..." sitting right after the second quote. so you'll know it got cut off. 😭

---

✨ DESCRIPTION ✨

so what this function actually does: you hand it a string of a designated length, and any ASCII characters in there that are not printable get replaced by the corresponding escape sequence in the string that comes back to you. 🧚

that's it. that's the whole thing. it's giving "spring cleaning but for your string." 🌈

---

🌟 SEE ALSO 🌟

• tapset::string(3stap)

---

and that's a wrap on this one! this page came from the SystemTap Tapset Reference, and it's dated September 2026. go forth and escape responsibly, bestie 🫶💜⭐