com doc/zh: Improve translation: language/types/iterable.xml
[email protected] (Dai Jie) Sat, 16 Jan 2021 07:43:58 +0000
| Newsgroups | php.doc.zh |
|---|---|
| Message-ID | <[email protected]> |
Commit: ea0f51d3d99ac6bd42d6da9853a2980b1f95c605 Author: daijie <[email protected]> Sat, 16 Jan 2021 15:43:58 +0800 Parents: ade9739f4f4b73056ae82b5d2ad9bf88f0c4ad20 Branches: master Link: http://git.php.net/?p=doc/zh.git;a=commitdiff;h=ea0f51d3d99ac6bd42d6da9853a2980b1f95c605 Log: Improve translation Changed paths: M language/types/iterable.xml Diff: diff --git a/language/types/iterable.xml b/language/types/iterable.xml index ab7c59c5..c049852d 100644 --- a/language/types/iterable.xml +++ b/language/types/iterable.xml @@ -1,15 +1,15 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: e9366ee458b2900c53a503b1ad97664e1d9a8859 Maintainer: anonymous #138 Status: ready --> +<!-- EN-Revision: 86d8c6800b86a634ea51264962e951c88dc0a950 Maintainer: daijie Status: ready --> <!-- Reviewed: avenger Maintainer: avenger --> <sect1 xml:id="language.types.iterable"> - <title>可迭代对象</title> + <title>Iterable 可迭代对象</title> <para> - <type>Iterable</type>是 PHP 7.1 中引入的一个伪类型。它接受任何实现了 - <classname>Traversable</classname> 接口的 &array; 或对象。这些类型都能用 &foreach; 迭代,并且可以与 - <command>yield from</command> 在一个 - <link linkend="language.generators">generator</link> 中使用。 + <type>Iterable</type>是 PHP 7.1 中引入的一个伪类型。它接受任何 &array; 或实现了 + <classname>Traversable</classname> 接口的对象。这些类型都能用 &foreach; 迭代, + 也可以和 <link linkend="language.generators">生成器</link> 里的 + <command>yield from</command> 一起使用。 </para> <sect2 xml:id="language.types.iterable.using"> @@ -25,7 +25,7 @@ <para> <example> <title> - 可迭代参数类型示例 + Iterable 可迭代参数类型示例 </title> <programlisting role="php"> <![CDATA[ @@ -93,7 +93,7 @@ function bar(): iterable { <para> 将可迭代对象声明为返回类型的函数也可能是 <link - linkend="language.generators">generators</link>。 + linkend="language.generators">生成器</link>。 </para> <para> @@ -119,19 +119,18 @@ function gen(): iterable { </sect2> <sect2 xml:id="language.types.iterable.variance"> - <title>可迭代类型的类型差异</title> + <title>可迭代类型的协变</title> <para> - 扩展/实现的类可以把使用 &array; 或 - <classname>Traversable</classname> 作为参数类型扩展为 - <type>iterable</type> ,或者把“狭窄”的返回类型从 <type>iterable</type> - 扩展为 &array; 或者 <classname>Traversable</classname>。 + 类在扩展/实现(extending/implementing)的时候, + 可以将参数类型从 &array; 或 <classname>Traversable</classname> 放宽到 <type>iterable</type>, + 也可以将返回类型 <type>iterable</type> 的范围缩小到 &array; 或 <classname>Traversable</classname>。 </para> <para> <example> <title> - 可迭代类型差异示例 + 可迭代的类型协变示例 </title> <programlisting role="php"> <![CDATA[ @@ -143,7 +142,7 @@ interface Example { class ExampleImplementation implements Example { public function method(iterable $iterable): array { - // Parameter broadened and return type narrowed. + // 放宽了参数类型,缩窄了返回的类型 } }