sync with cpython a7acc5cb

Author: github-actions[bot]

tutorial/controlflow.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.11\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-07-12 00:20+0000\n"
+"POT-Creation-Date: 2023-07-18 00:46+0000\n"
 "PO-Revision-Date: 2022-07-24 14:52+0800\n"
 "Last-Translator: Steven Hsu <hsuhaochun@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -395,16 +395,17 @@ msgstr ""
 "``Point``）則永遠無法被賦值。"
 
 #: ../../tutorial/controlflow.rst:345
+#, fuzzy
 msgid ""
 "Patterns can be arbitrarily nested.  For example, if we have a short list of "
-"points, we could match it like this::"
+"Points, with ``__match_args__`` added, we could match it like this::"
 msgstr ""
 "模式可以任意地被巢套 (nested)。例如，如果我們有一個由某些點所組成的簡短 "
 "list，我們就可以像這樣來對它進行匹配：\n"
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:360
+#: ../../tutorial/controlflow.rst:366
 msgid ""
 "We can add an ``if`` clause to a pattern, known as a \"guard\".  If the "
 "guard is false, ``match`` goes on to try the next case block.  Note that "
@@ -416,11 +417,11 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:370
+#: ../../tutorial/controlflow.rst:376
 msgid "Several other key features of this statement:"
 msgstr "此種陳述式的其他幾個重要特色："
 
-#: ../../tutorial/controlflow.rst:372
+#: ../../tutorial/controlflow.rst:378
 msgid ""
 "Like unpacking assignments, tuple and list patterns have exactly the same "
 "meaning and actually match arbitrary sequences.  An important exception is "
@@ -429,7 +430,7 @@ msgstr ""
 "與拆解賦值的情況類似，tuple（元組）和 list 模式具有完全相同的意義，而且實際上"
 "可以匹配任意的序列。一個重要的例外，是它們不能匹配疊代器 (iterator) 或字串。"
 
-#: ../../tutorial/controlflow.rst:376
+#: ../../tutorial/controlflow.rst:382
 msgid ""
 "Sequence patterns support extended unpacking: ``[x, y, *rest]`` and ``(x, y, "
 "*rest)`` work similar to unpacking assignments.  The name after ``*`` may "
@@ -441,7 +442,7 @@ msgstr ""
 "是 ``_``，所以 ``(x, y, *_)`` 會匹配一個至少兩項的序列，且不會連結那兩項以外"
 "的其餘項。"
 
-#: ../../tutorial/controlflow.rst:381
+#: ../../tutorial/controlflow.rst:387
 msgid ""
 "Mapping patterns: ``{\"bandwidth\": b, \"latency\": l}`` captures the "
 "``\"bandwidth\"`` and ``\"latency\"`` values from a dictionary.  Unlike "
@@ -453,30 +454,30 @@ msgstr ""
 "模式不同，額外的鍵 (key) 會被忽略。一種像是 ``**rest`` 的拆解方式，也是可被支"
 "援的。（但 ``**_`` 則是多餘的做法，所以它並不被允許。）"
 
-#: ../../tutorial/controlflow.rst:386
+#: ../../tutorial/controlflow.rst:392
 msgid "Subpatterns may be captured using the ``as`` keyword::"
 msgstr ""
 "使用關鍵字 ``as`` 可以擷取子模式 (subpattern)：\n"
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:390
+#: ../../tutorial/controlflow.rst:396
 msgid ""
 "will capture the second element of the input as ``p2`` (as long as the input "
 "is a sequence of two points)"
 msgstr ""
 "將會擷取輸入的第二個元素作為 ``p2``\\ （只要該輸入是一個由兩個點所組成的序"
 "列）。"
 
-#: ../../tutorial/controlflow.rst:393
+#: ../../tutorial/controlflow.rst:399
 msgid ""
 "Most literals are compared by equality, however the singletons ``True``, "
 "``False`` and ``None`` are compared by identity."
 msgstr ""
 "大部分的字面值是藉由相等性 (equality) 來比較，但是單例物件 (singleton) "
 "``True``\\ 、\\ ``False`` 和 ``None`` 是藉由標識值 (identity) 來比較。"
 
-#: ../../tutorial/controlflow.rst:396
+#: ../../tutorial/controlflow.rst:402
 msgid ""
 "Patterns may use named constants.  These must be dotted names to prevent "
 "them from being interpreted as capture variable::"
@@ -486,18 +487,18 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:415
+#: ../../tutorial/controlflow.rst:421
 msgid ""
 "For a more detailed explanation and additional examples, you can look into :"
 "pep:`636` which is written in a tutorial format."
 msgstr ""
 "關於更詳細的解釋和其他範例，你可以閱讀 :pep:`636`，它是以教學的格式編寫而成。"
 
