conversion.po

# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
# Ching-Lung Chuang, 2015
# Leon H., 2017
# Matt Wang <mattwang44@gmail.com>, 2023
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-11-26 00:14+0000\n"
"PO-Revision-Date: 2023-12-11 18:26+0000\n"
"Last-Translator: Matt Wang <mattwang44@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"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../c-api/conversion.rst:6
msgid "String conversion and formatting"
msgstr "字串轉換與格式化"

#: ../../c-api/conversion.rst:8
msgid "Functions for number conversion and formatted string output."
msgstr "用於數字轉換和格式化字串輸出的函式。"

#: ../../c-api/conversion.rst:13
msgid ""
"Output not more than *size* bytes to *str* according to the format string "
"*format* and the extra arguments. See the Unix man page :manpage:"
"`snprintf(3)`."
msgstr ""
"根據格式字串 *format* 和額外引數，輸出不超過 *size* 位元組給 *str*。請參閱 "
"Unix 使用手冊 :manpage:`snprintf(3)`。"

#: ../../c-api/conversion.rst:19
msgid ""
"Output not more than *size* bytes to *str* according to the format string "
"*format* and the variable argument list *va*. Unix man page :manpage:"
"`vsnprintf(3)`."
msgstr ""
"根據格式字串 *format* 和變數引數串列 *va*，輸出不超過 *size* 位元組給 *str*。"
"Unix 使用手冊 :manpage:`vsnprintf(3)`。"

#: ../../c-api/conversion.rst:23
msgid ""
":c:func:`PyOS_snprintf` and :c:func:`PyOS_vsnprintf` wrap the Standard C "
"library functions :c:func:`snprintf` and :c:func:`vsnprintf`. Their purpose "
"is to guarantee consistent behavior in corner cases, which the Standard C "
"functions do not."
msgstr ""
":c:func:`PyOS_snprintf` 和 :c:func:`PyOS_vsnprintf` 包裝標準 C 函式庫函式 :c:"
"func:`snprintf` 和 :c:func:`vsnprintf`。它們的目的是確保邊角案例 (corner "
"case) 下的行為一致，而標準 C 函式則不然。"

#: ../../c-api/conversion.rst:28
msgid ""
"The wrappers ensure that ``str[size-1]`` is always ``'\\0'`` upon return. "
"They never write more than *size* bytes (including the trailing ``'\\0'``) "
"into str. Both functions require that ``str != NULL``, ``size > 0``, "
"``format != NULL`` and ``size < INT_MAX``. Note that this means there is no "
"equivalent to the C99 ``n = snprintf(NULL, 0, ...)`` which would determine "
"the necessary buffer size."
msgstr ""
"包裝器確保回傳時 ``str[size-1]`` 始終為 ``'\\0'``。他們永遠不會在 str 中寫入"
"超過 *size* 位元組（包括尾隨的 ``'\\0'``\\ ）。這兩個函式都要求 ``str != "
"NULL``、``size > 0``、``format != NULL`` 和 ``size < INT_MAX``。請注意，這表"
"示沒有與 C99 ``n = snprintf(NULL, 0, ...)`` 等效的函式來決定必要的緩衝區大"
"小。"

#: ../../c-api/conversion.rst:34
msgid ""
"The return value (*rv*) for these functions should be interpreted as follows:"
msgstr "這些函式的回傳值 (*rv*) 應如下被直譯："

#: ../../c-api/conversion.rst:36
msgid ""
"When ``0 <= rv < size``, the output conversion was successful and *rv* "
"characters were written to *str* (excluding the trailing ``'\\0'`` byte at "
"``str[rv]``)."
msgstr ""
"當 ``0 <= rv < size`` 時，輸出轉換成功，*rv* 字元被寫入 *str*\\ （不包括 "
"``str[rv]`` 處的尾隨 ``'\\0'`` 位元組）。"

#: ../../c-api/conversion.rst:40
msgid ""
"When ``rv >= size``, the output conversion was truncated and a buffer with "
"``rv + 1`` bytes would have been needed to succeed. ``str[size-1]`` is "
"``'\\0'`` in this case."
msgstr ""
"當 ``rv >= size`` 時，輸出轉換被截斷，並且需要具有 ``rv + 1`` 位元組的緩衝區"
"才能成功。在這種情況下，``str[size-1]`` 是 ``'\\0'``。"

