目錄

名稱

Pod::Simple::SimpleTree -- 將 Pod 解析成簡單的解析樹

語法

% cat ptest.pod

=head1 PIE

I like B<pie>!

% perl -MPod::Simple::SimpleTree -MData::Dumper -e \
   "print Dumper(Pod::Simple::SimpleTree->new->parse_file(shift)->root)" \
   ptest.pod

$VAR1 = [
          'Document',
          { 'start_line' => 1 },
          [
            'head1',
            { 'start_line' => 1 },
            'PIE'
          ],
          [
            'Para',
            { 'start_line' => 3 },
            'I like ',
            [
              'B',
              {},
              'pie'
            ],
            '!'
          ]
        ];

說明

撰寫 Pod 處理器/格式化程式的人會對這個類別感興趣。

這個類別會擷取 Pod 並解析它，傳回一個僅由陣列參考、雜湊參考和字串組成的解析樹。

這是 Pod::Simple 的子類別，並繼承其所有方法。

這個類別的靈感來自 XML::Parser 的「樹狀」解析樣式，儘管它並未使用完全相同的 LoL 格式。

方法

解析結束後，呼叫 $parser->root 以取得樹狀結構的頂端節點。

樹狀內容

解析樹中的每個元素節點都以陣列參考的形式表示：[ elementname, \%attributes, ...subnodes... ]。請參閱上方語法中的範例樹狀結構轉儲。

樹中的每個文字節點都以一個簡單的（非參考）字串純量表示。因此，您可以測試 ref($node) 以查看您擁有的是元素節點還是文字節點。

樹狀結構中的頂端節點是 [ 'Document', \%attributes, ...subnodes... ]

另請參閱

Pod::Simple

perllol

XML::Parser 中的「Tree」小節

支援

有關 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 由以下人員維護