-#: ../../tutorial/controlflow.rst:421
+#: ../../tutorial/controlflow.rst:427
 msgid "Defining Functions"
 msgstr "定義函式 (function)"
 
-#: ../../tutorial/controlflow.rst:423
+#: ../../tutorial/controlflow.rst:429
 msgid ""
 "We can create a function that writes the Fibonacci series to an arbitrary "
 "boundary::"
@@ -506,7 +507,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:443
+#: ../../tutorial/controlflow.rst:449
 msgid ""
 "The keyword :keyword:`def` introduces a function *definition*.  It must be "
 "followed by the function name and the parenthesized list of formal "
@@ -516,7 +517,7 @@ msgstr ""
 "關鍵字 :keyword:`def` 介紹一個函式的\\ *定義*\\ 。它之後必須連著該函式的名稱"
 "和置於括號之中的一串參數。自下一行起，所有縮排的陳述式成為該函式的主體。"
 
-#: ../../tutorial/controlflow.rst:448
+#: ../../tutorial/controlflow.rst:454
 msgid ""
 "The first statement of the function body can optionally be a string literal; "
 "this string literal is the function's documentation string, or :dfn:"
@@ -532,7 +533,7 @@ msgstr ""
 "件，或讓使用者能以互動的方式在原始碼中瀏覽文件。在原始碼中加入 docstring 是個"
 "好慣例，應該養成這樣的習慣。"
 
-#: ../../tutorial/controlflow.rst:455
+#: ../../tutorial/controlflow.rst:461
 msgid ""
 "The *execution* of a function introduces a new symbol table used for the "
 "local variables of the function.  More precisely, all variable assignments "
@@ -553,7 +554,7 @@ msgstr ""
 "域變數是在 :keyword:`global` 陳述式中被定義，或外層函式變數在 :keyword:"
 "`nonlocal` 陳述式中被定義）。"
 
-#: ../../tutorial/controlflow.rst:466
+#: ../../tutorial/controlflow.rst:472
 msgid ""
 "The actual parameters (arguments) to a function call are introduced in the "
 "local symbol table of the called function when it is called; thus, arguments "
@@ -568,7 +569,7 @@ msgstr ""
 "函式呼叫別的函式或遞迴呼叫它自己時，在被呼叫的函式中會建立一個新的區域符號"
 "表。"
 
-#: ../../tutorial/controlflow.rst:473
+#: ../../tutorial/controlflow.rst:479
 msgid ""
 "A function definition associates the function name with the function object "
 "in the current symbol table.  The interpreter recognizes the object pointed "
@@ -581,7 +582,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:484
+#: ../../tutorial/controlflow.rst:490
 msgid ""
 "Coming from other languages, you might object that ``fib`` is not a function "
 "but a procedure since it doesn't return a value.  In fact, even functions "
@@ -598,7 +599,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:495
+#: ../../tutorial/controlflow.rst:501
 msgid ""
 "It is simple to write a function that returns a list of the numbers of the "
 "Fibonacci series, instead of printing it::"
@@ -607,11 +608,11 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:511
+#: ../../tutorial/controlflow.rst:517
 msgid "This example, as usual, demonstrates some new Python features:"
 msgstr "這個例子一樣示範了一些新的 Python 特性："
 
-#: ../../tutorial/controlflow.rst:513
+#: ../../tutorial/controlflow.rst:519
 msgid ""
 "The :keyword:`return` statement returns with a value from a function. :"
 "keyword:`!return` without an expression argument returns ``None``. Falling "
@@ -621,7 +622,7 @@ msgstr ""
 "不外加一個運算式作為引數時會回傳 ``None``\\ 。一個函式執行到結束也會回傳 "
 "``None``\\ 。"
 
-#: ../../tutorial/controlflow.rst:517
+#: ../../tutorial/controlflow.rst:523
 msgid ""
 "The statement ``result.append(a)`` calls a *method* of the list object "
 "``result``.  A method is a function that 'belongs' to an object and is named "
@@ -643,22 +644,22 @@ msgstr ""
 "method 定義在 list 物件中；它會在該 list 的末端加入一個新的元素。這個例子等同"
 "於 ``result = result + [a]``\\ ，但更有效率。"
 
-#: ../../tutorial/controlflow.rst:532
+#: ../../tutorial/controlflow.rst:538
 msgid "More on Defining Functions"
 msgstr "深入了解函式定義"
 