#: ../../c-api/conversion.rst:44
msgid ""
"When ``rv < 0``, the output conversion failed and ``str[size-1]`` is "
"``'\\0'`` in this case too, but the rest of *str* is undefined. The exact "
"cause of the error depends on the underlying platform."
msgstr ""
"當 ``rv < 0`` 時，代表輸出的轉換失敗，且在這種情況下 ``str[size-1]`` 也是 "
"``'\\0'``，但 *str* 的其餘部分未定義。錯誤的確切原因取決於底層平台。"

#: ../../c-api/conversion.rst:49
msgid ""
"The following functions provide locale-independent string to number "
"conversions."
msgstr "以下函式提供與區域設定無關 (locale-independent) 的字串到數字的轉換。"

#: ../../c-api/conversion.rst:53
msgid ""
"Convert the initial part of the string in ``str`` to an :c:expr:`unsigned "
"long` value according to the given ``base``, which must be between ``2`` and "
"``36`` inclusive, or be the special value ``0``."
msgstr ""
"將字串 ``str`` 的初始部分根據給定的 ``base`` 轉換為 :c:expr:`unsigned long` "
"值，底 (base) 必須介於 ``2`` 到 ``36``\\ （包含）之間，或為特殊值 ``0``。"

#: ../../c-api/conversion.rst:57
msgid ""
"Leading white space and case of characters are ignored.  If ``base`` is zero "
"it looks for a leading ``0b``, ``0o`` or ``0x`` to tell which base.  If "
"these are absent it defaults to ``10``.  Base must be 0 or between 2 and 36 "
"(inclusive).  If ``ptr`` is non-``NULL`` it will contain a pointer to the "
"end of the scan."
msgstr ""
"忽略前導空白和字元大小寫。如果 ``base`` 為零，則會尋找前導的 ``0b``、``0o`` "
"或 ``0x`` 來判斷使用哪個進位。如果這些前綴不存在，則預設為 ``10``。底必須為 "
"0 或介於 2 到 36（包含）之間。如果 ``ptr`` 為非 ``NULL``，它將包含指向掃描結"
"束處的指標。"

#: ../../c-api/conversion.rst:63
msgid ""
"If the converted value falls out of range of corresponding return type, "
"range error occurs (:c:data:`errno` is set to :c:macro:`!ERANGE`) and :c:"
"macro:`!ULONG_MAX` is returned.  If no conversion can be performed, ``0`` is "
"returned."
msgstr ""
"如果轉換後的值超出對應回傳型別的範圍，則會發生範圍錯誤（:c:data:`errno` 會被"
"設定為 :c:macro:`!ERANGE`）並回傳 :c:macro:`!ULONG_MAX`。如果無法執行任何轉"
"換，則回傳 ``0``。"

#: ../../c-api/conversion.rst:68
msgid "See also the Unix man page :manpage:`strtoul(3)`."
msgstr "也請見 Unix 使用手冊 :manpage:`strtoul(3)`。"

#: ../../c-api/conversion.rst:75
msgid ""
"Convert the initial part of the string in ``str`` to an :c:expr:`long` value "
"according to the given ``base``, which must be between ``2`` and ``36`` "
"inclusive, or be the special value ``0``."
msgstr ""
"將字串 ``str`` 的初始部分根據給定的 ``base`` 轉換為 :c:expr:`long` 值，底 必"
"須介於 ``2`` 到 ``36`` \\ （包含）之間，或為特殊值 ``0``。"

#: ../../c-api/conversion.rst:79
msgid ""
"Same as :c:func:`PyOS_strtoul`, but return a :c:expr:`long` value instead "
"and :c:macro:`LONG_MAX` on overflows."
msgstr ""
"與 :c:func:`PyOS_strtoul` 相同，但回傳 :c:expr:`long` 值，並在溢位時回傳 :c:"
"macro:`LONG_MAX`。"

#: ../../c-api/conversion.rst:82
msgid "See also the Unix man page :manpage:`strtol(3)`."
msgstr "也請見 Unix 使用手冊 :manpage:`strtol(3)`。"

#: ../../c-api/conversion.rst:89
msgid ""
"Convert a string ``s`` to a :c:expr:`double`, raising a Python exception on "
"failure.  The set of accepted strings corresponds to the set of strings "
"accepted by Python's :func:`float` constructor, except that ``s`` must not "
"have leading or trailing whitespace. The conversion is independent of the "
"current locale."
msgstr ""
"將字串 ``s`` 轉換為 :c:expr:`double`，失敗時引發 Python 例外。接受的字串集合"
"對應於 Python 的 :func:`float` 建構函式接受的字串集合，但 ``s`` 不得有前導或"
"尾隨的空格。轉換與目前區域設定無關。"

