xml_set_character_data_handler

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_set_character_data_handler建立字符數(shù)據(jù)處理器

說明

xml_set_character_data_handler(resource $parser, callable $handler): bool

parser 變量指向的 XML 解析器指定字符數(shù)據(jù)處理函數(shù)。

參數(shù)

parser

XML 解析器的引用,用于建立字符數(shù)據(jù)處理器。

handler

handler 為表示一個(gè)函數(shù)名稱的字符串,該函數(shù)必須在為 parser 指定的解析器調(diào)用 xml_parse() 函數(shù)時(shí)已存在。

handler 參數(shù)命名的函數(shù)名必須接受兩個(gè)參數(shù):

handler(resource $parser, string $data)
parser
第一個(gè)參數(shù) parser 為指向要調(diào)用處理器的 XML 解析器的指針。
data
第二個(gè)參數(shù) data 為包含有字符數(shù)據(jù)的字符串。

Character data handler is called for every piece of a text in the XML document. It can be called multiple times inside each fragment (e.g. for non-ASCII strings).

如果處理器函數(shù)名被設(shè)置為空字符串或者 false,則該有問題的處理器將被屏蔽。

注意: 除了函數(shù)名,含有對(duì)象引用的數(shù)組和方法名也可以作為參數(shù)。

返回值

成功時(shí)返回 true, 或者在失敗時(shí)返回 false。