目錄

名稱

Pod::Simple::PullParserTextToken -- Pod::Simple::PullParser 中的文字標記

語法

(請參閱 Pod::Simple::PullParser)

說明

當您對 Pod::Simple::PullParser 執行 $parser->get_token 時,您可能會取得此類別的物件。

這是 Pod::Simple::PullParserToken 的子類別,並繼承其所有方法,並新增下列方法

$token->text

這會傳回此標記所包含的文字。例如,解析 C<foo> 會傳回一個 C 開始標記、一個文字標記和一個 C 結束標記。如果您想從文字標記中取得「foo」,請呼叫 $token->text

$token->text(somestring)

這會變更此標記所包含的字串。您可能不需要執行此操作。

$token->text_r()

這會傳回此令牌所持有的字串的純量參考。如果您不想記憶體複製潛在的大量文字值(嗯,就像段落或逐字區塊一樣大),這會很有用,因為呼叫 $token->text 就會這麼做。

或者,如果您想變更值,您甚至可以執行類似這樣的動作

for ( ${  $token->text_r  } ) {  # Aliases it with $_ !!

  s/ The / the /g; # just for example

  if( 'A' eq chr(65) ) {  # (if in an ASCII world)
    tr/\xA0/ /;
    tr/\xAD//d;
  }

  ...or however you want to alter the value...
  (Note that starting with Perl v5.8, you can use, e.g.,

      my $nbsp = chr utf8::unicode_to_native(0xA0);
      s/$nbsp/ /g;

  to handle the above regardless if it's an ASCII world or not)
}

您不太可能需要為自己建構這個類別的物件,但如果您想這麼做,請呼叫 Pod::Simple::PullParserTextToken->new( text )

另請參閱

Pod::Simple::PullParserTokenPod::SimplePod::Simple::Subclassing

支援

有關 POD 和 Pod::Simple 的問題或討論應傳送至 pod-people@perl.org 郵件清單。傳送空白電子郵件至 pod-people-subscribe@perl.org 以訂閱。

這個模組在開放的 GitHub 儲存庫中管理,https://github.com/perl-pod/pod-simple/。歡迎分岔和貢獻,或複製 git://github.com/perl-pod/pod-simple.git 並傳送修補程式!

歡迎針對 Pod::Simple 的修補程式。請將錯誤報告傳送至 <bug-pod-simple@rt.cpan.org>。

著作權和免責聲明

著作權所有 (c) 2002 Sean M. Burke。

這個函式庫是自由軟體;您可以在與 Perl 相同的條款下重新散布或修改它。

散布這個程式是希望它會有所用處,但沒有任何擔保;甚至沒有對特定目的的適售性或適用性的默示擔保。

作者

Pod::Simple 由 Sean M. Burke <sburke@cpan.org> 建立。但別打擾他,他已經退休了。

Pod::Simple 由下列人員維護