@@ -56,6 +56,11 @@ msgid ""
5656"Excel. Programmers can also describe the CSV formats understood by other "
5757"applications or define their own special-purpose CSV formats."
5858msgstr ""
59+ ":mod:`csv` 模組實作透過 class 去讀取、寫入 CSV 格式的表格資料。"
60+ "它讓程式設計師可以說出：「以 Excel 為首選並寫入該種格式的資料」或是"
61+ "「從 Excel 產生的檔案來讀取資料」，且無需知道這是 Excel 所使用的 "
62+ "CSV 格式等精確的細節。程式設計師也可以描述其他應用程式所理解的 CSV 格式"
63+ "或他們自行定義具有特殊意義的 CSV 格式。"
5964
6065#: ../../library/csv.rst:35
6166msgid ""
@@ -73,7 +78,7 @@ msgstr ":pep:`305` - CSV 檔案 API"
7378
7479#: ../../library/csv.rst:42
7580msgid "The Python Enhancement Proposal which proposed this addition to Python."
76- msgstr ""
81+ msgstr "Python Enhancement Proposal (PEP) 所提出的 Python 附加功能。 "
7782
7883#: ../../library/csv.rst:48
7984msgid "Module Contents"
@@ -98,6 +103,18 @@ msgid ""
98103"in the current dialect. For full details about the dialect and formatting "
99104"parameters, see section :ref:`csv-fmt-params`."
100105msgstr ""
106+ "回傳一個讀取器物件 (reader object) 並在指定的 *csvfile* 中逐行疊代 (iterate)，"
107+ "*csvfile* 可以成為任何物件並支援 :term:`iterator` 協定，每次呼叫 "
108+ ":meth:`!__next__` method（方法）時皆會回傳一個字串，"
109+ ":term:`檔案物件 (file object) <file object>` 及串列物件 (list object) "
110+ "皆適用。如果 *csvfile* 是個檔案物件，則需開啟時使用 ``newline=''``。"
111+ " [1]_ *dialect* 為一個可選填的參數，可以用為特定的 CSV dialect（方言）"
112+ " 定義一組參數。它可能為 :class:`Dialect` 的一個子類別 (subclass) 的實例"
113+ "或是由 :func:`list_dialects` 函式回傳的多個字串中的其中之一。"
114+ "另一個可選填的關鍵字引數 *fmtparams* 可以在這個 dialect 中 override（覆寫）"
115+ "獨立的格式化參數 (formatting parameter)。關於 dialect 及格式化參數的完整"
116+ "說明，請見段落 :ref:`csv-fmt-params`。"
117+
101118
102119#: ../../library/csv.rst:71
103120msgid ""
@@ -111,9 +128,7 @@ msgstr ""
111128#: ../../library/csv.rst:216
112129msgid "A short usage example::"
113130msgstr ""
114- "一個簡短的用法範例：\n"
115- "\n"
116- "::"
131+ "一個簡短的用法範例： ::"
117132
118133#: ../../library/csv.rst:88
119134msgid ""