(PHP 4, PHP 5)
xml_set_character_data_handler — 建立字符数据处理器
为 parser
变量指向的 XML 解析器指定字符数据处理函数。handler
为表示一个函数名称的字符串,该函数必须在为 parser
指定的解析器调用 xml_parse() 函数时已存在。
由 handler
参数命名的函数名必须接受两个参数:
$parser
, string $data
)parser
data
data
为包含有字符数据的字符串。
如果处理器函数名被设置为空字符串或者 FALSE
,则该有问题的处理器将被屏蔽。
如果处理器被成功的建立,该函数将返回 TRUE
,如果 parser
指向的不是合法的解析器,函数该函数将返回 FALSE
。
Note: 除了函数名,含有对象引用的数组和方法名也可以作为参数。
parser
A reference to the XML parser to set up character data handler function.
handler
handler
is a string containing the name of a
function that must exist when xml_parse() is called
for parser
.
The function named by handler
must accept
two parameters:
$parser
, string $data
)parser
data
data
, contains
the character data as a string.
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).
If a handler function is set to an empty string, or FALSE
, the handler
in question is disabled.
Note: 除了函数名,含有对象引用的数组和方法名也可以作为参数。
成功时返回 TRUE
, 或者在失败时返回 FALSE
.