-#: ../../tutorial/controlflow.rst:534
+#: ../../tutorial/controlflow.rst:540
 msgid ""
 "It is also possible to define functions with a variable number of arguments. "
 "There are three forms, which can be combined."
 msgstr ""
 "定義函式時使用的引數 (argument) 數量是可變的。總共有三種可以組合使用的形式。"
 
-#: ../../tutorial/controlflow.rst:541
+#: ../../tutorial/controlflow.rst:547
 msgid "Default Argument Values"
 msgstr "預設引數值"
 
-#: ../../tutorial/controlflow.rst:543
+#: ../../tutorial/controlflow.rst:549
 msgid ""
 "The most useful form is to specify a default value for one or more "
 "arguments. This creates a function that can be called with fewer arguments "
@@ -669,37 +670,37 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:559
+#: ../../tutorial/controlflow.rst:565
 msgid "This function can be called in several ways:"
 msgstr "該函式可以用以下幾種方式被呼叫："
 
-#: ../../tutorial/controlflow.rst:561
+#: ../../tutorial/controlflow.rst:567
 msgid ""
 "giving only the mandatory argument: ``ask_ok('Do you really want to quit?')``"
 msgstr "只給必要引數：\\ ``ask_ok('Do you really want to quit?')``"
 
-#: ../../tutorial/controlflow.rst:563
+#: ../../tutorial/controlflow.rst:569
 msgid ""
 "giving one of the optional arguments: ``ask_ok('OK to overwrite the file?', "
 "2)``"
 msgstr "給予一個選擇性引數：\\ ``ask_ok('OK to overwrite the file?', 2)``"
 
-#: ../../tutorial/controlflow.rst:565
+#: ../../tutorial/controlflow.rst:571
 msgid ""
 "or even giving all arguments: ``ask_ok('OK to overwrite the file?', 2, 'Come "
 "on, only yes or no!')``"
 msgstr ""
 "給予所有引數：\\ ``ask_ok('OK to overwrite the file?', 2, 'Come on, only yes "
 "or no!')``"
 
-#: ../../tutorial/controlflow.rst:568
+#: ../../tutorial/controlflow.rst:574
 msgid ""
 "This example also introduces the :keyword:`in` keyword. This tests whether "
 "or not a sequence contains a certain value."
 msgstr ""
 "此例也使用了關鍵字 :keyword:`in`\\ ，用於測試序列中是否包含某個特定值。"
 
-#: ../../tutorial/controlflow.rst:571
+#: ../../tutorial/controlflow.rst:577
 msgid ""
 "The default values are evaluated at the point of function definition in the "
 "*defining* scope, so that ::"
@@ -708,11 +709,11 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:582
+#: ../../tutorial/controlflow.rst:588
 msgid "will print ``5``."
 msgstr "將會輸出 ``5``\\ 。"
 
-#: ../../tutorial/controlflow.rst:584
+#: ../../tutorial/controlflow.rst:590
 msgid ""
 "**Important warning:**  The default value is evaluated only once. This makes "
 "a difference when the default is a mutable object such as a list, "
@@ -725,24 +726,24 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:597
+#: ../../tutorial/controlflow.rst:603
 msgid "This will print ::"
 msgstr ""
 "將會輸出：\n"
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:603
+#: ../../tutorial/controlflow.rst:609
 msgid ""
 "If you don't want the default to be shared between subsequent calls, you can "
 "write the function like this instead::"
 msgstr "如果不想在後續呼叫之間共用預設值，應以如下方式編寫函式："
 
-#: ../../tutorial/controlflow.rst:616
+#: ../../tutorial/controlflow.rst:622
 msgid "Keyword Arguments"
 msgstr "關鍵字引數"
 
-#: ../../tutorial/controlflow.rst:618
+#: ../../tutorial/controlflow.rst:624
 msgid ""
 "Functions can also be called using :term:`keyword arguments <keyword "
 "argument>` of the form ``kwarg=value``.  For instance, the following "
@@ -753,7 +754,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:627
+#: ../../tutorial/controlflow.rst:633
 msgid ""
 "accepts one required argument (``voltage``) and three optional arguments "
 "(``state``, ``action``, and ``type``).  This function can be called in any "
@@ -764,14 +765,14 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:638
+#: ../../tutorial/controlflow.rst:644
 msgid "but all the following calls would be invalid::"
 msgstr ""
 "但以下呼叫方式都無效：\n"
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:645
+#: ../../tutorial/controlflow.rst:651
 msgid ""
 "In a function call, keyword arguments must follow positional arguments. All "
 "the keyword arguments passed must match one of the arguments accepted by the "