#: ../../c-api/conversion.rst:95
msgid ""
"If ``endptr`` is ``NULL``, convert the whole string.  Raise :exc:"
"`ValueError` and return ``-1.0`` if the string is not a valid representation "
"of a floating-point number."
msgstr ""
"如果 ``endptr`` 為 ``NULL``，則轉換整個字串。如果字串不是浮點數的有效表示，則"
"引發 :exc:`ValueError` 並回傳 ``-1.0``。"

#: ../../c-api/conversion.rst:99
msgid ""
"If endptr is not ``NULL``, convert as much of the string as possible and set "
"``*endptr`` to point to the first unconverted character.  If no initial "
"segment of the string is the valid representation of a floating-point "
"number, set ``*endptr`` to point to the beginning of the string, raise "
"ValueError, and return ``-1.0``."
msgstr ""
"如果 endptr 不是 ``NULL``，則盡可能轉換字串，並將 ``*endptr`` 設定為指向第一"
"個未轉換的字元。如果字串的初始片段都不是浮點數的有效表示，則設定 ``*endptr`` "
"指向字串的開頭，引發 ValueError 並回傳 ``-1.0``。"

#: ../../c-api/conversion.rst:106
msgid ""
"If ``s`` represents a value that is too large to store in a float (for "
"example, ``\"1e500\"`` is such a string on many platforms) then if "
"``overflow_exception`` is ``NULL`` return ``Py_INFINITY`` (with an "
"appropriate sign) and don't set any exception.  Otherwise, "
"``overflow_exception`` must point to a Python exception object; raise that "
"exception and return ``-1.0``.  In both cases, set ``*endptr`` to point to "
"the first character after the converted value."
msgstr ""
"如果 ``s`` 表示的值太大而無法儲存在浮點數中（例如 ``\"1e500\"`` 在許多平台上"
"都是這樣的字串），如果 ``overflow_exception`` 為 ``NULL`` 則回傳 "
"``Py_INFINITY``\\ （會帶有適當的符號）並且不設定任何例外。否則， "
"``overflow_exception`` 必須指向一個 Python 例外物件；引發該例外並回傳 "
"``-1.0``。在這兩種情況下，將 ``*endptr`` 設定為指向轉換後的值之後的第一個字"
"元。"

#: ../../c-api/conversion.rst:114
msgid ""
"If any other error occurs during the conversion (for example an out-of-"
"memory error), set the appropriate Python exception and return ``-1.0``."
msgstr ""
"如果轉換期間發生任何其他錯誤（例如記憶體不足的錯誤），請設定適當的 Python 例"
"外並回傳 ``-1.0``。"

#: ../../c-api/conversion.rst:123
msgid ""
"Convert a :c:expr:`double` *val* to a string using supplied *format_code*, "
"*precision*, and *flags*."
msgstr ""
"使用提供的 *format_code*、*precision* 和 *flags* 將 :c:expr:`double` *val* 轉"
"換為字串。"

#: ../../c-api/conversion.rst:126
msgid ""
"*format_code* must be one of ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, "
"``'G'`` or ``'r'``.  For ``'r'``, the supplied *precision* must be 0 and is "
"ignored.  The ``'r'`` format code specifies the standard :func:`repr` format."
msgstr ""
"*format_code* 必須是 ``'e'``、``'E'``、``'f'``、``'F'``、``'g'``、``'G'`` 或 "
"``'r'`` 其中之一。對於 ``'r'``，提供的 *precision* 必須為 0 並會被忽略。"
"``'r'`` 格式碼指定標準 :func:`repr` 格式。"

#: ../../c-api/conversion.rst:131
msgid "*flags* can be zero or more of the following values or-ed together:"
msgstr "*flags* 可以是零個或多個以下的值被聯集在一起："

#: ../../c-api/conversion.rst:135
msgid ""
"Always precede the returned string with a sign character, even if *val* is "
"non-negative."
msgstr ""
"總是在回傳的字串前面加上正負號字元 (sign character)，即使 *val* 非負數。"

#: ../../c-api/conversion.rst:140
msgid "Ensure that the returned string will not look like an integer."
msgstr "確保回傳的字串看起來不會像整數。"

#: ../../c-api/conversion.rst:144
msgid ""
"Apply \"alternate\" formatting rules. See the documentation for the :c:func:"
"`PyOS_snprintf` ``'#'`` specifier for details."
msgstr ""
"套用「備用的 (alternate)」格式化規則。有關詳細資訊，請參閱 :c:func:"
"`PyOS_snprintf` ``'#'`` 的文件。"

#: ../../c-api/conversion.rst:150
msgid "Negative zero is converted to positive zero."
msgstr "負零會被轉換為正零。"

