xml_set_notation_decl_handler
(PHP 3>= 3.0.6, PHP 4 )
xml_set_notation_decl_handler -- 建立注釋聲明處理器
說明
bool xml_set_notation_decl_handler ( resource parser, callback handler)
為 parser 參數指定的 XML 解析器建立注釋聲明處理器函式。參數 start_element_handler 和 end_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。
備註:
第二個參數函式名可以替換為一個數組,該數組由一個對象名和該對象名的一個方法名兩個元素組成。