Skip to content

Commit 9ae9168

Browse files
mowangjuanzimowangjuanzi
committed
Update array/cubrid/curl/datetime/dio/errorfunc/fileinfo/filesystem
1 parent e51eb6f commit 9ae9168

File tree

11 files changed

+448
-258
lines changed

11 files changed

+448
-258
lines changed

‎reference/array/functions/each.xml‎

Lines changed: 23 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,25 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: a6655e3f9508eee6860b02f55e33560a790f42d1 Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: HonestQiao Status: ready -->
4+
<!-- CREDITS: mowangjuanzi -->
45
<refentry xml:id="function.each" xmlns="http://docbook.org/ns/docbook">
5-
<refnamediv>
6-
<refname>each</refname>
7-
<refpurpose>返回数组中当前的键／值对并将数组指针向前移动一步</refpurpose>
8-
</refnamediv>
9-
6+
<refnamediv>
7+
<refname>each</refname>
8+
<refpurpose>返回数组中当前的键／值对并将数组指针向前移动一步</refpurpose>
9+
</refnamediv>
10+
1011
<refsynopsisdiv>
11-
&warn.deprecated.function-7-2-0.removed-8-0-0;
12+
&warn.deprecated.function-7-2-0.removed-8-0-0;
1213
</refsynopsisdiv>
13-
14+
1415
<refsect1 role="description">
1516
&reftitle.description;
1617
<methodsynopsis>
1718
<type>array</type><methodname>each</methodname>
1819
<methodparam><type class="union"><type>array</type><type>object</type></type><parameter role="reference">array</parameter></methodparam>
1920
</methodsynopsis>
2021
<para>
21-
返回数组中当前的键／值对并将数组指针向前移动一步
22+
返回数组中当前的键／值对并将数组指针向前移动一步
2223
</para>
2324
<para>
2425
在执行 <function>each</function>
@@ -44,20 +45,20 @@
4445
<refsect1 role="returnvalues">
4546
&reftitle.returnvalues;
4647
<para>
47-
返回 <parameter>array</parameter> 数组中当前指针位置的键／值对并向前移动数组指针。键值对被返回为四个单元的数组，键名为<literal>0</literal>，<literal>1</literal>，<literal>key</literal>和 <literal>value</literal>。单元 <literal>0</literal> 和
48-
<literal>key</literal> 包含有数组单元的键名，<literal>1</literal> 和
49-
<literal>value</literal> 包含有数据。
48+
返回 <parameter>array</parameter> 数组中当前指针位置的键／值对并向前移动数组指针。键值对被返回为四个单元的数组，键名为<literal>0</literal>，<literal>1</literal>，<literal>key</literal>和 <literal>value</literal>。单元 <literal>0</literal> 和
49+
<literal>key</literal> 包含有数组单元的键名，<literal>1</literal> 和
50+
<literal>value</literal> 包含有数据。
5051
</para>
5152
<para>
52-
如果内部指针越过了数组的末端，则 <function>each</function> 返回 &false;。
53+
如果内部指针越过了数组的末端，则 <function>each</function> 返回 &false;。
5354
</para>
5455
</refsect1>
5556
<refsect1 role="examples">
5657
&reftitle.examples;
5758
<para>
5859
<example>
59-
<title><function>each</function> 例子</title>
60-
<programlisting role="php">
60+
<title><function>each</function> 示例</title>
61+
<programlisting role="php" annotations="non-interactive">
6162
<![CDATA[
6263
<?php
6364
$foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
@@ -84,7 +85,7 @@ Array
8485
</para>
8586
<para>
8687
<informalexample>
87-
<programlisting role="php">
88+
<programlisting role="php" annotations="non-interactive">
8889
<![CDATA[
8990
<?php
9091
$foo = array("Robert" => "Bob", "Seppo" => "Sepi");
@@ -111,10 +112,10 @@ Array
111112
</para>
112113
<para>
113114
<function>each</function> 经常和 <function>list</function>
114-
结合使用来遍历数组，例如：
115+
结合使用来遍历数组，例如：
115116
<example>
116117
<title>用 <function>each</function> 遍历数组</title>
117-
<programlisting role="php">
118+
<programlisting role="php" annotations="non-interactive">
118119
<![CDATA[
119120
<?php
120121
$fruit = array('a' => 'apple', 'b' => 'banana', 'c' => 'cranberry');
@@ -137,10 +138,10 @@ c => cranberry
137138
</example>
138139
</para>
139140
<caution>
140-
<para>
141-
因为将一个数组赋值给另一个数组时会重置原来的数组指针，因此在上边的例子中如果我们在循环内部将
142-
<varname>$fruit</varname> 赋给了另一个变量的话将会导致无限循环。
143-
</para>
141+
<para>
142+
因为将一个数组赋值给另一个数组时会重置原来的数组指针，因此在上边的例子中如果我们在循环内部将
143+
<varname>$fruit</varname> 赋给了另一个变量的话将会导致无限循环。
144+
</para>
144145
</caution>
145146
<warning>
146147
<para>

‎reference/array/functions/extract.xml‎

Lines changed: 12 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: d58ee8eaaa7f716c51f66f5f1058ab3c42376d98 Maintainer: HonestQiao Status: ready -->
4-
<!-- CREDITS: Luffy -->
3+
<!-- EN-Revision: f53ab502a11a52e82baca372c37d64e3f298b17c Maintainer: HonestQiao Status: ready -->
4+
<!-- CREDITS: Luffy, mowangjuanzi -->
55
<refentry xml:id="function.extract" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
77
<refname>extract</refname>
@@ -153,17 +153,10 @@
153153
&reftitle.examples;
154154
<para>
155155
<example>
156-
<title><function>extract</function> 例子</title>
157-
<para>
158-
<function>extract</function> 的一种可能用法是将 <function>wddx_deserialize</function>
159-
返回的结合数组中的内容导入到符号表变量中去。
160-
</para>
156+
<title><function>extract</function> 示例</title>
161157
<programlisting role="php">
162158
<![CDATA[
163159
<?php
164-
165-
/* 假定 $var_array 是 wddx_deserialize 返回的数组*/
166-
167160
$size = "large";
168161
$var_array = array(
169162
"color" => "blue",
@@ -185,13 +178,13 @@ blue, large, sphere, medium
185178
]]>
186179
</screen>
187180
<para>
188-
<varname>$size</varname> 没有被覆盖，因为指定了
189-
<constant>EXTR_PREFIX_SAME</constant>，这使得 <varname>$wddx_size</varname>
181+
<varname>$size</varname> 没有被覆盖，因为指定了
182+
<constant>EXTR_PREFIX_SAME</constant>，这使得 <varname>$wddx_size</varname>
190183
被建立。如果指定了 <constant>EXTR_SKIP</constant>，则 <varname>$wddx_size</varname>
191-
也不会被建立。<constant>EXTR_OVERWRITE</constant> 将使 <varname>$size</varname>
192-
的值为“medium”，<constant>EXTR_PREFIX_ALL</constant> 将建立新变量
193-
<varname>$wddx_color</varname>，<varname>$wddx_size</varname> 和
194-
<varname>$wddx_shape</varname>。
184+
也不会被建立。<constant>EXTR_OVERWRITE</constant> 将使 <varname>$size</varname>
185+
的值为“medium”，<constant>EXTR_PREFIX_ALL</constant> 将建立新变量
186+
<varname>$wddx_color</varname>，<varname>$wddx_size</varname> 和
187+
<varname>$wddx_shape</varname>。
195188
</para>
196189
</example>
197190
</para>
@@ -200,13 +193,13 @@ blue, large, sphere, medium
200193
&reftitle.notes;
201194
<warning>
202195
<para>
203-
不要对不能信任的数据使用
204-
<function>extract</function>，例如用户的输入（<varname>$_GET</varname>， <varname>$_FILES</varname>...）。
196+
不要对不能信任的数据使用
197+
<function>extract</function>，例如用户的输入（<varname>$_GET</varname>、<varname>$_FILES</varname>...）。
205198

206199
如果这样做，要确保使用不会覆盖的
207200
<parameter>flags</parameter> 值，例如
208201
<constant>EXTR_SKIP</constant>，并且要留意应该按照
209-
<link linkend="ini.variables-order">variables_order</link>
202+
<link linkend="ini.variables-order">variables_order</link>
210203
在 <link linkend="ini">&php.ini;</link> 里
211204
定义的顺序来提取。
212205
</para>

‎reference/array/functions/in-array.xml‎

Lines changed: 26 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,25 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 8cd7c0d8c574903e149c1da0689a8728cdf909d4 Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: HonestQiao Status: ready -->
4+
<!-- CREDITS: mowangjuanzi -->
45
<refentry xml:id="function.in-array" xmlns="http://docbook.org/ns/docbook">
5-
<refnamediv>
6-
<refname>in_array</refname>
7-
<refpurpose>检查数组中是否存在某个值</refpurpose>
8-
</refnamediv>
6+
<refnamediv>
7+
<refname>in_array</refname>
8+
<refpurpose>检查数组中是否存在某个值</refpurpose>
9+
</refnamediv>
910
<refsect1 role="description">
1011
&reftitle.description;
11-
<methodsynopsis>
12-
<type>bool</type><methodname>in_array</methodname>
13-
<methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
14-
<methodparam><type>array</type><parameter>haystack</parameter></methodparam>
12+
<methodsynopsis>
13+
<type>bool</type><methodname>in_array</methodname>
14+
<methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
15+
<methodparam><type>array</type><parameter>haystack</parameter></methodparam>
1516
<methodparam choice="opt"><type>bool</type><parameter>strict</parameter><initializer>&false;</initializer></methodparam>
16-
</methodsynopsis>
17-
<para>
18-
大海捞针，在大海（<parameter>haystack</parameter>）中搜索针（
19-
<parameter>needle</parameter>），如果没有设置 <parameter>strict</parameter> 则使用宽松的比较。
20-
</para>
21-
</refsect1>
17+
</methodsynopsis>
18+
<para>
19+
大海捞针，在大海（<parameter>haystack</parameter>）中搜索针（<parameter>needle</parameter>），如果没有设置
20+
<parameter>strict</parameter> 则使用宽松的比较。
21+
</para>
22+
</refsect1>
2223
<refsect1 role="parameters">
2324
&reftitle.parameters;
2425
<para>
@@ -48,10 +49,10 @@
4849
<term><parameter>strict</parameter></term>
4950
<listitem>
5051
<para>
51-
如果第三个参数 <parameter>strict</parameter> 的值为
52-
&true; 则 <function>in_array</function> 函数还会检查
53-
<parameter>needle</parameter> 的<link linkend="language.types">类型</link>是否和
54-
<parameter>haystack</parameter> 中的相同。
52+
如果第三个参数 <parameter>strict</parameter> 的值为
53+
&true; 则 <function>in_array</function> 函数还会检查
54+
<parameter>needle</parameter> 的<link linkend="language.types">类型</link>是否和
55+
<parameter>haystack</parameter> 中的相同。
5556
</para>
5657
<note>
5758
<para>
@@ -74,7 +75,7 @@
7475
&reftitle.examples;
7576
<para>
7677
<example>
77-
<title><function>in_array</function> 例子</title>
78+
<title><function>in_array</function> 示例</title>
7879
<programlisting role="php">
7980
<![CDATA[
8081
<?php
@@ -89,8 +90,8 @@ if (in_array("mac", $os)) {
8990
]]>
9091
</programlisting>
9192
<para>
92-
第二个条件失败，因为 <function>in_array</function>
93-
是区分大小写的，所以以上程序显示为：
93+
第二个条件失败，因为 <function>in_array</function>
94+
是区分大小写的，所以以上程序显示为：
9495
</para>
9596
<screen>
9697
<![CDATA[
@@ -101,7 +102,7 @@ Got Irix
101102
</para>
102103
<para>
103104
<example>
104-
<title><function>in_array</function> 严格类型检查例子</title>
105+
<title><function>in_array</function> 严格类型检查示例</title>
105106
<programlisting role="php">
106107
<![CDATA[
107108
<?php
@@ -150,8 +151,8 @@ if (in_array('o', $a)) {
150151
&example.outputs;
151152
<screen>
152153
<![CDATA[
153-
'ph' was found
154-
'o' was found
154+
'ph' was found
155+
'o' was found
155156
]]>
156157
</screen>
157158
</example>

0 commit comments

Comments
 (0)