XML::Encoding v1.01

Hippo2000 (2000/12/10)

XML::Encodingなのです。XML::Parserのためのエンコーディングマップのためのモジュールです。Unicode系モジュールともいえるでしょう。

作者はClark Cooperさんです。メールで許可をいただきました。

目次

• 名前
• 概要
• 説明
• メソッド
• 作者
• 参考資料

名前

XML::Encoding - XMLエンコーディング・マップを解析するためのPerlモジュール

概要

  use XML::Encoding;
  my $em_parser = new XML::Encoding(ErrorContext  => 2,
                                    ExpatRequired => 1,
                                    PushPrefixFcn => \&push_prefix,
                                    PopPrefixFcn  => \&pop_prefix,
                                    RangeSetFcn   => \&range_set);

  my $encmap_name = $em_parser->parsefile($ARGV[0]);

説明

このモジュール、これはXML::Parserのサブクラスとして構築され、XMLファイルであるエンコーディング・マップファイルのためのパーサーを提供します。ディストリビューションに入っている maps/encmap.dtd というファイルが、これらのファイルの構造について説明しています。parserメソッドを呼び出すと、エンコーディング・マップの名前を返します。（ルート要素のname属性から取得されます）。マップの内容はコールバック関数 push_prefix、pop_prefix、range_setを通して処理されます。

メソッド

このモジュールはXML::Parserにより提供されるメソッドの他に何も提供しませんが、以下の追加のオプションをとります。

• ExpatRequired
  もしこれにtrue値が設定されていたら、encmap "expat"属性が"yes"に設定されていなければエラーが発生します。この属性が設定されていれば、ExpatRequiredオプションが設定されていようがいまいが、パーサーはexpatモードに入ります。expatモードでは、パーサーはエンコーディングがexpatの制限を破っていないかどうかをチェックします。
• PushPrefixFcn
  対応する値は、prefix要素が開始したときに呼ばれるコード・リファレンスでなければんなりません。そのコールバックへのたった１つの引数はprefixのバイトの値である整数です。もし正常であればundefが返されます。定義されている値はエラーを起こし、それはメッセージ文字列として使われます。
• PopPrefixFcn
  対応する値は、prefix要素が終了するときに呼ばれるコード・リファレンスでなければなりません。この関数には何も引数が渡されません。もし正常であればundefが返されます。定義されている値はエラーを起こし、それはメッセージ文字列として使われます。
• RangeSetFcn
  "range"または"ch"要素が見つかったときに呼ばれるコード・リファレンスでなければなりません。この関数には３つの引数が渡されます：（バイト、Unicode_scalar、長さ）。バイトは範囲の開始するバイトまたはまたあｈ"ch"要素によりマッピングされるバイトです。unicode_scalarは、（現在のprefixでの）このバイトのUnicodeの値です。範囲(range）の長さが最後の引数になります。これは"ch"要素では1になります。もし正常であればundefが返されます。定義されている値はエラーを起こし、それはメッセージ文字列として使われます。

作者

Clark Cooper <coopercc@netheaven.com>

参考資料

XML::Parser

ホーム　Perlの小技

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