diff --git a/library/csv.po b/library/csv.po index 8ae6c46395..8b742a9fca 100644 --- a/library/csv.po +++ b/library/csv.po @@ -111,8 +111,8 @@ msgstr "" " [1]_ *dialect* 為一個可選填的參數,可以用為特定的 CSV dialect(方言)" " 定義一組參數。它可能為 :class:`Dialect` 的一個子類別 (subclass) 的實例" "或是由 :func:`list_dialects` 函式回傳的多個字串中的其中之一。" -"另一個可選填的關鍵字引數 *fmtparams* 可以在這個 dialect 中 override(覆寫)" -"獨立的格式化參數 (formatting parameter)。關於 dialect 及格式化參數的完整" +"另一個可選填的關鍵字引數 *fmtparams* 可以在這個 dialect 中覆寫 (override) " +"個別的格式化參數 (formatting parameter)。關於 dialect 及格式化參數的完整" "說明,請見段落 :ref:`csv-fmt-params`。" @@ -123,6 +123,9 @@ msgid "" "format option is specified (in which case unquoted fields are transformed " "into floats)." msgstr "" +"從 CSV 檔案讀取的每一列會回傳為一個字串列表。除非格式選項 " +"``QUOTE_NONNUMERIC`` 有被指定(在這個情況之下,沒有引號的欄位" +"都會被轉換成浮點數),否則不會進行自動資料型別轉換。" #: ../../library/csv.rst:75 ../../library/csv.rst:105 ../../library/csv.rst:178 #: ../../library/csv.rst:216 @@ -149,6 +152,19 @@ msgid "" "returned from a ``cursor.fetch*`` call. All other non-string data are " "stringified with :func:`str` before being written." msgstr "" +"回傳一個寫入器物件 (writer object),其負責在給定的類檔案物件 (file-like " +"object) 上將使用者的資料轉換為分隔字串 (delimited string)。*csvfile* 可以為" +"具有 :func:`write` method 的任何物件。若 *csvfile* 為一個檔案物件,它應該使用" +" ``newline=''`` 開啟 [1]_ 。*dialect* 為一個可選填的參數,可以用為特定的" +" CSV dialect 定義一組參數。它可能為 :class:`Dialect` 的一個子類別的實例" +"或是由 :func:`list_dialects` 函式回傳的多個字串中的其中之一。" +"另一個可選填的關鍵字引數 *fmtparams* 可以在這個 dialect 中覆寫" +"個別的格式化參數。關於 dialect 及格式化參數的完整說明,請見段落" +" :ref:`csv-fmt-params`。為了更容易與有實作 DB API 的模組互相接合," +":const:`None` 值會被寫成空字串。雖然這不是一個可逆的變換,這使得" +"dump (傾印) SQL NULL 資料值到 CSV 檔案上就無需讓 ``cursor.fetch*`` " +"呼叫回傳的資料進行預處理 (preprocessing)。其餘非字串的資料則會在寫入之前" +"用 :func:`str` 函式進行字串化 (stringify)。" #: ../../library/csv.rst:117 msgid "" @@ -158,12 +174,18 @@ msgid "" "parameters of the dialect. For full details about dialects and formatting " "parameters, see section :ref:`csv-fmt-params`." msgstr "" +"將 *dialect* 與 *name* 進行關聯 (associate)。*name* 必須為字串。這個 dialect " +"可以透過傳遞 :class:`Dialect` 的子類別進行指定;或是關鍵字引數 " +"*fmtparams*;或是以上兩者皆是,並透過關鍵字引數來覆寫 dialect 的參數。" +"關於 dialect 及格式化參數的完整說明,請見段落 :ref:`csv-fmt-params`。" #: ../../library/csv.rst:126 msgid "" "Delete the dialect associated with *name* from the dialect registry. An :" "exc:`Error` is raised if *name* is not a registered dialect name." msgstr "" +"從 dialect 註冊表 (registry) 中,刪除與 *name* 關聯的 dialect。若 *name* 如" +"果不是註冊的 dialect 名稱,則會產生一個 :exc:`Error`。" #: ../../library/csv.rst:132 msgid "" @@ -171,20 +193,25 @@ msgid "" "*name* is not a registered dialect name. This function returns an " "immutable :class:`Dialect`." msgstr "" +"回傳一個與 *name* 關聯的 dialect。若 *name* 如果不是註冊的 dialect 名稱" +",則會產生一個 :exc:`Error`。這個函式會回傳一個 immutable (不可變物件) " +":class:`Dialect`。" #: ../../library/csv.rst:138 msgid "Return the names of all registered dialects." -msgstr "" +msgstr "回傳所有已註冊的 dialect 名稱。" #: ../../library/csv.rst:143 msgid "" "Returns the current maximum field size allowed by the parser. If *new_limit* " "is given, this becomes the new limit." msgstr "" +"回傳當前的剖析器 (parser) 允許的最大字串大小。如果 *new_limit* 被給定," +"則會變成新的最大字串大小。" #: ../../library/csv.rst:147 msgid "The :mod:`csv` module defines the following classes:" -msgstr "" +msgstr ":mod:`csv` 模組定義了下列的類別:" #: ../../library/csv.rst:152 msgid "" @@ -192,6 +219,8 @@ msgid "" "information in each row to a :class:`dict` whose keys are given by the " "optional *fieldnames* parameter." msgstr "" +"建立一個物件,其運作上就像一般的讀取器,但可以將每一列資訊 map (對映)" +" 到 :class:`dict` 中,可以透過選填的參數 *fieldnames* 設定 key。" #: ../../library/csv.rst:156 msgid ""