PPIx::R...cktrack(3)

💖 PPIx::Regexp::Token::Backtrack 💖

okay bestie, welcome to PPIx::Regexp::Token::Backtrack — a page from the User Contributed Perl Documentation, and no, the name isn't a typo, the terminal just loves to trim things. Sit down, hydrate, and let's talk backtrack control representation. 🫶

---

✨ NAME ✨

PPIx::Regexp::Token::Backtrack — literally just here to represent backtrack control. that's the whole job. iconic behavior honestly. 💅

---

🌸 SYNOPSIS 🌸

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

look at her go. (*ACCEPT) in the wild, being dumped. we love to see it. ✨

---

🦋 INHERITANCE 🦋

PPIx::Regexp::Token::Backtrack is a PPIx::Regexp::Token.

PPIx::Regexp::Token::Backtrack has no descendants.

so she's got a parent, and she has zero children. an only child who chose not to continue the bloodline. main character energy fr. 👑

---

🎀 DESCRIPTION 🎀

This class represents one of the backtrack controls.

that's it. that's the description. she does one thing and she does it well. 💖

---

⭐ METHODS ⭐

This class provides no public methods beyond those provided by its superclass.

ngl that's the polite way of saying "everything cool was inherited." but wait — there's more, because there are two methods down here and you're gonna want them. 👇

🍓 arg

This method returns the backtrack control argument specified by the element. That's the text after the first colon (':'), or the empty string ('') if none was specified.

so like: colon first, argument after. no colon? you get ''. simple. clean. no cap. 🧚

💜 verb

This method returns the backtrack control verb represented by the element. That's the text up to but not including the first colon (':') if any.

and here's the little plot twist: if the element specifies '' or "'F"", this method will return 'MARK' or 'FAIL', respectively.

so those two special cases get glow-ups. obsessed. 😭

---

🌈 SUPPORT 🌈

Support is by the author. Please file bug reports at <https://github.com/trwyant/perl-PPIx-Regexp/issues> or in electronic mail to the author.

bestie, if you find a bug, please actually tell the author instead of just screaming into the void. the GitHub issues link is right there. 🫶

---

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

fr fr, no warranty. don't come for anyone if it breaks. 🙈

---

and that's the whole page, bestie — this one shipped as part of perl v5.42.2 and got its date stamp on 2026-06-15, so when you see it in the wild you know exactly who to thank. slay, stay hydrated, and may all your regexes backtrack exactly how you meant. 💅✨🦋