tex...plit(3tcl)

✨ NAME ✨

textutil::split — the procedures that split texts 💅 (yes bestie, it's the textutil::split page from the 3tcl manual, aka the Text and string utilities, macro processing corner of the world 🦋)

---

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require textutil::split ?0.9?

::textutil::split::splitn string ?len?

::textutil::split::splitx string ?regexp?

---

💖 DESCRIPTION 💖

okay so the textutil::split package hands you commands that chop up strings — by size or by whatever arbitrary regular expression your heart desires. iconic behaviour honestly 🎀

the full set of procedures is right here, no gatekeeping:

• ::textutil::split::splitn string ?len? — this one takes string and slices it into chunks of len characters, then gives you back a list holding all those chunks. if you don't pass a len, it lowkey defaults to 1. a negative length is not allowed and will make the command throw an error (do not test her 💀). giving an empty string as input is totally fine — you'll just get an empty list back. and if the length of the string isn't an entire multiple of the chunk length, then the last chunk in the generated list is gonna be shorter than len. not a bug, just vibes ✨
• ::textutil::split::splitx string ?regexp? — this one splits the string and returns a list too, but it splits according to the regular expression regexp instead of a boring simple list of chars. note: when parentheses show up in the regexp — i.e. regex capture groups — those groups get added into the result list as additional elements. so yeah, extra guests at the party 🫶. if the string is empty the result is the empty list, exactly like for split. if regexp is empty the string gets split at every character, like split does. the regular expression regexp defaults to "[\\t \\r\\n]+" if you don't say otherwise 🌈

---

😭 BUGS, IDEAS, FEEDBACK 😭

ngl, this document — and the package it describes — will undoubtedly contain bugs and other problems. bestie please report those in the category textutil of the Tcllib Trackers at http://core.tcl.tk/tcllib/reportlist. also spill any ideas for enhancements you have for either the package and/or the documentation, we're listening 👑

when proposing code changes, please provide unified diffs, i.e the output of diff -u. periodt.

note further that attachments are strongly preferred over inlined patches 🙈 attachments can be made by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar. it's giving very specific but very important, iykyk 💅

---

🦋 SEE ALSO 🦋

• regexp(3tcl)
• split(3tcl)
• string(3tcl)

---

⭐ KEYWORDS ⭐

• regular expression
• split
• string

---

👑 CATEGORY 👑

Text processing 🎀

---

and that's the whole page, bestie! this gorgeous thing is tcllib version 0.9, living its best life under tex...plit(3tcl) 🧚 slay, stay split, and don't pass a negative len 💖✨🍓