uTools-Manuals/docs/php/xml_set_character_data_handler.html
2019-04-08 23:22:26 +08:00

117 lines
4.1 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>建立字符数据处理器</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.xml-set-character-data-handler" class="refentry">
<div class="refnamediv">
<h1 class="refname">xml_set_character_data_handler</h1>
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">xml_set_character_data_handler</span> &mdash; <span class="dc-title">建立字符数据处理器</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.xml-set-character-data-handler-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>xml_set_character_data_handler</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$parser</code></span>
, <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$handler</code></span>
) : <span class="type">bool</span></div>
<p class="para rdfs-comment">
<code class="parameter">parser</code> 变量指向的 XML 解析器指定字符数据处理函数。
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.xml-set-character-data-handler-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">parser</code></dt>
<dd>
<p class="para">
XML 解析器的引用,用于建立字符数据处理器。
</p>
</dd>
<dt>
<code class="parameter">handler</code></dt>
<dd>
<p class="para">
<code class="parameter">handler</code> 为表示一个函数名称的字符串,该函数必须在为 <code class="parameter">parser</code> 指定的解析器调用 <span class="function"><a href="xml_parse.html" class="function">xml_parse()</a></span> 函数时已存在。
</p>
<p class="para">
<code class="parameter">handler</code> 参数命名的函数名必须接受两个参数:
<div class="methodsynopsis dc-description">
<span class="methodname"><span class="replaceable">handler</span></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$parser</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$data</code></span>
)</div>
<dl>
<dt>
<code class="parameter">parser</code></dt>
<dd>
<span class="simpara">
第一个参数 <span class="replaceable">parser</span> 为指向要调用处理器的 XML 解析器的指针。
</span>
</dd>
<dt>
<code class="parameter">data</code></dt>
<dd>
<span class="simpara">
第二个参数 <code class="parameter">data</code> 为包含有字符数据的字符串。
</span>
</dd>
</dl>
</p>
<p class="para">
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).
</p>
<p class="para">
如果处理器函数名被设置为空字符串或者 <strong><code>FALSE</code></strong>,则该有问题的处理器将被屏蔽。
</p>
<blockquote class="note"><p><strong class="note">Note</strong>: <span class="simpara">除了函数名,含有对象引用的数组和方法名也可以作为参数。</span></p></blockquote>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.xml-set-character-data-handler-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
成功时返回 <strong><code>TRUE</code></strong> 或者在失败时返回 <strong><code>FALSE</code></strong>
</p>
</div>
</div></div></div></body></html>