Skip to content

Commit 58d3442

Browse files
sy-recordssy-records
authored
Merge branch 'master' into strings
2 parents 6bd4704 + f8a561d commit 58d3442

35 files changed

+497
-216
lines changed

‎language-snippets.ent‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: dd4d6c1217c4bc53eeadc65b5b67bf29ba429993 Maintainer: Gregory Status: ready -->
3+
<!-- EN-Revision: 239683eb0b1d6163da56a604d3ae1ecac0373bdd Maintainer: Gregory Status: ready -->
44
<!-- CREDITS: dallas, mowangjuanzi, Luffy -->
55
<!-- 请保持此文件与英文文件中相应的每个 ENTITY 行号一一对应以便于对照，修改与更新！ -->
66

@@ -375,6 +375,13 @@ xmlns="http://docbook.org/ns/docbook"><simpara>本特性已自 PHP 8.4.0
375375
xmlns="http://docbook.org/ns/docbook"><simpara>此函数自 PHP 8.4.0
376376
起<emphasis>弃用</emphasis>。强烈建议不要应用此函数。</simpara></warning>'>
377377

378+
<!ENTITY warn.deprecated.feature-8-5-0 '<warning
379+
xmlns="http://docbook.org/ns/docbook"><simpara>此功能自 PHP 8.5.0
380+
起<emphasis>弃用</emphasis>。强烈建议不要应用此功能。</simpara></warning>'>
381+
382+
<!ENTITY warn.deprecated.function-8-5-0 '<warning
383+
xmlns="http://docbook.org/ns/docbook"><simpara>此函数自 PHP 8.5.0
384+
起<emphasis>弃用</emphasis>。强烈建议不要应用此函数。</simpara></warning>'>
378385

379386
<!ENTITY removed.php.future '本过时特性<emphasis
380387
xmlns="http://docbook.org/ns/docbook">将</emphasis>肯定会在未来被<emphasis xmlns="http://docbook.org/ns/docbook">移除</emphasis>。'>

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

Lines changed: 20 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,26 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 71e3c74047f04b26aa1be51215d7129e15dc2993 Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: HonestQiao Status: ready -->
44
<!-- CREDITS: mowangjuanzi, Luffy -->
55
<refentry xml:id="function.array-combine" xmlns="http://docbook.org/ns/docbook">
6-
<refnamediv>
7-
<refname>array_combine</refname>
8-
<refpurpose>
9-
创建一个数组，用一个数组的值作为其键名，另一个数组的值作为其值
10-
</refpurpose>
11-
</refnamediv>
6+
<refnamediv>
7+
<refname>array_combine</refname>
8+
<refpurpose>创建一个数组，用一个数组的值作为其键名，另一个数组的值作为其值</refpurpose>
9+
</refnamediv>
10+
1211
<refsect1 role="description">
1312
&reftitle.description;
14-
<methodsynopsis>
15-
<type>array</type><methodname>array_combine</methodname>
16-
<methodparam><type>array</type><parameter>keys</parameter></methodparam>
17-
<methodparam><type>array</type><parameter>values</parameter></methodparam>
18-
</methodsynopsis>
19-
<para>
20-
返回一个 <type>array</type>，用来自
21-
<parameter>keys</parameter> 数组的值作为键名，来自
22-
<parameter>values</parameter> 数组的值作为相应的值。
23-
</para>
24-
</refsect1>
13+
<methodsynopsis>
14+
<type>array</type><methodname>array_combine</methodname>
15+
<methodparam><type>array</type><parameter>keys</parameter></methodparam>
16+
<methodparam><type>array</type><parameter>values</parameter></methodparam>
17+
</methodsynopsis>
18+
<para>
19+
返回 <type>array</type>，用来自
20+
<parameter>keys</parameter> 数组的值作为键名，来自
21+
<parameter>values</parameter> 数组的值作为相应的值。
22+
</para>
23+
</refsect1>
2524

