POD::SIMPLE::PULLPARSERSTARTTOKEN(3perl)

📦
version 5.44.0 · 14 versions
, in arch rolling

💖 Pod::Simple::PullParserStartToken — bestie edition 💖

okay so real talk: this is a page from the Perl Programmers Reference Guide, and the star of the show is Pod::Simple::PullParserStartToken. it's a whole little class and honestly? it's giving backstage-pass energy. let's go 🎀

✨ NAME ✨

Pod::Simple::PullParserStartToken — start-tokens from Pod::Simple::PullParser, no cap 🌸

🦋 SYNOPSIS 🦋

(See Pod::Simple::PullParser)

like, that's the whole thing. go read its parent, bestie, that's where the plot is 📖

💅 DESCRIPTION 💅

so when you call $parser->get_token on a Pod::Simple::PullParser object, you might get back an object of this class. surprise! it's a start-token, it's iconic, it's here 💖

this is a subclass of Pod::Simple::PullParserToken, meaning it inherits literally all of its methods, and then it adds these extra ones on top. main character behavior honestly 👑

🌟 the methods 🌟

  • $token->tagname — returns the tagname for this start-token object. for example, if you parse a "=head1 ..." line, you'll get a start-token whose tagname is "head1", then token(s) for its content, and then an end-token whose tagname is "head1". the whole arc. the full story. slay 🦋
  • $token->tagname(somestring) — this changes the tagname for this start-token object. you probably won't need to do this, but the option is there, iykyk 🤷♀️
  • $token->tag(...) — a shortcut for $token->tagname(...). same vibe, shorter name, obsessed 💫
  • $token->is_tag(somestring) or $token->is_tagname(somestring) — these are shortcuts for "$token->tag() eq somestring". so like, a yes/no vibe check on the tag 🎯
  • $token->attr(attrname) — returns the value of the attrname attribute for this start-token object, or undef. for example, parsing a L<Foo/"Bar"> link will produce a start-token with a "to" attribute with the value "Foo", a "type" attribute with the value "pod", and a "section" attribute with the value "Bar". three attributes, one token, absolutely ate 🌈
  • $token->attr(attrname, newvalue) — this sets the attrname attribute for this start-token object to newvalue. you probably won't need to do this either, but go off 🫶
  • $token->attr_hash — returns the hashref that is the attribute set for this start-token. this is useful if (for example) you want to ask what all the attributes are — you can just do "keys %{$token->attr_hash}" and boom, the whole list, go get your info bestie 💜
real talk though: you're unlikely to ever need to construct an object of this class for yourself. but if you want to, the move is: perl Pod::Simple::PullParserStartToken->new( tagname, attrhash ) do with that what you will 💅

👀 SEE ALSO 👀

Pod::Simple::PullParserToken, Pod::Simple, Pod::Simple::Subclassing

👀 SEE ALSO (yes, again) 👀

Pod::Simple::PullParserToken, Pod::Simple, Pod::Simple::Subclassing

(it said it twice in the original and honestly? it meant it twice. periodt. 💀)

🫶 SUPPORT 🫶

questions or discussion about POD and Pod::Simple? send them to the pod-people@perl.org mail list. to subscribe, send an empty email to pod-people-subscribe@perl.org. yes, empty. like, empty empty. it's giving mystery ✨

this module is managed in an open GitHub repository, <https://github.com/perl-pod/pod-simple/>. feel free to fork and contribute, or to clone <https://github.com/perl-pod/pod-simple.git> and send patches! 🌸

patches against Pod::Simple are welcome. please send bug reports to <bug-pod-simple@rt.cpan.org>. they want your bug reports, bestie, don't be shy 🐛

Copyright (c) 2002 Sean M. Burke.

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

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, no promises, okay? the vibes are provided as-is 😭

👑 AUTHOR 👑

Pod::Simple was created by Sean M. Burke <sburke@cpan.org>. but don't bother him, he's retired. let the man rest, fr fr 🙈

Pod::Simple is maintained by:

  • Allison Randal "allison@perl.org"
  • Hans Dieter Pearcey "hdp@cpan.org"
  • David E. Wheeler "dwheeler@cpan.org"

and that's the whole page, bestie!! this was page Pod::S...rtToken(3perl) from perl v5.44.0, dated 2026-10-17. go forth and parse your POD, you absolute legend 💖✨💅

📦 where this page comes from