@@ -789,7 +790,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:661
+#: ../../tutorial/controlflow.rst:667
 msgid ""
 "When a final formal parameter of the form ``**name`` is present, it receives "
 "a dictionary (see :ref:`typesmapping`) containing all keyword arguments "
@@ -807,31 +808,31 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:678
+#: ../../tutorial/controlflow.rst:684
 msgid "It could be called like this::"
 msgstr ""
 "它可以被如此呼叫：\n"
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:686
+#: ../../tutorial/controlflow.rst:692
 msgid "and of course it would print:"
 msgstr ""
 "輸出結果如下：\n"
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:699
+#: ../../tutorial/controlflow.rst:705
 msgid ""
 "Note that the order in which the keyword arguments are printed is guaranteed "
 "to match the order in which they were provided in the function call."
 msgstr "注意，關鍵字引數的輸出順序與呼叫函式時被提供的順序必定一致。"
 
-#: ../../tutorial/controlflow.rst:703
+#: ../../tutorial/controlflow.rst:709
 msgid "Special parameters"
 msgstr "特殊參數"
 
-#: ../../tutorial/controlflow.rst:705
+#: ../../tutorial/controlflow.rst:711
 msgid ""
 "By default, arguments may be passed to a Python function either by position "
 "or explicitly by keyword. For readability and performance, it makes sense to "
@@ -843,11 +844,11 @@ msgstr ""
 "及效能，限制引數的傳遞方式是合理的，如此，開發者只需查看函式定義，即可確定各"
 "項目是按位置，按位置或關鍵字，還是按關鍵字傳遞。"
 
-#: ../../tutorial/controlflow.rst:711
+#: ../../tutorial/controlflow.rst:717
 msgid "A function definition may look like:"
 msgstr "函式定義可能如以下樣式："
 
-#: ../../tutorial/controlflow.rst:722
+#: ../../tutorial/controlflow.rst:728
 msgid ""
 "where ``/`` and ``*`` are optional. If used, these symbols indicate the kind "
 "of parameter by how the arguments may be passed to the function: positional-"
@@ -858,22 +859,22 @@ msgstr ""
 "類：僅限位置、位置或關鍵字、僅限關鍵字。關鍵字參數也稱為附名參數 (named "
 "parameters)。"
 
-#: ../../tutorial/controlflow.rst:729
+#: ../../tutorial/controlflow.rst:735
 msgid "Positional-or-Keyword Arguments"
 msgstr "位置或關鍵字引數 (Positional-or-Keyword Arguments)"
 
-#: ../../tutorial/controlflow.rst:731
+#: ../../tutorial/controlflow.rst:737
 msgid ""
 "If ``/`` and ``*`` are not present in the function definition, arguments may "
 "be passed to a function by position or by keyword."
 msgstr ""
 "若函式定義中未使用 ``/`` 和 ``*`` 時，引數可以按位置或關鍵字傳遞給函式。"
 
-#: ../../tutorial/controlflow.rst:736
+#: ../../tutorial/controlflow.rst:742
 msgid "Positional-Only Parameters"
 msgstr "僅限位置參數 (Positional-Only Parameters)"
 
-#: ../../tutorial/controlflow.rst:738
+#: ../../tutorial/controlflow.rst:744
 msgid ""
 "Looking at this in a bit more detail, it is possible to mark certain "
 "parameters as *positional-only*. If *positional-only*, the parameters' order "
@@ -888,17 +889,17 @@ msgstr ""
 "``/``\\ （斜線）之前。\\ ``/`` 用於在邏輯上分開僅限位置參數與其餘參數。如果函"
 "式定義中沒有 ``/``\\ ，則表示沒有任何僅限位置參數。"
 
-#: ../../tutorial/controlflow.rst:746
+#: ../../tutorial/controlflow.rst:752
 msgid ""
 "Parameters following the ``/`` may be *positional-or-keyword* or *keyword-"
 "only*."
 msgstr "``/`` 後面的參數可以是\\ *位置或關鍵字*\\ 或\\ *僅限關鍵字*\\ 參數。"
 
-#: ../../tutorial/controlflow.rst:750
+#: ../../tutorial/controlflow.rst:756
 msgid "Keyword-Only Arguments"
 msgstr "僅限關鍵字引數 (Keyword-Only Arguments)"
 
-#: ../../tutorial/controlflow.rst:752
+#: ../../tutorial/controlflow.rst:758
 msgid ""
 "To mark parameters as *keyword-only*, indicating the parameters must be "
 "passed by keyword argument, place an ``*`` in the arguments list just before "