#: ../../c-api/conversion.rst:154
msgid ""
"If *ptype* is non-``NULL``, then the value it points to will be set to one "
"of ``Py_DTST_FINITE``, ``Py_DTST_INFINITE``, or ``Py_DTST_NAN``, signifying "
"that *val* is a finite number, an infinite number, or not a number, "
"respectively."
msgstr ""
"如果 *ptype* 是非 ``NULL``，那麼它指向的值將被設定為 ``Py_DTST_FINITE``、"
"``Py_DTST_INFINITE`` 或 ``Py_DTST_NAN`` 其中之一，分別代表 *val* 是有限數、無"
"限數或非數。"

#: ../../c-api/conversion.rst:158
msgid ""
"The return value is a pointer to *buffer* with the converted string or "
"``NULL`` if the conversion failed. The caller is responsible for freeing the "
"returned string by calling :c:func:`PyMem_Free`."
msgstr ""
"回傳值是指向 *buffer* 的指標，其中包含轉換後的字串，如果轉換失敗則回傳 "
"``NULL``。呼叫者負責透過呼叫 :c:func:`PyMem_Free` 來釋放回傳的字串。"

#: ../../c-api/conversion.rst:168
msgid ""
"Case insensitive comparison of strings. These functions work almost "
"identically to :c:func:`!strcmp` and :c:func:`!strncmp` (respectively), "
"except that they ignore the case of ASCII characters."
msgstr ""
"不區分大小寫的字串比較。函式的作用方式幾乎與 :c:func:`!strcmp` 和 :c:func:`!strncmp` "
"相同，只是它們忽略大小寫。"

#: ../../c-api/conversion.rst:172
msgid ""
"Return ``0`` if the strings are equal, a negative value if *str1* sorts "
"lexicographically before *str2*, or a positive value if it sorts after."
msgstr ""

#: ../../c-api/conversion.rst:175
msgid ""
"In the *str1* or *str2* arguments, a NUL byte marks the end of the string. "
"For :c:func:`!PyOS_mystrnicmp`, the *size* argument gives the maximum size "
"of the string, as if NUL was present at the index given by *size*."
msgstr ""

#: ../../c-api/conversion.rst:179
msgid "These functions do not use the locale."
msgstr ""

#: ../../c-api/conversion.rst:185
msgid "Case insensitive comparison of strings."
msgstr "不區分大小寫的字串比較。"

#: ../../c-api/conversion.rst:187
msgid ""
"On Windows, these are aliases of :c:func:`!stricmp` and :c:func:`!strnicmp`, "
"respectively."
msgstr ""

#: ../../c-api/conversion.rst:190
msgid ""
"On other platforms, they are aliases of :c:func:`PyOS_mystricmp` and :c:func:"
"`PyOS_mystrnicmp`, respectively."
msgstr ""

#: ../../c-api/conversion.rst:195
msgid "Character classification and conversion"
msgstr ""

#: ../../c-api/conversion.rst:197
msgid ""
"The following macros provide locale-independent (unlike the C standard "
"library ``ctype.h``) character classification and conversion. The argument "
"must be a signed or unsigned :c:expr:`char`."
msgstr ""

#: ../../c-api/conversion.rst:204
msgid "Return true if the character *c* is an alphanumeric character."
msgstr ""

#: ../../c-api/conversion.rst:209
msgid ""
"Return true if the character *c* is an alphabetic character (``a-z`` and ``A-"
"Z``)."
msgstr ""

#: ../../c-api/conversion.rst:214
msgid "Return true if the character *c* is a decimal digit (``0-9``)."
msgstr ""

#: ../../c-api/conversion.rst:219
msgid "Return true if the character *c* is a lowercase ASCII letter (``a-z``)."
msgstr ""

#: ../../c-api/conversion.rst:224
msgid ""
"Return true if the character *c* is an uppercase ASCII letter (``A-Z``)."
msgstr ""

#: ../../c-api/conversion.rst:229
msgid ""
"Return true if the character *c* is a whitespace character (space, tab, "
"carriage return, newline, vertical tab, or form feed)."
msgstr ""

#: ../../c-api/conversion.rst:235
msgid ""
"Return true if the character *c* is a hexadecimal digit (``0-9``, ``a-f``, "
"and ``A-F``)."
msgstr ""

#: ../../c-api/conversion.rst:241
msgid "Return the lowercase equivalent of the character *c*."
msgstr ""

#: ../../c-api/conversion.rst:246
msgid "Return the uppercase equivalent of the character *c*."
msgstr ""