PPI::Token::Regexp(3)

📦
version 1.284 · 14 versions
, in fedora 44

💖 PPI::Token::Regexp — the regexp glow-up page 💖

okay bestie, you've landed on PPI::Token::Regexp(3) from the User Contributed Perl Documentation collection. pull up a chair, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

PPI::Token::Regexp — the regular expression abstract base class, and she's literally the blueprint. 👑

🌸 INHERITANCE 🌸

the family tree, and yes it's giving royal lineage:

PPI::Token::Regexp
isa PPI::Token
    isa PPI::Element

so she inherits from PPI::Token, which inherits from PPI::Element. iconic chain, no notes. 💅

🦋 DESCRIPTION 🦋

okay so here's the tea: the PPI::Token::Regexp class is never instantiated. like, never ever. she doesn't do the work herself, she just shows up as the shared abstract base class for the three regular expression classes. and those three are:

  • m// → PPI::Token::Regexp::Match 🎀
  • s/// → PPI::Token::Regexp::Substitute ✨
  • tr/// → PPI::Token::Regexp::Transliterate 🌈

the names are, like, hopefully obvious enough that nobody has to explain what each class does. go check their own pages if you want the full scoop, bestie.

and real quick, to save you from some confusion: it's worth pointing out right here that qr// is not a regular expression. nope! because when PPI says "regular expression," it means something that will actually examine or modify a string. qr// is a quote-like operator that acts as a constructor for compiled Regexp objects. different vibe entirely. iykyk. 💀

💅 METHODS 💅

the following methods are inherited by this class' offspring (so the whole lil regexp fam gets them):

  • get_match_string — returns the portion of the regexp that performs the match. 🎯
  • get_substitute_string — returns the portion of the regexp that gets substituted in for the match, if there is any. and if the regexp doesn't substitute? you get undef back. sorry bestie, that's the deal. 🙈
  • get_modifiers — returns the modifiers of the regexp. ⭐
  • get_delimiters — returns the delimiters of the regexp as an array. the first element is the delimiters of the match string, and the second element (if any) is the delimiters of the substitute string (if any). two slots, very tidy. 🧚

🫶 SUPPORT 🫶

see the support section in the main module. that's where the help lives, go look. 💜

👑 AUTHOR 👑

Adam Kennedy <adamk@cpan.org>

Copyright 2001 - 2011 Adam Kennedy.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.

no cap, that's the whole page. every flag, every class, every undef — all accounted for. periodt. 🔥

so yeah, this was PPI::Token::Regexp(3), and the footer energy is: perl v5.42.0, dated 2026-01-17. mwah, go forth and parse some regexps, main character. 💖✨

📦 where this page comes from