@@ -907,11 +908,11 @@ msgstr ""
 "要把參數標記為\\ *僅限關鍵字*\\ ，表明參數必須以關鍵字引數傳遞，必須在引數列"
 "表中第一個\\ *僅限關鍵字*\\ 參數前放上 ``*``\\ 。"
 
-#: ../../tutorial/controlflow.rst:758
+#: ../../tutorial/controlflow.rst:764
 msgid "Function Examples"
 msgstr "函式範例"
 
-#: ../../tutorial/controlflow.rst:760
+#: ../../tutorial/controlflow.rst:766
 msgid ""
 "Consider the following example function definitions paying close attention "
 "to the markers ``/`` and ``*``::"
@@ -920,7 +921,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:776
+#: ../../tutorial/controlflow.rst:782
 msgid ""
 "The first function definition, ``standard_arg``, the most familiar form, "
 "places no restrictions on the calling convention and arguments may be passed "
@@ -931,7 +932,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:786
+#: ../../tutorial/controlflow.rst:792
 msgid ""
 "The second function ``pos_only_arg`` is restricted to only use positional "
 "parameters as there is a ``/`` in the function definition::"
@@ -940,7 +941,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:797
+#: ../../tutorial/controlflow.rst:803
 msgid ""
 "The third function ``kwd_only_args`` only allows keyword arguments as "
 "indicated by a ``*`` in the function definition::"
@@ -949,7 +950,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:808
+#: ../../tutorial/controlflow.rst:814
 msgid ""
 "And the last uses all three calling conventions in the same function "
 "definition::"
@@ -958,7 +959,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:828
+#: ../../tutorial/controlflow.rst:834
 msgid ""
 "Finally, consider this function definition which has a potential collision "
 "between the positional argument ``name``  and ``**kwds`` which has ``name`` "
@@ -969,7 +970,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:833
+#: ../../tutorial/controlflow.rst:839
 msgid ""
 "There is no possible call that will make it return ``True`` as the keyword "
 "``'name'`` will always bind to the first parameter. For example::"
@@ -979,7 +980,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:842
+#: ../../tutorial/controlflow.rst:848
 msgid ""
 "But using ``/`` (positional only arguments), it is possible since it allows "
 "``name`` as a positional argument and ``'name'`` as a key in the keyword "
@@ -990,17 +991,17 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:850
+#: ../../tutorial/controlflow.rst:856
 msgid ""
 "In other words, the names of positional-only parameters can be used in "
 "``**kwds`` without ambiguity."
 msgstr "換句話說，僅限位置參數的名稱可以在 ``**kwds`` 中使用，而不產生歧義。"
 
-#: ../../tutorial/controlflow.rst:855
+#: ../../tutorial/controlflow.rst:861
 msgid "Recap"
 msgstr "回顧"
 
-#: ../../tutorial/controlflow.rst:857
+#: ../../tutorial/controlflow.rst:863
 msgid ""
 "The use case will determine which parameters to use in the function "
 "definition::"
@@ -1009,11 +1010,11 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:861
+#: ../../tutorial/controlflow.rst:867
 msgid "As guidance:"
 msgstr "說明："
 
-#: ../../tutorial/controlflow.rst:863
+#: ../../tutorial/controlflow.rst:869
 msgid ""
 "Use positional-only if you want the name of the parameters to not be "
 "available to the user. This is useful when parameter names have no real "
@@ -1025,7 +1026,7 @@ msgstr ""
 "想控制引數在函式呼叫的排列順序，或同時使用位置參數和任意關鍵字時，這種方式很"
 "有用。"
 
-#: ../../tutorial/controlflow.rst:868
+#: ../../tutorial/controlflow.rst:874
 msgid ""
 "Use keyword-only when names have meaning and the function definition is more "
 "understandable by being explicit with names or you want to prevent users "
@@ -1034,19 +1035,19 @@ msgstr ""
 "當參數名稱有意義，且明確的名稱可讓函式定義更易理解，或是你不希望使用者依賴引"
 "數被傳遞時的位置時，請使用僅限關鍵字。"
 
-#: ../../tutorial/controlflow.rst:871
+#: ../../tutorial/controlflow.rst:877
 msgid ""
 "For an API, use positional-only to prevent breaking API changes if the "
 "parameter's name is modified in the future."
 msgstr ""
 "對於應用程式介面 (API)，使用僅限位置，以防止未來參數名稱被修改時造成 API 的中"
 "斷性變更。"
 
-#: ../../tutorial/controlflow.rst:877
+#: ../../tutorial/controlflow.rst:883
 msgid "Arbitrary Argument Lists"
 msgstr "任意引數列表 (Arbitrary Argument Lists)"
 
