PPIx::R...Capture(3)

💖 PPIx::Regexp::Structure::Capture — the manual, bestie edition 💖

okay so this is the User Contributed Perl Documentation page for PPIx::Regexp::Structure::Capture(3), and I'm gonna walk you through it like we're texting at 2am. no cap, it's shorter than you think and it's lowkey iconic. let's go 🫶

---

✨ NAME ✨

PPIx::Regexp::Structure::Capture — bestie, it represents capture parentheses. that's the whole vibe. the little ( ) that grabs your match and holds onto it? yeah. this class is its whole personality. 💅

---

✨ SYNOPSIS ✨

here's the little taste test they give you, verbatim, don't touch it:

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

literally just dump a regex and watch it go. slay. ✨

---

✨ INHERITANCE ✨

okay so the family tree, and you're gonna wanna pay attention because this is giving royal lineage 👑

• PPIx::Regexp::Structure::Capture is a PPIx::Regexp::Structure. so it inherits all that structure energy from above.
• PPIx::Regexp::Structure::Capture is the parent of PPIx::Regexp::Structure::NamedCapture. so yes, NamedCapture is the baby of the family and it came from here. main character begets main character, periodt.

---

✨ DESCRIPTION ✨

this class represents capture parentheses. that's it. that's the description. it said what it said and it ate. 🍓

---

✨ METHODS ✨

so this class hands you the following public methods. anything not written down here? private. and private means unsupported, in the sense that the author reserves the right to change or remove them without notice 😭 so don't get attached to the undocumented ones, bestie, they can ghost you any time.

💜 name

my $name = $element->name();

this one hands you the name of the capture buffer. but here's the catch: unless the buffer is actually named, you're getting undef. not an empty string, not a vibe, undef. so if it's not named, don't come crying to me when it's undefined. 🙈

💜 number

my $number = $element->number()

this one hands you the number of the capture buffer. and this is the important bit, so read it twice: named buffers have numbers also. so like, even the fancy named ones still got a number in the lineup. everyone's numbered, no exceptions, no skips. 💯

---

✨ SUPPORT ✨

support is by the author, okay? so if something's busted, don't just scream into the void:

• file bug reports at <https://github.com/trwyant/perl-PPIx-Regexp/issues>
• or, if you're feeling old school, send electronic mail to the author

that's the whole support situation. be nice, they're one person. 🫶

---

✨ AUTHOR ✨

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

(we love a single-author legend. respect. 👑)

---

✨ COPYRIGHT AND LICENSE ✨

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

okay so the legal tea, and it's actually kinda sweet:

• 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.

so like, it's free, it's yours to remix, but if it breaks? not their problem. fr fr. 💀

---

and that's the whole page bestie, we made it 🌈 — this little masterpiece is from perl v5.42.2, dated 2026-06-15, so if you're reading this on some other version, that's a whole different era. go forth and capture some parentheses. 💖✨🎀🦋