XML::Grove::PerlSAXモジュール（日本語チョー訳）

by Hippo2000(1999/12/23)

XML::Grove::PerlSAXモジュールなのです。

なおこのドキュメントはXML::Groveモジュールをインストールしたときに一緒にはいるドキュメントを日本語に訳そうとしたものです。わかりにくい部分は本物を見てください。(^^;;

原本の著作権はKen MacLeod氏がお持ちです。
Ken MacLeodさんにはメールで了解をいただきました。

なお内容等が間違っていたら修正します。ご連絡ください。

名前

XML::Grove::PerlSAX - XMLオブジェクトのためのPerlSAX イベント・インターフェース

概要

 use XML::Grove::PerlSAX;

 $parser = XML::Grove::PerlSAX->new( [OPTIONS] );
 $result = $parser->parse( [OPTIONS] );

 # または
 $result = $xml_object->parse( [OPTIONS] );

説明

XML::Grove::PerlSAXはXML::GroveオブジェクトからPerlSAXイベントを生成するPerlSAXパーサです。このマニュアル・ページはXML::Grove::PerlSAXによってサポートされているオプション、ハンドラ、プロパティをまとめています；一般的な使用法の情報については、'PerlSAX.pod'でのPerlSAX標準をご覧下さい。

メソッド

new
新しいパーサ・オブジェクトを生成します。下記に説明する解析のためのデフォルトのオプションは、キーと値の組みあるいは１つのハッシュとして渡されます。オプションは他で記述がなければ、パーサ・オブジェクトで直接変更することができます。'parse()' に渡されるオプションは、解析の間、パーサ・オブジェクトでのデフォルト・オプションを上書きします。
parse
ドキュメントを解析します。下記で説明するオプションは、キーと値の組みあるいは１つのハッシュとして渡されます。'parse()'に渡されたオプションはパーサ・オブジェクトでのデフォルト・オプションを上書きします。

オプション

XML::Grove::PerlSAXは以下のオプションをサポートします：

 Handler          イベントを受け取るためのデフォルトのハンドラ
 DocumentHandler  ドキュメント・イベントを受け取るためのハンドラ
 Source           解析のための入力ソースが入ったハッシュ

何もハンドラが指定されていなければ、すべてのイベントは静かに無視されます。

１つのGrove引数が'parse()'メソッドに渡されれば、'Grove'パラメータを持った'Source'オプションが指定されたかのように扱われます。

'Source'ハッシュは以下のパラメータを持つことができます：

 Grove            解析イベントを生成するために使われるGroveオブジェクト...

ハンドラ

以下のイベントはXML::Grove::PerlSAXによって生成されます。XML::Grove::PerlSAXは対応するGroveオブジェクトをパラメータとして渡します、そのためハンドラに渡されるプロパティは、Groveの生成のとき使われたり、割り当てられたものになります。指定されるプロパティのリストについてはGroveを生成するために使われたパーサのドキュメントをご覧下さい。

DocumentHandlerメソッド

start_document
ドキュメントの始まりの通知を受け取ります。これはXML::Grove::Documentオブジェクトから、すべてのドキュメントの内容が処理される前に呼ばれます。
end_document
ドキュメントの終わりの通知を受け取ります。これはXML::Grove::Documentオブジェクトから、すべてのドキュメントの内容が処理された後に呼ばれます。
start_element
要素の始まりの通知を受け取ります。これはXML::Grove::Elementオブジェクトから、要素の内容が処理される前に呼ばれます。
end_element
要素の終わりの通知を受け取ります。これはXML::Grove::Elementオブジェクトから、要素の内容が処理された後に呼ばれます。
characters
文字データの通知を受け取ります。これはXML::Grove::Charactersオブジェクトから呼ばれます。
processing_instruction
処理命令の通知を受け取ります。これはXML::Grove::PIオブジェクトから呼ばれます。
comment
コメントの通知を受け取ります。XML::Grove::Commentオブジェクトから呼ばれます。

作者

Ken MacLeod, ken@bitsko.slc.ut.us

参考資料

perl(1), XML::Grove(3)

Extensible Markup Language (XML) <http://www.w3c.org/XML>

ホーム　Perlの小技

ご意見、ご質問はこちらの掲示板で受け付けています。
またメールは河馬屋(Nifty)にお願いします。