-#: ../../tutorial/controlflow.rst:882
+#: ../../tutorial/controlflow.rst:888
 msgid ""
 "Finally, the least frequently used option is to specify that a function can "
 "be called with an arbitrary number of arguments.  These arguments will be "
@@ -1059,7 +1060,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:891
+#: ../../tutorial/controlflow.rst:897
 msgid ""
 "Normally, these *variadic* arguments will be last in the list of formal "
 "parameters, because they scoop up all remaining input arguments that are "
@@ -1073,11 +1074,11 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:908
+#: ../../tutorial/controlflow.rst:914
 msgid "Unpacking Argument Lists"
 msgstr "拆解引數列表（Unpacking Argument Lists）"
 
-#: ../../tutorial/controlflow.rst:910
+#: ../../tutorial/controlflow.rst:916
 msgid ""
 "The reverse situation occurs when the arguments are already in a list or "
 "tuple but need to be unpacked for a function call requiring separate "
@@ -1093,7 +1094,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:926
+#: ../../tutorial/controlflow.rst:932
 msgid ""
 "In the same fashion, dictionaries can deliver keyword arguments with the "
 "``**``\\ -operator::"
@@ -1102,11 +1103,11 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:942
+#: ../../tutorial/controlflow.rst:948
 msgid "Lambda Expressions"
 msgstr "Lambda 運算式"
 
-#: ../../tutorial/controlflow.rst:944
+#: ../../tutorial/controlflow.rst:950
 msgid ""
 "Small anonymous functions can be created with the :keyword:`lambda` keyword. "
 "This function returns the sum of its two arguments: ``lambda a, b: a+b``. "
@@ -1123,7 +1124,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:961
+#: ../../tutorial/controlflow.rst:967
 msgid ""
 "The above example uses a lambda expression to return a function.  Another "
 "use is to pass a small function as an argument::"
@@ -1133,17 +1134,17 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:973
+#: ../../tutorial/controlflow.rst:979
 msgid "Documentation Strings"
 msgstr "說明文件字串 (Documentation Strings)"
 
-#: ../../tutorial/controlflow.rst:980
+#: ../../tutorial/controlflow.rst:986
 msgid ""
 "Here are some conventions about the content and formatting of documentation "
 "strings."
 msgstr "以下是關於說明文件字串內容和格式的慣例。"
 
-#: ../../tutorial/controlflow.rst:983
+#: ../../tutorial/controlflow.rst:989
 msgid ""
 "The first line should always be a short, concise summary of the object's "
 "purpose.  For brevity, it should not explicitly state the object's name or "
@@ -1155,7 +1156,7 @@ msgstr ""
 "的名稱或型別，因為有其他方法可以達到相同目的（除非該名稱剛好是一個描述函式運"
 "算的動詞）。這一行應以大寫字母開頭，以句號結尾。"
 
-#: ../../tutorial/controlflow.rst:989
+#: ../../tutorial/controlflow.rst:995
 msgid ""
 "If there are more lines in the documentation string, the second line should "
 "be blank, visually separating the summary from the rest of the description.  "
@@ -1165,7 +1166,7 @@ msgstr ""
 "文件字串為多行時，第二行應為空白行，在視覺上將摘要與其餘描述分開。後面幾行可"
 "包含一或多個段落，描述此物件的呼叫慣例、副作用等。"
 
-#: ../../tutorial/controlflow.rst:994
+#: ../../tutorial/controlflow.rst:1000
 msgid ""
 "The Python parser does not strip indentation from multi-line string literals "
 "in Python, so tools that process documentation have to strip indentation if "
@@ -1187,18 +1188,18 @@ msgstr ""
 "出現了，這些行的全部前導空白字元都應被去除。展開 tab 鍵後（通常為八個空格），"
 "應測試空白字元量是否等價。"
 
-#: ../../tutorial/controlflow.rst:1006
+#: ../../tutorial/controlflow.rst:1012
 msgid "Here is an example of a multi-line docstring::"
 msgstr ""
 "下面是多行說明字串的一個範例：\n"
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:1024
+#: ../../tutorial/controlflow.rst:1030
 msgid "Function Annotations"
 msgstr "函式註釋 (Function Annotations)"
 
-#: ../../tutorial/controlflow.rst:1032
+#: ../../tutorial/controlflow.rst:1038
 msgid ""
 ":ref:`Function annotations <function>` are completely optional metadata "
 "information about the types used by user-defined functions (see :pep:`3107` "
