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 Функция,规定的参数必须有六个:

Параметры Описание
parser Обязателен. Определяет переменную, содержащую XML-анализатор, вызываемый процессором.
name Обязателен. Определяет переменную, содержащую имя объекта.
base

Обязателен. Определяет переменную, содержащую базу для системной идентификационной метки объекта (system_id).

В настоящее время этот параметр обычно устанавливается в пустую строку.

system_id Обязателен. Определяет переменную, содержащую системную идентификационную метку объекта.
public_id Обязателен. Определяет переменную, содержащую общую идентификационную метку объекта.
notation Обязателен. Определяет переменную, содержащую символы, идентифицирующие тип данных entidades.

Описание

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: %s в строке %d", 
  xml_error_string(xml_get_error_code($parser)),
  xml_get_current_line_number($parser)));
  }
xml_parser_free($parser);
?>