PHP xml_set_notation_decl_handler() 函数

定义和用法

xml_set_notation_decl_handler() 函数用于指定当解析器在 XML 文档中找到符号声明时要调用的函数。

注意:handler 参数也可以是一个包含对象引用和方法名称的数组。

实例

创建一个 XML 解析器,设置字符数据处理程序,设置符号声明处理程序,并解析 XML 文档:

<?php
// 创建 XML 解析器
$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("note_notation.xml", "r");

while ($data = fread($fp, 4096)) {
  // 解析 XML 数据
  xml_parse($parser, $data, feof($fp)) or
  die (sprintf("XML 错误:%s 在第 %d 行",
  xml_error_string(xml_get_error_code($parser)),
  xml_get_current_line_number($parser)));
}

xml_parser_free($parser);
fclose($fp);
?>

语法

xml_set_notation_decl_handler(parser, handler)
参数 描述
parser 必需。指定要使用的 XML 解析器
handler

必需。指定用作事件处理程序的函数。该函数必须接受五个参数:

  • $parser - 包含调用处理程序的 XML 解析器的变量
  • $name - 包含符号名称的变量
  • $base - 用于解析外部实体的系统标识符(system_id)的基础。目前,这始终是空字符串
  • $system_id - 外部符号声明的系统标识符
  • $public_id - 外部符号声明的公共标识符

技术细节

返回值: 成功时返回 TRUE。失败时返回 FALSE。
PHP 版本: 4.0+