PHP xml_set_notation_decl_handler() 関数

定義と用法

xml_set_notation_decl_handler() 関数は、パーサーが XML 文書でシンボル宣言を見つけたときに呼び出される関数を定義します。

プロセッサーが成功して構築された場合、この関数は true を返します;それ以外の場合は false を返します。

注釈:「シンボル宣言」,英語では notation declaration であり、一部の文献では「注釈宣言」とも呼ばれます。

文法

xml_set_notation_decl_handler(parser,handler)
パラメータ 説明
parser 必要です。使用するXMLパーサーを定義します。
handler 必要です。パーサーがシンボル宣言を見つけたときに呼び出される関数を定義します。

handler パラメータで定義された関数は、6つのパラメータを持たなければなりません:

パラメータ 説明
parser 必要です。XMLパーサーを呼び出すための変数を定義します。
name 必要です。エンティティの名前を含む変数を定義します。
base

必要です。解析エンティティのシステム識別子(system_id)の基本を含む変数を定義します。

現在、このパラメータは通常空文字列に設定されています。

system_id 必要です。エンティティのシステム識別子を含む変数を定義します。
public_id 必要です。エンティティの公共識別子を含む変数を定義します。
notation 必須。実体データのデータタイプを示すシンボルを含む変数を指定します。

説明

handler 引数も配列で、その中にオブジェクトの参照とメソッド名を含むことができます。

实例

<?php
$parser=xml_parser_create();
function char($parser,$data)
  {
  echo $data;
  }
function not_decl_handler($parser,$not,$base,$sysID,$pubID)
  {
  echo "$not<br />";
  echo "$sysID<br />";
  echo "$pubID<BR />";
  }
xml_set_character_data_handler($parser,"char");
xml_set_notation_decl_handler($parser, "not_decl_handler");
$fp=fopen("test.xml","r");
while ($data=fread($fp,4096))
  {
  xml_parse($parser,$data,feof($fp)) or 
  die (sprintf("XML Error: %s at line %d", 
  xml_error_string(xml_get_error_code($parser)),
  xml_get_current_line_number($parser)));
  }
xml_parser_free($parser);
<?php