Merge branch 'update-tutorial-controlflow' into 3.7

adrianliaw · adrianliaw · commit f3f82e0ce7ce · 2018-09-07T17:39:37.000+08:00
diff --git a/tutorial/controlflow.po b/tutorial/controlflow.po
@@ -10,16 +10,18 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.7\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2018-06-26 18:54+0800\n"
-"PO-Revision-Date: 2018-05-23 16:18+0000\n"
+"POT-Creation-Date: 2018-05-23 22:27+0800\n"
+"PO-Revision-Date: 2018-09-07 17:30+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
 "Language: zh_TW\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
+"Language: zh_TW\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
+"X-Generator: Poedit 2.1.1\n"
 
 #: ../../tutorial/controlflow.rst:5
 msgid "More Control Flow Tools"
@@ -74,8 +76,8 @@ msgid ""
 "intended):"
 msgstr ""
 "在 Python 中的 :keyword:`for` 陳述式可能不同於在 C 或 Pascal 中所看到的使用方"
-"式。與其只能选代 (iterate) 一個等差級數（如 Pascal），或給與使用者定義选代步"
-"進方式與結束條件（如 C），Python 的 :keyword:`for` 陳述选代任何序列（list 或"
+"式。與其只能疊代 (iterate) 一個等差級數（如 Pascal），或給與使用者定義疊代步"
+"進方式與結束條件（如 C），Python 的 :keyword:`for` 陳述疊代任何序列（list 或"
 "者字串）的元素，以他們出現在序列中的順序。例如（無意雙關）：\n"
 "\n"
 "::"
@@ -87,8 +89,8 @@ msgid ""
 "first make a copy.  Iterating over a sequence does not implicitly make a "
 "copy.  The slice notation makes this especially convenient::"
 msgstr ""
-"如果你在迴圈中需要修改一個你正在选代的序列（例如重複一些選擇的元素），那麼會"
-"建議你先建立一個序列的拷貝。选代序列並不暗示建立新的拷貝。此時 slice 語法就讓"
+"如果你在迴圈中需要修改一個你正在疊代的序列（例如重複一些選擇的元素），那麼會"
+"建議你先建立一個序列的拷貝。疊代序列並不暗示建立新的拷貝。此時 slice 語法就讓"
 "這件事十分容易完成：\n"
 "\n"
 "::"
@@ -98,6 +100,8 @@ msgid ""
 "With ``for w in words:``, the example would attempt to create an infinite "
 "list, inserting ``defenestrate`` over and over again."
 msgstr ""
+"在 ``for w in words:`` 的情況，這個例子會試著重覆不斷地插入 "
+"``defenestrate``，產生一個無限長的 list。"
 
 #: ../../tutorial/controlflow.rst:88
 msgid "The :func:`range` Function"
@@ -108,7 +112,7 @@ msgid ""
 "If you do need to iterate over a sequence of numbers, the built-in function :"
 "func:`range` comes in handy.  It generates arithmetic progressions::"
 msgstr ""
-"如果你需要选代一個數列的話，使用內建 :func:`range` 函式就很方便。它可以生成一"
+"如果你需要疊代一個數列的話，使用內建 :func:`range` 函式就很方便。它可以生成一"
 "等差級數：\n"
 "\n"
 "::"
@@ -122,7 +126,7 @@ msgid ""
 msgstr ""
 "給定的結束值永遠不會出現在生成的序列中；\\ ``range(10)`` 生成的 10 個數值，即"
 "對應存取一個長度為 10 的序列內每一個元素的索引值。也可以讓 range 從其他數值計"
-"數，或者給定不同的級距（甚至為負；有時稱之為 'step'）：\n"
+"數，或者給定不同的級距（甚至為負；有時稱之為 step）：\n"
 "\n"
 "::"
 
@@ -131,8 +135,7 @@ msgid ""
 "To iterate over the indices of a sequence, you can combine :func:`range` "
 "and :func:`len` as follows::"
 msgstr ""
-"欲选代一個序列的索引值們，你可以搭配使用 :func:`range` 和 :func:`len` 如"
-"下：\n"
+"欲疊代一個序列的索引值，你可以搭配使用 :func:`range` 和 :func:`len` 如下：\n"
 "\n"
 "::"
 
@@ -159,7 +162,7 @@ msgid ""
 "really make the list, thus saving space."
 msgstr ""
 "在很多情況下，由 :func:`range` 回傳的物件的行為如同一個 list，但實際上它並不"
-"是。它是一個物件在你选代時會回傳想要的序列的連續元素，並不會真正建出這個序列"
+"是。它是一個物件在你疊代時會回傳想要的序列的連續元素，並不會真正建出這個序列"
 "的 list，以節省空間。"
 
 #: ../../tutorial/controlflow.rst:142