2625
<refsect1 role="parameters">
2726
&reftitle.parameters;
@@ -91,7 +90,7 @@
9190
&reftitle.examples;
9291
<para>
9392
<example>
94-
<title>一个 <function>array_combine</function> 简单的例子</title>
93+
<title><function>array_combine</function> 简单的示例</title>
9594
<programlisting role="php">
9695
<![CDATA[
9796
<?php
@@ -108,8 +107,8 @@ print_r($c);
108107
<![CDATA[
109108
Array
110109
(
111-
[green] => avocado
112-
[red] => apple
110+
[green] => avocado
111+
[red] => apple
113112
[yellow] => banana
114113
)
115114
]]>

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

Lines changed: 27 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: c84024092aee02b51dd18b909af0f2ccbdd24f98 Maintainer: daijie Status: ready -->
4-
<refentry xml:id="function.array-diff" xmlns="http://docbook.org/ns/docbook">
5-
<refnamediv>
6-
<refname>array_diff</refname>
7-
<refpurpose>计算数组的差集</refpurpose>
8-
</refnamediv>
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: daijie Status: ready -->
4+
<!-- CREDITS: mowangjuanzi -->
5+
<refentry xml:id="function.array-diff" xmlns="http://docbook.org/ns/docbook">
6+
<refnamediv>
7+
<refname>array_diff</refname>
8+
<refpurpose>计算数组的差集</refpurpose>
9+
</refnamediv>
910

1011
<refsect1 role="description">
1112
&reftitle.description;
@@ -16,10 +17,11 @@
1617
</methodsynopsis>
1718
<para>
1819
对比 <parameter>array</parameter> 和其他一个或者多个数组，返回在
19-
<parameter>array</parameter> 中但是不在其他 array 里的值。
20+
<parameter>array</parameter> 中但是不在其他 array 里的值。
2021
</para>
2122
</refsect1>
22-
<refsect1 role="parameters">
23+
24+
<refsect1 role="parameters">
2325
&reftitle.parameters;
2426
<para>
2527
<variablelist>
@@ -43,12 +45,12 @@
4345
</para>
4446
</refsect1>
4547

46-
<refsect1 role="returnvalues">
48+
<refsect1 role="returnvalues">
4749
&reftitle.returnvalues;
4850
<para>
49-
返回一个数组，该数组包括了所有在
50-
<parameter>array</parameter> 中但是不在任何其它参数数组中的值。注意键名保留不变。
51-
保留数组 <parameter>array</parameter> 里的键。
51+
返回一个数组，该数组包括了所有在 <parameter>array</parameter>
52+
中但是不在任何其它参数数组中的值。注意键名保留不变。保留数组
53+
<parameter>array</parameter> 里的键。
5254
</para>
5355
</refsect1>
5456

@@ -75,7 +77,7 @@
7577
&reftitle.examples;
7678
<para>
7779
<example>
78-
<title><function>array_diff</function> 例子</title>
80+
<title><function>array_diff</function> 示例</title>
7981
<programlisting role="php">
8082
<![CDATA[
8183
<?php
@@ -101,12 +103,13 @@ Array
101103
</example>
102104
</para>
103105

106+
<para>
107+
两个元素只有在 <literal>(string) $elem1 === (string) $elem2</literal> 相等时视为一致。 也就是<link linkend="language.types.string.casting">字符串转换表达</link>相同。
108+
</para>
109+
104110
<para>
105111
<example>
106112
<title><function>array_diff</function> 不匹配类型的示例</title>
107-
<para>
108-
两个元素只有在 <literal>(string) $elem1 === (string) $elem2</literal> 相等时视为一致。 也就是<link linkend="language.types.string.casting">字符串转换表达</link>相同。
109-
</para>
110113
<programlisting role="php">
111114
<![CDATA[
112115
<?php
@@ -134,28 +137,29 @@ $filter = [new S('b'), new S('c'), new S('d')];
134137
$result = array_diff($source, $filter);
135138
136139
// $result 包含了一个 S('a'); 实例
140+
var_dump($result);
137141
?>
138142
]]>
139143
</programlisting>
140-
<para>
141-
想要使用函数来比较，可使用 <function>array_udiff</function>。
142-
</para>
143144
</example>
144145
</para>
146+
<para>
147+
想要使用函数来比较，可使用 <function>array_udiff</function>。
148+
</para>
145149
</refsect1>
146150

147-
<refsect1 role="notes">
151+
<refsect1 role="notes">
148152
&reftitle.notes;
149153
<note>
150154
<para>
151155
注意本函数只检查了多维数组中的一维。当然可以用
152-
<literal>array_diff($array1[0], $array2[0]);</literal>
153-
检查更深的维度。
156+
<literal>array_diff($array1[0], $array2[0]);</literal>
157+
检查更深的维度。
154158
</para>
155159
</note>
156160
</refsect1>
157161

158-
<refsect1 role="seealso">
162+
<refsect1 role="seealso">
159163
&reftitle.seealso;
160164
<para>
161165
<simplelist>

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

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: ce882c196dce81bf6bd4d94af4fa4110ddc49ef4 Maintainer: dallas Status: ready -->
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: dallas Status: ready -->
44
<!-- CREDITS: mowangjuanzi -->
55
<refentry xml:id="function.array-fill" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -106,7 +106,7 @@
106106
&reftitle.examples;
107107
<para>
108108
<example xml:id="function.array-fill.example.basic">
109-
<title><function>array_fill</function> 例子</title>
109+
<title><function>array_fill</function> 示例</title>
110110
<programlisting role="php">
111111
<![CDATA[
112112
<?php
@@ -142,27 +142,27 @@ print_r($a);
142142
?>
143143
]]>
144144
</programlisting>
145-
&example.outputs.7;
145+
&example.outputs.8;
146146
<screen>
147147
<![CDATA[
148148
Array
149149
(
150150
[-2] => pear
151+
[-1] => pear
151152
[0] => pear
152153
[1] => pear
153-
[2] => pear
154154
)
155155
]]>
156156
</screen>
157-
&example.outputs.8;
157+
&example.outputs.7;
158158
<screen>
159159
<![CDATA[
160160
Array
161161
(
162162
[-2] => pear
163-
[-1] => pear
164163
[0] => pear
165164
[1] => pear
165+
[2] => pear
166166
)
167167
]]>
168168
</screen>

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

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 85c47f89f35f927d7c7ad23235c830dc4b514ddd Maintainer: mowangjuanzi Status: ready -->
3+
<refentry xml:id="function.array-first" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<refnamediv>
5+
<refname>array_first</refname>
6+
<refpurpose>获取数组的第一个值</refpurpose>
7+
</refnamediv>
8+
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis>
12+
<type>mixed</type><methodname>array_first</methodname>
13+
<methodparam><type>array</type><parameter>array</parameter></methodparam>
14+
</methodsynopsis>
15+
<para>
16+
获取指定 <parameter>array</parameter> 的第一个值。
17+
</para>
18+
</refsect1>
19+
20+
<refsect1 role="parameters">
21+
&reftitle.parameters;
22+
<variablelist>
23+
<varlistentry>
24+
<term><parameter>array</parameter></term>
25+
<listitem>
26+
<para>
27+
数组。
28+
</para>
29+
</listitem>
30+
</varlistentry>
31+
</variablelist>
32+
</refsect1>
33+
34+
<refsect1 role="returnvalues">
35+
&reftitle.returnvalues;
36+
<para>
37+
如果数组非空，则返回 <parameter>array</parameter> 的第一个值；否则返回 &null;。
38+
</para>
39+
</refsect1>
40+
41+
<refsect1 role="examples">
42+
&reftitle.examples;
43+
<para>
44+
<example xml:id="array_first.example.basic">
45+
<title>基础 <function>array_first</function> 用法</title>
46+
<programlisting role="php">
47+
<![CDATA[
48+
<?php
49+
$array = [1 => 'a', 0 => 'b', 3 => 'c', 2 => 'd'];
50+
51+
$firstValue = array_first($array);
52+
53+
var_dump($firstValue);
54+
?>
55+
]]>
56+
</programlisting>
57+
&example.outputs;
58+
<screen>
59+
<![CDATA[
60+
string(1) "a"
61+
]]>
62+
</screen>
63+
</example>
64+
</para>
65+
</refsect1>
66+
67+
<refsect1 role="seealso">
68+
&reftitle.seealso;
69+
<simplelist>
70+
<member><function>array_key_first</function></member>
71+
<member><function>array_last</function></member>
72+
</simplelist>
73+
</refsect1>
74+
75+
</refentry>
76+
<!-- Keep this comment at the end of the file
77+
Local variables:
78+
mode: sgml
79+
sgml-omittag:t
80+
sgml-shorttag:t
81+
sgml-minimize-attributes:nil
82+
sgml-always-quote-attributes:t
83+
sgml-indent-step:1
84+
sgml-indent-data:t
85+
indent-tabs-mode:nil
86+
sgml-parent-document:nil
87+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
88+
sgml-exposed-tags:nil
89+
sgml-local-catalogs:nil
90+
sgml-local-ecat-files:nil
91+
End:
92+
vim600: syn=xml fen fdm=syntax fdl=2 si
93+
vim: et tw=78 syn=sgml
94+
vi: ts=1 sw=1
95+
-->

‎reference/array/functions/array-is-list.xml‎

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 5ecd5e8e50f0f47dce7341ddc95334af62d9e770 Maintainer: haytoo Status: ready -->
2+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: haytoo Status: ready -->
3+
<!-- CREDITS: mowangjuanzi -->
34
<refentry xml:id="function.array-is-list" xmlns="http://docbook.org/ns/docbook">
45
<refnamediv>
56
<refname>array_is_list</refname>
6-
<refpurpose>判断给定的 <parameter>array</parameter> 是否为 list</refpurpose>
7+
<refpurpose>判断指定 <parameter>array</parameter> 是否为 list</refpurpose>
78
</refnamediv>
89

910
<refsect1 role="description">
@@ -48,22 +49,21 @@
4849
<programlisting role="php">
4950
<![CDATA[
5051
<?php
51-
52-
array_is_list([]); // true
53-
array_is_list(['apple', 2, 3]); // true
54-
array_is_list([0 => 'apple', 'orange']); // true
52+
var_dump(array_is_list([])); // true
53+
var_dump(array_is_list(['apple', 2, 3])); // true
54+
var_dump(array_is_list([0 => 'apple', 'orange'])); // true
5555
5656
// key 未从 0 开始
57-
array_is_list([1 => 'apple', 'orange']); // false
57+
var_dump(array_is_list([1 => 'apple', 'orange'])); // false
5858
5959
// key 的顺序不正确
60-
array_is_list([1 => 'apple', 0 => 'orange']); // false
60+
var_dump(array_is_list([1 => 'apple', 0 => 'orange'])); // false
6161
6262
// 包含非整数 key
63-
array_is_list([0 => 'apple', 'foo' => 'bar']); // false
63+
var_dump(array_is_list([0 => 'apple', 'foo' => 'bar'])); // false
6464
6565
// 非连续 key
66-
array_is_list([0 => 'apple', 2 => 'bar']); // false
66+
var_dump(array_is_list([0 => 'apple', 2 => 'bar'])); // false
6767
?>
6868
]]>
6969
</programlisting>

0 commit comments

Comments
 (0)