PHP xml_set_notation_decl_handler() 函數(shù)
定義和用法
xml_set_notation_decl_handler() 函數(shù)規(guī)定當(dāng)解析器在 XML 文檔中找到符號(hào)聲明時(shí)被調(diào)用的函數(shù)。
如果處理器被成功的建立,該函數(shù)將返回 true;否則返回 false。
注釋:“符號(hào)聲明”,英文為 notation declaration,也有部分文獻(xiàn)譯為“注釋聲明”。
語法
xml_set_notation_decl_handler(parser,handler)
參數(shù) | 描述 |
---|---|
parser | 必需。規(guī)定要使用的 XML 解析器。 |
handler | 必需。規(guī)定當(dāng)解析器找到符號(hào)聲明時(shí)被調(diào)用的函數(shù)。 |
由 handler 參數(shù)規(guī)定的函數(shù)必須有六個(gè)參數(shù):
參數(shù) | 描述 |
---|---|
parser | 必需。規(guī)定一個(gè)變量,包含調(diào)用處理器的 XML 解析器。 |
name | 必需。規(guī)定包含實(shí)體名稱的變量。 |
base |
必需。規(guī)定一個(gè)變量,包含解析實(shí)體的系統(tǒng)標(biāo)識(shí)符(system_id )的基礎(chǔ)。 當(dāng)前該參數(shù)通常都被設(shè)置為空字符串。 |
system_id | 必需。規(guī)定包含實(shí)體的系統(tǒng)標(biāo)識(shí)符的變量。 |
public_id | 必需。規(guī)定包含實(shí)體的公共標(biāo)識(shí)符的變量。 |
notation | 必需。規(guī)定一個(gè)變量,包含標(biāo)識(shí)實(shí)體數(shù)據(jù)類型的符號(hào)。 |
說明
handler 參數(shù)也可以是一個(gè)數(shù)組,其中包含對(duì)象引用和方法名。
例子
<?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);
?>