@@ -170,10 +173,10 @@ msgid ""
 "keyword:`for` statement is such an *iterator*. The function :func:`list` is "
 "another; it creates lists from iterables::"
 msgstr ""
-"我們稱這樣的物件為 *iterable*\\ （可选代的），意即能作為函式、陳述式中能一直"
+"我們稱這樣的物件為 *iterable*\\ （可疊代的），意即能作為函式、陳述式中能一直"
 "獲取連續元素直到用盡的部件。我們已經看過 :keyword:`for` 陳述式可做為如此的 "
-"*iterator*\\ （选代器）。:func:`list` 函式為另一個例子，他可以自 iterable（可"
-"选代物件）建立 list：\n"
+"*iterator*\\ （疊代器）。:func:`list` 函式為另一個例子，他可以自 iterable（可"
+"疊代物件）建立 list：\n"
 "\n"
 "::"
 
@@ -195,6 +198,8 @@ msgid ""
 "The :keyword:`break` statement, like in C, breaks out of the innermost "
 "enclosing :keyword:`for` or :keyword:`while` loop."
 msgstr ""
+":keyword:`break` 陳述，如同 C 語言，終止包含其最內部的 :keyword:`for` 或 :"
+"keyword:`while` 迴圈。"
 
 #: ../../tutorial/controlflow.rst:163
 msgid ""
@@ -204,7 +209,7 @@ msgid ""
 "terminated by a :keyword:`break` statement.  This is exemplified by the "
 "following loop, which searches for prime numbers::"
 msgstr ""
-"迴圈可以帶有一個 ``else`` 段落。當迴圈歷遍选代的 list （在 :keyword:`for` "
+"迴圈可以帶有一個 ``else`` 段落。當迴圈歷遍疊代的 list （在 :keyword:`for` "
 "中）或條件為偽（在 :keyword:`while` 中）時，這個段落會被執行；但迴圈被 :"
 "keyword:`break` 陳述終止時則不會。底下尋找質數的迴圈即示範了這個行為：\n"
 "\n"
@@ -237,7 +242,7 @@ msgid ""
 "The :keyword:`continue` statement, also borrowed from C, continues with the "
 "next iteration of the loop::"
 msgstr ""
-":keyword:`continue` 陳述，亦承襲於 C 語言，讓迴圈於下個选代起繼續執行：\n"
+":keyword:`continue` 陳述，亦承襲於 C 語言，讓所屬的迴圈繼續執行下個疊代：\n"
 "\n"
 "::"
 
@@ -270,7 +275,7 @@ msgid ""
 "ignored::"
 msgstr ""
 ":keyword:`pass` 亦可作為一個函式或條件判斷主體的預留位置，它可幫助你以更宏觀"
-"的角度思考並撰寫新的程式碼。\\ :keyword:`pass` 可自動忽略：\n"
+"的角度思考並撰寫新的程式碼。\\ :keyword:`pass` 可被忽略：\n"
 "\n"
 "::"
 
@@ -283,6 +288,9 @@ msgid ""
 "We can create a function that writes the Fibonacci series to an arbitrary "
 "boundary::"
 msgstr ""
+"我們可以建立一個函式來產生費式數列到任何一個上界：\n"
+"\n"
+"::"
 
 #: ../../tutorial/controlflow.rst:265
 msgid ""
@@ -291,6 +299,8 @@ msgid ""
 "parameters. The statements that form the body of the function start at the "
 "next line, and must be indented."
 msgstr ""
+"關鍵字 :keyword:`def` 帶入一個函式的\\ *定義*。它之後必須連著該函式的名稱和置"
+"於括號之中的參數。自下一行起，所有縮排的陳述成為該函式的主體。"
 
 #: ../../tutorial/controlflow.rst:270
 msgid ""
@@ -302,6 +312,11 @@ msgid ""
 "through code; it's good practice to include docstrings in code that you "
 "write, so make a habit of it."
 msgstr ""
+"一個函式的第一個陳述可以是一個字串值；此情況該字串值被視為該函式的說明文件字"
+"串，即 :dfn:`docstring`\\ 。（關於 docstring 的細節請參見\\ :ref:`tut-"
+"docstrings`\\ 段落。）有些工具可以使用 docstring 來自動產生線上或可列印的文"
+"件，或讓使用者能自由地自原始碼中瀏覽文件。在原始碼中加入 docstring 是個好慣"
+"例，應該養成這樣的習慣。"
 
 #: ../../tutorial/controlflow.rst:277
 msgid ""
@@ -314,6 +329,11 @@ msgid ""
 "assigned a value within a function (unless named in a :keyword:`global` "
 "statement), although they may be referenced."
 msgstr ""
