PHP xml_set_notation_decl_handler() 函数

定义和用法

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

如果处理器被成功的建立,该函数将返回 true;否则返回 false。

注释:“符号声明”,英文为 notation declaration,也有部分文献译为“注释声明”。

语法

  1. xml_set_notation_decl_handler(parser,handler)
参数 描述
parser 必需。规定要使用的 XML 解析器。
handler 必需。规定当解析器找到符号声明时被调用的函数。

handler 参数规定的函数必须有六个参数:

参数 描述
parser 必需。规定一个变量,包含调用处理器的 XML 解析器。
name 必需。规定包含实体名称的变量。
base 必需。规定一个变量,包含解析实体的系统标识符(system_id )的基础。 当前该参数通常都被设置为空字符串。
system_id 必需。规定包含实体的系统标识符的变量。
public_id 必需。规定包含实体的公共标识符的变量。
notation 必需。规定一个变量,包含标识实体数据类型的符号。

说明

handler 参数也可以是一个数组,其中包含对象引用和方法名。

例子

  1. <?php
  2.  
  3. $parser=xml_parser_create();
  4.  
  5. function char($parser,$data)
  6. {
  7. echo $data;
  8. }
  9.  
  10. function not_decl_handler($parser,$not,$base,$sysID,$pubID)
  11. {
  12. echo "$not<br />";
  13. echo "$sysID<br />";
  14. echo "$pubID<BR />";
  15. }
  16.  
  17. xml_set_character_data_handler($parser,"char");
  18. xml_set_notation_decl_handler($parser, "not_decl_handler");
  19. $fp=fopen("test.xml","r");
  20.  
  21. while ($data=fread($fp,4096))
  22. {
  23. xml_parse($parser,$data,feof($fp)) or
  24. die (sprintf("XML Error: %s at line %d",
  25. xml_error_string(xml_get_error_code($parser)),
  26. xml_get_current_line_number($parser)));
  27. }
  28.  
  29. xml_parser_free($parser);
  30.  
  31. ?>