xml_set_notation_decl_handler

(PHP 3 >= 3.0.6, PHP 4, PHP 5)

xml_set_notation_decl_handler -- 建立注解聲明處理器

說明

bool xml_set_notation_decl_handler ( resource parser, callback handler )

parser 參數特殊的 XML 解析器建立注解聲明處理器函數。參數 start_element_handlerend_element_handler 為表示函數名稱的字串,這些函數必須在為 parser 特殊的解析器呼叫 xml_parse() 函數時已存在。

注解聲明是文件 DTD 的一部分,並有如下格式:
<!NOTATION <parameter>name</parameter>
{<parameter>system_id</parameter> | <parameter>public_id</parameter>}?>
。請參考 XML 1.0 參考的第 4.7 節以瞭解注解聲明的定義。

handler 參數命名的函數名必須接受五個參數: handler ( resource parser, string notation_name, string base, string system_id, string public_id )

parser

第一個參數 parser 為指向要呼叫處理器的 XML 解析器的指標。

notation_name

該參數為以上注解格式定義中的 name 參數。

base

這個參數是解析注解聲明的系統標識符(system_id)的基礎。現用的該參數通常都被設定為空字串。

system_id

外部注解聲明的系統標識符。

public_id

外部注解聲明的公共標識符。

若果處理器函數名被設定為空字串或是 FALSE,則該有問題的處理器將被屏蔽。

若果處理器被成功的建立,該函數將返回 TRUE;若果 parser 指向的不是合法的解析器,函數該函數將返回 FALSE

注: 除了函數名,還可以用一個陣列作參數,該陣列由一個物件名和該對象的一個方法名兩個元素組成。