+"函式執行期間會建立一個新的符號表（symbol table）來儲存該函式內的區域變數。更"
+"精確地說，所有在函式內的變數賦值都會把該值儲存在一個區域符號表。然而，在讀取"
+"一個變數時，會先從區域符號表起搜尋，其次為所有包含其函式的區域符號表，其次為"
+"全域符號表，最後為所有內建的名稱。因此，在函式中，全域變數無法被直接賦值（除"
+"非該變數有被 :keyword:`global` 陳述句提及），但它們可以被讀取。"
 
 #: ../../tutorial/controlflow.rst:286
 msgid ""
@@ -323,6 +343,10 @@ msgid ""
 "*reference*, not the value of the object). [#]_ When a function calls "
 "another function, a new local symbol table is created for that call."
 msgstr ""
+"在一個函式被呼叫的時候，實際傳入的參數（引數）會被加入至該函數的區域符號表。"
+"因此，引數傳入的方式為\\ *傳值呼叫 (call by value)*\\ （這裡傳遞的「值」永遠"
+"是一個物件的\\ *參照（reference）*\\ ，而不是該物件的值）。\\ [#]_ 當一個函式"
+"呼叫別的函式時，在被呼叫的函式中會建立一個新的區域符號表。"
 
 #: ../../tutorial/controlflow.rst:292
 msgid ""
@@ -332,6 +356,11 @@ msgid ""
 "another name which can then also be used as a function.  This serves as a "
 "general renaming mechanism::"
 msgstr ""
+"一個函式定義會把該函式名稱加入至當前的符號表。該函式名稱的值帶有一個型別，並"
+"被直譯器辨識為使用者自定函式（user-defined function）。該值可以被賦予給別的變"
+"數名，而該變數也可以被當作函式使用。這即是常見的重新命名方式：\n"
+"\n"
+"::"
 
 #: ../../tutorial/controlflow.rst:304
 msgid ""
@@ -343,23 +372,35 @@ msgid ""
 "the only value written. You can see it if you really want to using :func:"
 "`print`::"
 msgstr ""
+"如果你是來自別的語言，你可能不同意 ``fib`` 是個函式，而是個程序 (procedure)，"
+"因為它並沒有回傳值。實際上，即使一個函式缺少一個 :keyword:`return` 陳述，它亦"
+"有一個固定的回傳值。這個值為 ``None``\\ （它是一個內建名稱）。在直譯器中單獨"
+"使用 ``None`` 時，通常不會被顯示。你可以使用 :func:`print` 來看到它：\n"
+"\n"
+"::"
 
 #: ../../tutorial/controlflow.rst:315
 msgid ""
 "It is simple to write a function that returns a list of the numbers of the "
 "Fibonacci series, instead of printing it::"
 msgstr ""
+"如果要寫一個函式回傳費式數列的 list 而不是直接印出它，這也很容易：\n"
+"\n"
+"::"
 
 #: ../../tutorial/controlflow.rst:331
 msgid "This example, as usual, demonstrates some new Python features:"
-msgstr ""
+msgstr "這個例子一樣示範了一些新的 Python 特性："
 
 #: ../../tutorial/controlflow.rst:333
 msgid ""
 "The :keyword:`return` statement returns with a value from a function. :"
 "keyword:`return` without an expression argument returns ``None``. Falling "
 "off the end of a function also returns ``None``."
 msgstr ""
+":keyword:`return` 陳述會讓一個函式回傳一個值。單獨使用 :keyword:`return` 不外"
+"加一個表達式作為引數會回傳 ``None``\\ 。一個函式執行到結束也會回傳 ``None``"
+"\\ 。"
 
 #: ../../tutorial/controlflow.rst:337
 msgid ""
@@ -374,6 +415,14 @@ msgid ""
 "for list objects; it adds a new element at the end of the list.  In this "
 "example it is equivalent to ``result = result + [a]``, but more efficient."
 msgstr ""
+"``result.append(a)`` 陳述呼叫了一個 list 物件的 ``result`` *method（方法）*。"
+"method 為「屬於」一個物件的函式，命名規則為 ``obj.methodname``\\ ，其中 "
+"``obj`` 為某個物件（亦可為一表達式），而 ``methodname`` 為該 method 的名稱，"
+"並由該物件的型別所定義。不同的型別代表不同的 method。不同型別的 method 可以擁"
+"有一樣的名稱而不會讓 Python 混淆。（你可以使用 *class* 定義自己的物件型別和 "
+"method，見 :ref:`tut-classes`\\ ）這裡 :meth:`append` method 定義在 list 物件"
+"中；它會加入一個新的元素在該 list 的末端。這個例子等同於 ``result = result + "
+"[a]``\\ ，但更有效率。"
 
 #: ../../tutorial/controlflow.rst:352
 msgid "More on Defining Functions"
