PPIx::R...olation(3)

💖 PPIx::Regexp::Token::Interpolation(3) 💖

okay bestie, so this is one of the pages from PPIx::Regexp, the Perl module fam, and it's filed under User Contributed Perl Documentation. sit down, grab a boba, we're doing a token class today 🧋✨

---

🌸 NAME 🌸

PPIx::Regexp::Token::Interpolation — the class that represents an interpolation inside the PPIx::Regexp package. yes, that's the whole vibe. it's giving "small but crucial" 💅

---

✨ SYNOPSIS ✨

here's the lil flex, copy it exactly bestie:

use PPIx::Regexp::Dumper;
PPIx::Regexp::Dumper->new('qr{$foo}smx')->print();

---

🦋 INHERITANCE 🦋

• PPIx::Regexp::Token::Interpolation is a PPIx::Regexp::Token::Code. it said "I learned from the best" 🫶
• PPIx::Regexp::Token::Interpolation has no descendants. no children, no heirs, it's an only child, main character energy, no cap 👑

---

💜 DESCRIPTION 💜

so like, this class represents a variable interpolation that got dropped into a regular expression. in the SYNOPSIS up there, that $foo? yeah, that would be represented by an object of this class. iconic behaviour honestly 🌈

🎀 Incompatible Change: Parse of '@{[ ... ]}' 🎀

not me having to tell you this... okay so in versions 0.083 and earlier, '@{[ ... ]}' parsed as a member of this class. in 0.084 and later, it parses as a member of PPIx::Regexp::Token::Code instead.

why? because that more accurately reflects the actual contents of the token 💅 and it enables the recognition of the full range of postfix dereference operators for versioning purposes — not just those valid in interpolations. glow up fr fr ✨

⚠️ so if you were relying on the old behaviour, that's a breaking change bestie. not sorry, it's for the better.

---

🔥 METHODS 🔥

this class provides the following public methods beyond those provided by its superclass. it's giving overachiever, we love to see it 😭💖

⭐ is_matcher ⭐

this method returns undef because a static analysis can not in general tell whether a piece of code matches anything. it simply does not know. it refuses to guess. respect the boundaries 🫶

---

🫶 SUPPORT 🫶

support is by the author, periodt. if something's busted, please file bug reports at <https://github.com/trwyant/perl-PPIx-Regexp/issues> or in electronic mail to the author. they wanna hear from you 💌

---

👑 AUTHOR 👑

Thomas R. Wyant, III — harryfmudd at comcast dot net

---

🌟 COPYRIGHT AND LICENSE 🌟

Copyright (C) 2009-2023, 2025-2026 by Thomas R. Wyant, III

This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0. For more details, see the full text of the licenses in the directory LICENSES.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

💀 yeah the all-caps warranty disclaimer stays, that's the legal vibe check and we don't mess with it.

---

and that's the page bestie!! 🎀 this was rendered by perl v5.42.2, dated 2026-06-15, and the manual is PPIx::R...olation(3) — yes the title's literally abbreviated like that, we don't make the rules 💅 mwah, go interpolate something cute 🌸🦋✨