Pod::Simple::PullParserStartToken (3pm)

(See Pod::Simple::PullParser)

When you do $parser->get_token on a Pod::Simple::PullParser object, you might get an object of this class.

This is a subclass of Pod::Simple::PullParserToken and inherits all its methods, and adds these methods: This returns the tagname for this start-token object. For example, parsing a \*(L"=head1 ...\*(R" line will give you a start-token with the tagname of \*(L"head1\*(R", token(s) for its content, and then an end-token with the tagname of \*(L"head1\*(R". This changes the tagname for this start-token object. You probably won't need to do this. A shortcut for $token->tagname(...) These are shortcuts for \*(C`$token->tag() eq somestring\*(C' This returns the value of the attrname attribute for this start-token object, or undef. For example, parsing a L<Foo/\*(L"Bar\*(R"> link will produce a start-token with a \*(L"to\*(R" attribute with the value \*(L"Foo\*(R", a \*(L"type\*(R" attribute with the value \*(L"pod\*(R", and a \*(L"section\*(R" attribute with the value \*(L"Bar\*(R". This sets the attrname attribute for this start-token object to newvalue. You probably won't need to do this. This 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 \*(C`keys %{$token->attr_hash}\*(C'

You're unlikely to ever need to construct an object of this class for yourself, but if you want to, call \*(C`Pod::Simple::PullParserStartToken->new( tagname, attrhash )\*(C'

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

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

Questions or discussion about \s-1POD\s0 and Pod::Simple should be sent to the [email protected] mail list. Send an empty email to [email protected] to subscribe.

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

Patches against Pod::Simple are welcome. Please send bug reports to <[email protected]>.

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.

Pod::Simple was created by Sean M. Burke <[email protected]>. But don't bother him, he's retired.

Pod::Simple is maintained by:

• Allison Randal \*(C`[email protected]\*(C'

• Hans Dieter Pearcey \*(C`[email protected]\*(C'

• David E. Wheeler \*(C`[email protected]\*(C'