@@ -1207,7 +1208,7 @@ msgstr ""
 ":ref:`函式註釋 <function>`\\ 是選擇性的元資料（metadata）資訊，描述使用者定義"
 "函式所使用的型別（更多資訊詳見 :pep:`3107` 和 :pep:`484`\\ ）。"
 
-#: ../../tutorial/controlflow.rst:1036
+#: ../../tutorial/controlflow.rst:1042
 msgid ""
 ":term:`Annotations <function annotation>` are stored in the :attr:"
 "`__annotations__` attribute of the function as a dictionary and have no "
@@ -1227,11 +1228,11 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../tutorial/controlflow.rst:1058
+#: ../../tutorial/controlflow.rst:1064
 msgid "Intermezzo: Coding Style"
 msgstr "間奏曲：程式碼風格 (Coding Style)"
 
-#: ../../tutorial/controlflow.rst:1063
+#: ../../tutorial/controlflow.rst:1069
 msgid ""
 "Now that you are about to write longer, more complex pieces of Python, it is "
 "a good time to talk about *coding style*.  Most languages can be written (or "
@@ -1244,7 +1245,7 @@ msgstr ""
 "式比其他的更具可讀性。能讓其他人輕鬆閱讀你的程式碼永遠是一個好主意，而使用優"
 "良的編碼樣式對此有極大的幫助。"
 
-#: ../../tutorial/controlflow.rst:1069
+#: ../../tutorial/controlflow.rst:1075
 msgid ""
 "For Python, :pep:`8` has emerged as the style guide that most projects "
 "adhere to; it promotes a very readable and eye-pleasing coding style.  Every "
@@ -1254,11 +1255,11 @@ msgstr ""
 "對於 Python，大多數的專案都遵循 :pep:`8` 的樣式指南；它推行的編碼樣式相當可讀"
 "且賞心悅目。每個 Python 開發者都應該花點時間研讀；這裡是該指南的核心重點："
 
-#: ../../tutorial/controlflow.rst:1074
+#: ../../tutorial/controlflow.rst:1080
 msgid "Use 4-space indentation, and no tabs."
 msgstr "用 4 個空格縮排，不要用 tab 鍵。"
 
-#: ../../tutorial/controlflow.rst:1076
+#: ../../tutorial/controlflow.rst:1082
 msgid ""
 "4 spaces are a good compromise between small indentation (allows greater "
 "nesting depth) and large indentation (easier to read).  Tabs introduce "
@@ -1267,41 +1268,41 @@ msgstr ""
 "4 個空格是小縮排（容許更大的巢套深度）和大縮排（較易閱讀）之間的折衷方案。"
 "Tab 鍵會造成混亂，最好別用。"
 
-#: ../../tutorial/controlflow.rst:1080
+#: ../../tutorial/controlflow.rst:1086
 msgid "Wrap lines so that they don't exceed 79 characters."
 msgstr "換行，使一行不超過 79 個字元。"
 
-#: ../../tutorial/controlflow.rst:1082
+#: ../../tutorial/controlflow.rst:1088
 msgid ""
 "This helps users with small displays and makes it possible to have several "
 "code files side-by-side on larger displays."
 msgstr ""
 "換行能讓使用小顯示器的使用者方便閱讀，也可以在較大顯示器上並排陳列多個程式碼"
 "檔案。"
 
-#: ../../tutorial/controlflow.rst:1085
+#: ../../tutorial/controlflow.rst:1091
 msgid ""
 "Use blank lines to separate functions and classes, and larger blocks of code "
 "inside functions."
 msgstr "用空行分隔函式和 class（類別），及函式內較大塊的程式碼。"
 
-#: ../../tutorial/controlflow.rst:1088
+#: ../../tutorial/controlflow.rst:1094
 msgid "When possible, put comments on a line of their own."
 msgstr "如果可以，把註解放在單獨一行。"
 
-#: ../../tutorial/controlflow.rst:1090
+#: ../../tutorial/controlflow.rst:1096
 msgid "Use docstrings."
 msgstr "使用說明字串。"
 
-#: ../../tutorial/controlflow.rst:1092
+#: ../../tutorial/controlflow.rst:1098
 msgid ""
 "Use spaces around operators and after commas, but not directly inside "
 "bracketing constructs: ``a = f(1, 2) + g(3, 4)``."
 msgstr ""
 "運算子前後、逗號後要加空格，但不要直接放在括號內側：\\ ``a = f(1, 2) + g(3, "
 "4)``\\ 。"
 
-#: ../../tutorial/controlflow.rst:1095
+#: ../../tutorial/controlflow.rst:1101
 msgid ""
 "Name your classes and functions consistently; the convention is to use "
 "``UpperCamelCase`` for classes and ``lowercase_with_underscores`` for "
