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

121 lines
5.3 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.mb-convert-variables" class="refentry">
<div class="refnamediv">
<h1 class="refname">mb_convert_variables</h1>
<p class="verinfo">(PHP 4 &gt;= 4.0.6, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">mb_convert_variables</span> &mdash; <span class="dc-title">转换一个或多个变量的字符编码</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.mb-convert-variables-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>mb_convert_variables</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$to_encoding</code></span>
, <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter">$from_encoding</code></span>
, <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter reference">&$vars</code></span>
[, <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter reference">&$...</code></span>
] ) : <span class="type">string</span></div>
<p class="para rdfs-comment">
将变量 <code class="parameter">vars</code> 的编码从 <code class="parameter">from_encoding</code> 转换成编码 <code class="parameter">to_encoding</code>
</p>
<p class="para">
<span class="function"><strong>mb_convert_variables()</strong></span> 会拼接变量数组或对象中的字符串来检测编码,因为短字符串的检测往往会失败。因此,不能在一个数组或对象中混合使用编码。
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.mb-convert-variables-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">to_encoding</code></dt>
<dd>
<p class="para">
<span class="type"><a href="language.types.string.html" class="type string">string</a></span> 转换成这个编码。
</p>
</dd>
<dt>
<code class="parameter">from_encoding</code></dt>
<dd>
<p class="para">
<code class="parameter">from_encoding</code> 可以指定为一个 <span class="type"><a href="language.types.array.html" class="type array">array</a></span> 或者逗号分隔的 <span class="type"><a href="language.types.string.html" class="type string">string</a></span>,它将尝试根据 <code class="parameter">from-coding</code> 来检测编码。
当省略了 <code class="parameter">from_encoding</code>,将使用 <em>detect_order</em>
</p>
</dd>
<dt>
<code class="parameter">vars</code></dt>
<dd>
<p class="para">
<code class="parameter">vars</code> 是要转换的变量的引用。
参数可以接受 String、Array 和 Object 的类型。
<span class="function"><strong>mb_convert_variables()</strong></span> 假设所有的参数都具有同样的编码。
</p>
</dd>
<dt>
<code class="parameter">...</code></dt>
<dd>
<p class="para">
额外的 <code class="parameter">vars</code>
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.mb-convert-variables-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
成功时返回转换前的字符编码,失败时返回 <strong><code>FALSE</code></strong>
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.mb-convert-variables-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-3176">
<p><strong>Example #1 <span class="function"><strong>mb_convert_variables()</strong></span> 例子</strong></p>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">/*&nbsp;转换变量&nbsp;$post1、$post2&nbsp;编码为内部internal编码&nbsp;*/<br /></span><span style="color: #0000BB">$interenc&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">mb_internal_encoding</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$inputenc&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">mb_convert_variables</span><span style="color: #007700">(</span><span style="color: #0000BB">$interenc</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"ASCII,UTF-8,SJIS-win"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$post1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$post2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
</div>
</p>
</div>
</div></div></div></body></html>