{
    "mode": "perldoc",
    "parameter": "Pod::Simple::PullParserTextToken",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/perldoc/Pod%3A%3ASimple%3A%3APullParserTextToken/json",
    "generated": "2026-06-03T07:39:41Z",
    "synopsis": "(See Pod::Simple::PullParser)",
    "sections": {
        "NAME": {
            "content": "Pod::Simple::PullParserTextToken -- text-tokens from Pod::Simple::PullParser\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "(See Pod::Simple::PullParser)\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "When you do $parser->gettoken on a Pod::Simple::PullParser, you might get an object of this\nclass.\n\nThis is a subclass of Pod::Simple::PullParserToken and inherits all its methods, and adds these\nmethods:\n\n$token->text\nThis returns the text that this token holds. For example, parsing C<foo> will return a C\nstart-token, a text-token, and a C end-token. And if you want to get the \"foo\" out of the\ntext-token, call \"$token->text\"\n\n$token->text(*somestring*)\nThis changes the string that this token holds. You probably won't need to do this.\n\n$token->textr()\nThis returns a scalar reference to the string that this token holds. This can be useful if\nyou don't want to memory-copy the potentially large text value (well, as large as a\nparagraph or a verbatim block) as calling $token->text would do.\n\nOr, if you want to alter the value, you can even do things like this:\n\nfor ( ${  $token->textr  } ) {  # Aliases it with $ !!\n\ns/ The / the /g; # just for example\n\nif( 'A' eq chr(65) ) {  # (if in an ASCII world)\ntr/\\xA0/ /;\ntr/\\xAD//d;\n}\n\n...or however you want to alter the value...\n(Note that starting with Perl v5.8, you can use, e.g.,\n\nmy $nbsp = chr utf8::unicodetonative(0xA0);\ns/$nbsp/ /g;\n\nto handle the above regardless if it's an ASCII world or not)\n}\n\nYou're unlikely to ever need to construct an object of this class for yourself, but if you want\nto, call \"Pod::Simple::PullParserTextToken->new( *text* )\"\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "Pod::Simple::PullParserToken, Pod::Simple, Pod::Simple::Subclassing\n",
            "subsections": []
        },
        "SUPPORT": {
            "content": "Questions or discussion about POD and Pod::Simple should be sent to the pod-people@perl.org mail\nlist. Send an empty email to pod-people-subscribe@perl.org to subscribe.\n\nThis module is managed in an open GitHub repository, <https://github.com/perl-pod/pod-simple/>.\nFeel free to fork and contribute, or to clone <git://github.com/perl-pod/pod-simple.git> and\nsend patches!\n\nPatches against Pod::Simple are welcome. Please send bug reports to\n<bug-pod-simple@rt.cpan.org>.\n",
            "subsections": []
        },
        "COPYRIGHT AND DISCLAIMERS": {
            "content": "Copyright (c) 2002 Sean M. Burke.\n\nThis library is free software; you can redistribute it and/or modify it under the same terms as\nPerl itself.\n\nThis program is distributed in the hope that it will be useful, but without any warranty;\nwithout even the implied warranty of merchantability or fitness for a particular purpose.\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Pod::Simple was created by Sean M. Burke <sburke@cpan.org>. But don't bother him, he's retired.\n\nPod::Simple is maintained by:\n\n*   Allison Randal \"allison@perl.org\"\n\n*   Hans Dieter Pearcey \"hdp@cpan.org\"\n\n*   David E. Wheeler \"dwheeler@cpan.org\"\n",
            "subsections": []
        }
    },
    "summary": "Pod::Simple::PullParserTextToken -- text-tokens from Pod::Simple::PullParser",
    "flags": [],
    "examples": [],
    "see_also": []
}