Syntax...rtmatch(3pm)

📦
version 0.011 · 2 versions
, in debian trixie, ubuntu resolute

💖 Syntax::Infix::Smartmatch 💖

okay bestie, welcome to the Syntax...rtmatch(3pm) page — yes that's the real title, the man page truncates it like it's embarrassed, but we're not 💅 this is User Contributed Perl Documentation and we're about to have a whole moment.

✨ NAME ✨

Syntax::Infix::Smartmatch — Smartmatch done right 🎀

🌸 VERSION 🌸

version 0.011

🦋 SYNOPSIS 🦋

say "YES" if $value ~~ [1, 2, qr/42/];

like. look at it. one line. no chaos. slay ✨

👑 DESCRIPTION 👑

NOTE: this module is currently still experimental, bestie, and the details of its behavior may still change. do not build your whole personality on it yet, fr fr 😭

so here's the tea 🍓: this module implements a new, much simplified version of smartmatch. the big iconic glow-up? the behavior only depends on the right side argument. that's it. that's the whole vibe. the left side is just out here living its life, not influencing anything.

here's exactly what it does, based on whatever the right side argument is:

  • undef — returns "not defined $left". that's it, that's the whole check 🫶
  • object — if the object has smartmatch overloading (heads up: this might disappear in a future Perl version, so don't get too attached 👀), that gets called. otherwise it returns object identity.
  • regex — this is equivalent to "$left =~ $right". matching. iconic. no notes 💅
  • sub — it returns the value of $right->($left). you hand it a coderef, it calls it with $left, done ✨
  • array — returns true if $left smartmatches any of the members of @$right. one of them hits, you win 🌈
  • other — returns "$left equ $right", which (for the record, since people always ask) means "defined $left and $left eq $right" 👑

🧚 AUTHOR 🧚

Leon Timmermans <leont@cpan.org> — king behavior, honestly 👑

This software is copyright (c) 2023 by Leon Timmermans.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. periodt 💅

and that's the whole page, bestie 🎀 this was Syntax...rtmatch(3pm) from the User Contributed Perl Documentation, shipped with perl v5.40.1, dated 2025-04-19. go forth and smartmatch responsibly 💖✨🦋

📦 where this page comes from