Type::Tiny::XS(3pm)

✨ Type::Tiny::XS ✨

okay so bestie, this is the manual page for Type::Tiny::XS, which is a little XS speed boost for some of Type::Tiny's built-in type constraints. she's fast, she's C-based, she's optional, and she's here to make your type checks go brrr 💅

---

🌸 SYNOPSIS 🌸

use Types::Standard qw(Int);

that's it. that's the whole vibe. 🫶

---

💖 DESCRIPTION 💖

So here's the tea: Type::Tiny 0.045_03 and above can optionally use this module to get faster, C-based implementations of some type constraints. Like, actual compiled C doing your validation for you. iconic behavior honestly.

And the best part? This package has only core dependencies, and it does not depend on Type::Tiny at all. So if you're out here using some other data validation framework, you might wanna consider borrowing her too. she's for everybody fr fr. 🌈

okay so now, the important part. only these three functions count as the supported API. memorize them, respect them, love them:

• Type::Tiny::XS::get_coderef_for($type) — you hand her a supported type constraint name, like "Int", and she gives you back a coderef you can use to validate a parameter against that constraint. and if this module can't provide a suitable coderef for you? she returns undef. no drama, no lie 💀
• Type::Tiny::XS::get_subname_for($type) — literally the same as get_coderef_for except instead of the coderef she gives you the name of that sub, as a string. and again, if this module cannot provide a suitable sub name, it's undef for you bestie. 😭
• Type::Tiny::XS::is_known($coderef) — returns true if the coderef was provided by Type::Tiny::XS. tiny little vibe check, does exactly what it says. ✨

And beyond those three? the subs that get_coderef_for and get_subname_for return are also considered part of the supported API — but ⚠️ only for the lifetime of the Perl process that returned them. so like, temporary bestie energy.

To clarify (because this one matters, no cap), if you call get_subname_for("ArrayRef[Int]") in a script, this will return the name of a sub. that sub — which you can use to validate arrayrefs of integers — is now considered part of the supported API of Type::Tiny::XS until the script finishes running. next time the script runs, there is no guarantee that the sub will continue to exist, or continue to do the same thing. she may be completely different. she may not be there at all. 🦋

So yeah: don't be out here persisting assumptions about these subs across runs. that's not the deal. 🙈

---

💀 BUGS 💀

found a bug? please report it, bestie, we wanna know:

<http://rt.cpan.org/Dist/Display.html?Queue=Type-Tiny-XS>

(i'm keeping that URL exactly as she is, don't @ me)

---

⭐ SEE ALSO ⭐

• Type::Tiny
• Types::Standard

go look at them, they're the main characters of this whole story 👑

---

🎀 AUTHOR 🎀

Toby Inkster <tobyink@cpan.org> — and fun fact, he forked all this from Mouse::Util::TypeConstraints. so there's a whole ancestry here, we love a lineage moment.

Also, the ArrayLike, HashLike, CodeLike, and StringLike constraints are based on code by ikegami on StackOverflow. credit where credit is due 🫶

<https://stackoverflow.com/a/64019481/1990570>

(yes im keeping that link verbatim too, it's part of the record)

---

💜 COPYRIGHT AND LICENCE 💜

This software is copyright (c) 2014, 2018-2020 by Toby Inkster.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay, free software, we love her.

---

🚨 DISCLAIMER OF WARRANTIES 🚨

okay listen, this is the serious one so imma say it loud:

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

like. none. zero. don't come for her if she doesn't do the thing. you've been warned, bestie 😭

---

💫 and that's the whole page!

perl v5.42.3 · 2026-08-19 — that's the version and the date this page belongs to, mwah, go forth and validate your types fast 💖✨🎀