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.
+        // 放宽了参数类型,缩窄了返回的类型
     }
 }