@@ -1313,7 +1314,7 @@ msgstr ""
 "底線）。永遠用 ``self`` 作為 method 第一個引數的名稱（關於 class 和 method，"
 "詳見 :ref:`tut-firstclasses`\\ ）。"
 
-#: ../../tutorial/controlflow.rst:1100
+#: ../../tutorial/controlflow.rst:1106
 msgid ""
 "Don't use fancy encodings if your code is meant to be used in international "
 "environments.  Python's default, UTF-8, or even plain ASCII work best in any "
@@ -1322,7 +1323,7 @@ msgstr ""
 "若程式碼是為了用於國際環境時，不要用花俏的編碼。Python 預設的 UTF-8 或甚至普"
 "通的 ASCII，就可以勝任各種情況。"
 
-#: ../../tutorial/controlflow.rst:1104
+#: ../../tutorial/controlflow.rst:1110
 msgid ""
 "Likewise, don't use non-ASCII characters in identifiers if there is only the "
 "slightest chance people speaking a different language will read or maintain "
@@ -1331,11 +1332,11 @@ msgstr ""
 "同樣地，若不同語言使用者閱讀或維護程式碼的可能性微乎其微，就不要在命名時使用"
 "非 ASCII 字元。"
 
-#: ../../tutorial/controlflow.rst:1110
+#: ../../tutorial/controlflow.rst:1116
 msgid "Footnotes"
 msgstr "註解"
 
-#: ../../tutorial/controlflow.rst:1111
+#: ../../tutorial/controlflow.rst:1117
 msgid ""
 "Actually, *call by object reference* would be a better description, since if "
 "a mutable object is passed, the caller will see any changes the callee makes "
@@ -1353,54 +1354,54 @@ msgstr "statement（陳述式）"
 msgid "for"
 msgstr "for"
 
-#: ../../tutorial/controlflow.rst:438 ../../tutorial/controlflow.rst:975
+#: ../../tutorial/controlflow.rst:444 ../../tutorial/controlflow.rst:981
 msgid "documentation strings"
 msgstr "ddocumentation strings（說明字串）"
 
-#: ../../tutorial/controlflow.rst:438 ../../tutorial/controlflow.rst:975
+#: ../../tutorial/controlflow.rst:444 ../../tutorial/controlflow.rst:981
 msgid "docstrings"
 msgstr "docstrings（說明字串）"
 
-#: ../../tutorial/controlflow.rst:438 ../../tutorial/controlflow.rst:975
+#: ../../tutorial/controlflow.rst:444 ../../tutorial/controlflow.rst:981
 msgid "strings, documentation"
 msgstr "strings（字串）, documentation（說明文件）"
 
-#: ../../tutorial/controlflow.rst:879
+#: ../../tutorial/controlflow.rst:885
 msgid "* (asterisk)"
 msgstr "* （星號）"
 
-#: ../../tutorial/controlflow.rst:879 ../../tutorial/controlflow.rst:923
+#: ../../tutorial/controlflow.rst:885 ../../tutorial/controlflow.rst:929
 msgid "in function calls"
 msgstr "於函式呼叫中"
 
-#: ../../tutorial/controlflow.rst:923
+#: ../../tutorial/controlflow.rst:929
 msgid "**"
 msgstr "**"
 
-#: ../../tutorial/controlflow.rst:1027
+#: ../../tutorial/controlflow.rst:1033
 msgid "function"
 msgstr "function（函式）"
 
-#: ../../tutorial/controlflow.rst:1027
+#: ../../tutorial/controlflow.rst:1033
 msgid "annotations"
 msgstr "annotations（註釋）"
 
-#: ../../tutorial/controlflow.rst:1027
+#: ../../tutorial/controlflow.rst:1033
 msgid "->"
 msgstr "->"
 
-#: ../../tutorial/controlflow.rst:1027
+#: ../../tutorial/controlflow.rst:1033
 msgid "function annotations"
 msgstr "function annotations（函式註釋）"
 
-#: ../../tutorial/controlflow.rst:1027
+#: ../../tutorial/controlflow.rst:1033
 msgid ": (colon)"
 msgstr ": （冒號）"
 
-#: ../../tutorial/controlflow.rst:1061
+#: ../../tutorial/controlflow.rst:1067
 msgid "coding"
 msgstr "coding（程式編寫）"
 
-#: ../../tutorial/controlflow.rst:1061
+#: ../../tutorial/controlflow.rst:1067
 msgid "style"
 msgstr "style（風格）"