struct.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2022, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-09-23 07:52+0800\n"
"PO-Revision-Date: 2018-05-23 16:11+0000\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"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/struct.rst:2
msgid ":mod:`!struct` --- Interpret bytes as packed binary data"
msgstr ":mod:`!struct` --- 將位元組直譯為打包起來的二進位資料"

#: ../../library/struct.rst:11
msgid "**Source code:** :source:`Lib/struct.py`"
msgstr "**原始碼：**\\ :source:`Lib/struct.py`"

#: ../../library/struct.rst:19
msgid ""
"This module converts between Python values and C structs represented as "
"Python :class:`bytes` objects.  Compact :ref:`format strings <struct-format-"
"strings>` describe the intended conversions to/from Python values. The "
"module's functions and objects can be used for two largely distinct "
"applications, data exchange with external sources (files or network "
"connections), or data transfer between the Python application and the C "
"layer."
msgstr ""
"此模組可在 Python 數值與以 Python :class:`bytes` 物件表示的 C 結構之間進行轉換。\\"
"簡潔的\\ :ref:`格式字串 <struct-format-strings>` 描述了與 Python 數值之間預期的轉換。\\"
"此模組的函式和物件可用於兩種截然不同的應用：與外部來源（檔案或網路連線）的資料交換，\\"
"或是 Python 應用程式與 C 層之間的資料傳輸。"

#: ../../library/struct.rst:29
msgid ""
"When no prefix character is given, native mode is the default. It packs or "
"unpacks data based on the platform and compiler on which the Python "
"interpreter was built. The result of packing a given C struct includes pad "
"bytes which maintain proper alignment for the C types involved; similarly, "
"alignment is taken into account when unpacking.  In contrast, when "
"communicating data between external sources, the programmer is responsible "
"for defining byte ordering and padding between elements. See :ref:`struct-"
"alignment` for details."
msgstr ""
"當未給定前綴字元時，原生模式為預設模式。它會根據建構 Python 直譯器的平台和編譯器來\\"
"打包或解包資料。打包給定 C 結構的結果包含填充位元組，以維持相關 C 型別的正確對齊；\\"
"同樣地，解包時也會考量對齊。相反地，當在外部來源之間傳輸資料時，程式設計師需負責定義\\"
"位元組順序和元素之間的填充。詳情請參見\\ :ref:`struct-alignment`。"

#: ../../library/struct.rst:39
msgid ""
"Several :mod:`struct` functions (and methods of :class:`Struct`) take a "
"*buffer* argument.  This refers to objects that implement "
"the :ref:`bufferobjects` and provide either a readable or read-writable "
"buffer.  The most common types used for that purpose are :class:`bytes` "
"and :class:`bytearray`, but many other types that can be viewed as an array "
"of bytes implement the buffer protocol, so that they can be read/filled "
"without additional copying from a :class:`bytes` object."
msgstr ""
"一些\\ :mod:`struct` 函式（和 :class:`Struct` 的方法）接受一個 *buffer* 引數。\\"
"這是指實作\\ :ref:`bufferobjects` 並提供可讀或可讀寫緩衝區的物件。最常用於此目的的\\"
"型別是\\ :class:`bytes` 和\\ :class:`bytearray`，但許多其他可以視為位元組陣列的\\"
"型別都實作了緩衝區協議，因此它們可以從\\ :class:`bytes` 物件讀取或填入資料而無需\\"
"額外的複製。"

#: ../../library/struct.rst:48
msgid "Functions and Exceptions"
msgstr "函式與例外"

#: ../../library/struct.rst:50
msgid "The module defines the following exception and functions:"
msgstr "此模組定義了以下例外和函式："

#: ../../library/struct.rst:55
msgid ""
"Exception raised on various occasions; argument is a string describing what "
"is wrong."
msgstr ""
"在各種情況下觸發的例外；引數是一個描述錯誤內容的字串。"

#: ../../library/struct.rst:61
msgid ""
"Return a bytes object containing the values *v1*, *v2*, ... packed according "
"to the format string *format*.  The arguments must match the values required "
"by the format exactly."
msgstr ""
"回傳一個包含依照格式字串 *format* 打包的數值 *v1*、*v2*、... 的 bytes 物件。\\"
"引數必須完全符合格式所需的數值。"

#: ../../library/struct.rst:68
msgid ""
"Pack the values *v1*, *v2*, ... according to the format string *format* and "
"write the packed bytes into the writable buffer *buffer* starting at "
"position *offset*.  Note that *offset* is a required argument."
msgstr ""
"依照格式字串 *format* 打包數值 *v1*、*v2*、...，並將打包後的位元組寫入可寫緩衝區 "
"*buffer* 中從位置 *offset* 開始的地方。請注意 *offset* 是必要的引數。"

#: ../../library/struct.rst:75
msgid ""
"Unpack from the buffer *buffer* (presumably packed by ``pack(format, ...)``) "
"according to the format string *format*.  The result is a tuple even if it "
"contains exactly one item.  The buffer's size in bytes must match the size "
"required by the format, as reflected by :func:`calcsize`."
msgstr ""
"根據格式字串 *format* 從緩衝區 *buffer*（推測是由 ``pack(format, ...)`` 打包的）\\"
"解包。結果是一個元組，即使它只包含一個項目。緩衝區的位元組大小必須符合格式所需的\\"
"大小，如\\ :func:`calcsize` 所示。"

#: ../../library/struct.rst:83
msgid ""
"Unpack from *buffer* starting at position *offset*, according to the format "
"string *format*.  The result is a tuple even if it contains exactly one "
"item.  The buffer's size in bytes, starting at position *offset*, must be at "
"least the size required by the format, as reflected by :func:`calcsize`."
msgstr ""
"根據格式字串 *format* 從 *buffer* 的位置 *offset* 開始解包。結果是一個元組，\\"
"即使它只包含一個項目。緩衝區從位置 *offset* 開始的位元組大小，必須至少達到\\"
"格式所需的大小，如\\ :func:`calcsize` 所示。"

#: ../../library/struct.rst:91
msgid ""
"Iteratively unpack from the buffer *buffer* according to the format string "
"*format*.  This function returns an iterator which will read equally sized "
"chunks from the buffer until all its contents have been consumed.  The "
"buffer's size in bytes must be a multiple of the size required by the "
"format, as reflected by :func:`calcsize`."
msgstr ""
"根據格式字串 *format* 迭代地從緩衝區 *buffer* 解包。此函式回傳一個迭代器，\\"
"它會從緩衝區讀取等大小的區塊，直到消耗完所有內容。緩衝區的位元組大小必須是\\"
"格式所需大小的倍數，如\\ :func:`calcsize` 所示。"

#: ../../library/struct.rst:97
msgid "Each iteration yields a tuple as specified by the format string."
msgstr "每次迭代都會產出由格式字串指定的元組。"

#: ../../library/struct.rst:104
msgid ""
"Return the size of the struct (and hence of the bytes object produced by "
"``pack(format, ...)``) corresponding to the format string *format*."
msgstr ""
"回傳對應於格式字串 *format* 的結構大小（因此也是 ``pack(format, ...)`` \\"
"所產生的 bytes 物件的大小）。"

#: ../../library/struct.rst:111
msgid "Format Strings"
msgstr "格式字串"

#: ../../library/struct.rst:113
msgid ""
"Format strings describe the data layout when packing and unpacking data.  "
"They are built up from :ref:`format characters<format-characters>`, which "
"specify the type of data being packed/unpacked.  In addition, special "
"characters control the :ref:`byte order, size and alignment<struct-"
"alignment>`. Each format string consists of an optional prefix character "
"which describes the overall properties of the data and one or more format "
"characters which describe the actual data values and padding."
msgstr ""
"格式字串描述了打包和解包資料時的資料配置。它們由\\ :ref:`格式字元<format-characters>` \\"
"組成，這些字元指定了要打包或解包的資料型別。此外，特殊字元控制\\ :ref:`位元組順序、\\"
"大小和對齊<struct-alignment>`。每個格式字串由一個可選的前綴字元組成，描述資料的\\"
"整體屬性，以及一個或多個描述實際資料值和填充的格式字元。"

#: ../../library/struct.rst:125
msgid "Byte Order, Size, and Alignment"
msgstr "位元組順序、大小和對齊"

#: ../../library/struct.rst:127
msgid ""
"By default, C types are represented in the machine's native format and byte "
"order, and properly aligned by skipping pad bytes if necessary (according to "
"the rules used by the C compiler). This behavior is chosen so that the bytes "
"of a packed struct correspond exactly to the memory layout of the "
"corresponding C struct. Whether to use native byte ordering and padding or "
"standard formats depends on the application."
msgstr ""
"預設情況下，C 型別以機器的原生格式和位元組順序表示，並在必要時透過跳過填充位元組\\"
"來正確對齊（根據 C 編譯器所使用的規則）。選擇此行為使得打包結構的位元組完全對應於\\"
"相對應 C 結構的記憶體配置。是否使用原生位元組順序和填充或標準格式取決於應用程式。"

#: ../../library/struct.rst:143
msgid ""
"Alternatively, the first character of the format string can be used to "
"indicate the byte order, size and alignment of the packed data, according to "
"the following table:"
msgstr ""

#: ../../library/struct.rst:148
msgid "Character"
msgstr ""

#: ../../library/struct.rst:148
msgid "Byte order"
msgstr ""

#: ../../library/struct.rst:148
msgid "Size"
msgstr ""

#: ../../library/struct.rst:148
msgid "Alignment"
msgstr ""

#: ../../library/struct.rst:150
msgid "``@``"
msgstr "``@``"

#: ../../library/struct.rst:150 ../../library/struct.rst:152
msgid "native"
msgstr ""

#: ../../library/struct.rst:152
msgid "``=``"
msgstr "``=``"

#: ../../library/struct.rst:152 ../../library/struct.rst:154
#: ../../library/struct.rst:156 ../../library/struct.rst:158
msgid "standard"
msgstr ""

#: ../../library/struct.rst:152 ../../library/struct.rst:154
#: ../../library/struct.rst:156 ../../library/struct.rst:158
msgid "none"
msgstr ""

#: ../../library/struct.rst:154
msgid "``<``"
msgstr "``<``"

#: ../../library/struct.rst:154
msgid "little-endian"
msgstr ""

#: ../../library/struct.rst:156
msgid "``>``"
msgstr "``>``"

#: ../../library/struct.rst:156
msgid "big-endian"
msgstr ""

#: ../../library/struct.rst:158
msgid "``!``"
msgstr "``!``"

#: ../../library/struct.rst:158
msgid "network (= big-endian)"
msgstr ""

#: ../../library/struct.rst:161
msgid "If the first character is not one of these, ``'@'`` is assumed."
msgstr ""

#: ../../library/struct.rst:165
msgid ""
"The number 1023 (``0x3ff`` in hexadecimal) has the following byte "
"representations:"
msgstr ""

#: ../../library/struct.rst:167
msgid "``03 ff`` in big-endian (``>``)"
msgstr ""

#: ../../library/struct.rst:168
msgid "``ff 03`` in little-endian (``<``)"
msgstr ""

#: ../../library/struct.rst:170
msgid "Python example:"
msgstr ""

#: ../../library/struct.rst:178
msgid ""
"Native byte order is big-endian or little-endian, depending on the host "
"system. For example, Intel x86, AMD64 (x86-64), and Apple M1 are little-"
"endian; IBM z and many legacy architectures are big-endian. "
"Use :data:`sys.byteorder` to check the endianness of your system."
msgstr ""

#: ../../library/struct.rst:183
msgid ""
"Native size and alignment are determined using the C compiler's ``sizeof`` "
"expression.  This is always combined with native byte order."
msgstr ""

#: ../../library/struct.rst:186
msgid ""
"Standard size depends only on the format character;  see the table in "
"the :ref:`format-characters` section."
msgstr ""

#: ../../library/struct.rst:189
msgid ""
"Note the difference between ``'@'`` and ``'='``: both use native byte order, "
"but the size and alignment of the latter is standardized."
msgstr ""

#: ../../library/struct.rst:192
msgid ""
"The form ``'!'`` represents the network byte order which is always big-"
"endian as defined in `IETF RFC 1700 <IETF RFC 1700_>`_."
msgstr ""

#: ../../library/struct.rst:195
msgid ""
"There is no way to indicate non-native byte order (force byte-swapping); use "
"the appropriate choice of ``'<'`` or ``'>'``."
msgstr ""

#: ../../library/struct.rst:198 ../../library/struct.rst:277
msgid "Notes:"
msgstr "註解："

#: ../../library/struct.rst:200
msgid ""
"Padding is only automatically added between successive structure members. No "
"padding is added at the beginning or the end of the encoded struct."
msgstr ""

#: ../../library/struct.rst:203
msgid ""
"No padding is added when using non-native size and alignment, e.g. with '<', "
"'>', '=', and '!'."
msgstr ""

#: ../../library/struct.rst:206
msgid ""
"To align the end of a structure to the alignment requirement of a particular "
"type, end the format with the code for that type with a repeat count of "
"zero.  See :ref:`struct-examples`."
msgstr ""

#: ../../library/struct.rst:214
msgid "Format Characters"
msgstr ""

#: ../../library/struct.rst:216
msgid ""
"Format characters have the following meaning; the conversion between C and "
"Python values should be obvious given their types.  The 'Standard size' "
"column refers to the size of the packed value in bytes when using standard "
"size; that is, when the format string starts with one of ``'<'``, ``'>'``, "
"``'!'`` or ``'='``.  When using native size, the size of the packed value is "
"platform-dependent."
msgstr ""

#: ../../library/struct.rst:224
msgid "Format"
msgstr ""

#: ../../library/struct.rst:224
msgid "C Type"
msgstr "C Type"

#: ../../library/struct.rst:224
msgid "Python type"
msgstr ""

#: ../../library/struct.rst:224
msgid "Standard size"
msgstr ""

#: ../../library/struct.rst:224
msgid "Notes"
msgstr "註解"

#: ../../library/struct.rst:226
msgid "``x``"
msgstr "``x``"

#: ../../library/struct.rst:226
msgid "pad byte"
msgstr ""

#: ../../library/struct.rst:226
msgid "no value"
msgstr ""

#: ../../library/struct.rst:226
msgid "\\(7)"
msgstr "\\(7)"

#: ../../library/struct.rst:228
msgid "``c``"
msgstr "``c``"

#: ../../library/struct.rst:228
msgid ":c:expr:`char`"
msgstr ":c:expr:`char`"

#: ../../library/struct.rst:228
msgid "bytes of length 1"
msgstr ""

#: ../../library/struct.rst:228 ../../library/struct.rst:230
#: ../../library/struct.rst:232 ../../library/struct.rst:234
msgid "1"
msgstr "1"

#: ../../library/struct.rst:230
msgid "``b``"
msgstr "``b``"

#: ../../library/struct.rst:230
msgid ":c:expr:`signed char`"
msgstr ":c:expr:`signed char`"

#: ../../library/struct.rst:230 ../../library/struct.rst:232
#: ../../library/struct.rst:236 ../../library/struct.rst:238
#: ../../library/struct.rst:240 ../../library/struct.rst:242
#: ../../library/struct.rst:244 ../../library/struct.rst:246
#: ../../library/struct.rst:248 ../../library/struct.rst:250
#: ../../library/struct.rst:253 ../../library/struct.rst:255
#: ../../library/struct.rst:267
msgid "integer"
msgstr ""

#: ../../library/struct.rst:230
msgid "\\(1), \\(2)"
msgstr "\\(1), \\(2)"

#: ../../library/struct.rst:232
msgid "``B``"
msgstr "``B``"

#: ../../library/struct.rst:232
msgid ":c:expr:`unsigned char`"
msgstr ":c:expr:`unsigned char`"

#: ../../library/struct.rst:232 ../../library/struct.rst:236
#: ../../library/struct.rst:238 ../../library/struct.rst:240
#: ../../library/struct.rst:242 ../../library/struct.rst:244
#: ../../library/struct.rst:246 ../../library/struct.rst:248
#: ../../library/struct.rst:250
msgid "\\(2)"
msgstr "\\(2)"

#: ../../library/struct.rst:234
msgid "``?``"
msgstr "``?``"

#: ../../library/struct.rst:234
msgid ":c:expr:`_Bool`"
msgstr ":c:expr:`_Bool`"

#: ../../library/struct.rst:234
msgid "bool"
msgstr "bool"

#: ../../library/struct.rst:234
msgid "\\(1)"
msgstr "\\(1)"

#: ../../library/struct.rst:236
msgid "``h``"
msgstr "``h``"

#: ../../library/struct.rst:236
msgid ":c:expr:`short`"
msgstr ":c:expr:`short`"

#: ../../library/struct.rst:236 ../../library/struct.rst:238
#: ../../library/struct.rst:257
msgid "2"
msgstr "2"

#: ../../library/struct.rst:238
msgid "``H``"
msgstr "``H``"

#: ../../library/struct.rst:238
msgid ":c:expr:`unsigned short`"
msgstr ":c:expr:`unsigned short`"

#: ../../library/struct.rst:240
msgid "``i``"
msgstr "``i``"

#: ../../library/struct.rst:240
msgid ":c:expr:`int`"
msgstr ":c:expr:`int`"

#: ../../library/struct.rst:240 ../../library/struct.rst:242
#: ../../library/struct.rst:244 ../../library/struct.rst:246
#: ../../library/struct.rst:259
msgid "4"
msgstr "4"

#: ../../library/struct.rst:242
msgid "``I``"
msgstr "``I``"

#: ../../library/struct.rst:242
msgid ":c:expr:`unsigned int`"
msgstr ":c:expr:`unsigned int`"

#: ../../library/struct.rst:244
msgid "``l``"
msgstr "``l``"

#: ../../library/struct.rst:244
msgid ":c:expr:`long`"
msgstr ":c:expr:`long`"

#: ../../library/struct.rst:246
msgid "``L``"
msgstr "``L``"

#: ../../library/struct.rst:246
msgid ":c:expr:`unsigned long`"
msgstr ":c:expr:`unsigned long`"

#: ../../library/struct.rst:248
msgid "``q``"
msgstr "``q``"

#: ../../library/struct.rst:248
msgid ":c:expr:`long long`"
msgstr ":c:expr:`long long`"

#: ../../library/struct.rst:248 ../../library/struct.rst:250
#: ../../library/struct.rst:261
msgid "8"
msgstr "8"

#: ../../library/struct.rst:250
msgid "``Q``"
msgstr "``Q``"

#: ../../library/struct.rst:250
msgid ":c:expr:`unsigned long long`"
msgstr ":c:expr:`unsigned long long`"

#: ../../library/struct.rst:253
msgid "``n``"
msgstr "``n``"

#: ../../library/struct.rst:253
msgid ":c:type:`ssize_t`"
msgstr ":c:type:`ssize_t`"

#: ../../library/struct.rst:253 ../../library/struct.rst:255
msgid "\\(3)"
msgstr "\\(3)"

#: ../../library/struct.rst:255
msgid "``N``"
msgstr "``N``"

#: ../../library/struct.rst:255
msgid ":c:type:`size_t`"
msgstr ":c:type:`size_t`"

#: ../../library/struct.rst:257
msgid "``e``"
msgstr "``e``"

#: ../../library/struct.rst:257
msgid "\\(6)"
msgstr "\\(6)"

#: ../../library/struct.rst:257 ../../library/struct.rst:259
#: ../../library/struct.rst:261
msgid "float"
msgstr "float"

#: ../../library/struct.rst:257 ../../library/struct.rst:259
#: ../../library/struct.rst:261
msgid "\\(4)"
msgstr "\\(4)"

#: ../../library/struct.rst:259
msgid "``f``"
msgstr "``f``"

#: ../../library/struct.rst:259
msgid ":c:expr:`float`"
msgstr ":c:expr:`float`"

#: ../../library/struct.rst:261
msgid "``d``"
msgstr "``d``"

#: ../../library/struct.rst:261
msgid ":c:expr:`double`"
msgstr ":c:expr:`double`"

#: ../../library/struct.rst:263
msgid "``s``"
msgstr "``s``"

#: ../../library/struct.rst:263 ../../library/struct.rst:265
msgid ":c:expr:`char[]`"
msgstr ":c:expr:`char[]`"

#: ../../library/struct.rst:263 ../../library/struct.rst:265
msgid "bytes"
msgstr ""

#: ../../library/struct.rst:263
msgid "\\(9)"
msgstr "\\(9)"

#: ../../library/struct.rst:265
msgid "``p``"
msgstr "``p``"

#: ../../library/struct.rst:265
msgid "\\(8)"
msgstr "\\(8)"

#: ../../library/struct.rst:267
msgid "``P``"
msgstr "``P``"

#: ../../library/struct.rst:267
msgid ":c:expr:`void \\*`"
msgstr ":c:expr:`void \\*`"

#: ../../library/struct.rst:267
msgid "\\(5)"
msgstr "\\(5)"

#: ../../library/struct.rst:270
msgid "Added support for the ``'n'`` and ``'N'`` formats."
msgstr "新增 ``'n'`` 與 ``'N'`` 格式的支援。"

#: ../../library/struct.rst:273
msgid "Added support for the ``'e'`` format."
msgstr "新增 ``'e'`` 格式的支援。"

#: ../../library/struct.rst:282
msgid ""
"The ``'?'`` conversion code corresponds to the :c:expr:`_Bool` type defined "
"by C standards since C99.  In standard mode, it is represented by one byte."
msgstr ""

#: ../../library/struct.rst:287
msgid ""
"When attempting to pack a non-integer using any of the integer conversion "
"codes, if the non-integer has a :meth:`~object.__index__` method then that "
"method is called to convert the argument to an integer before packing."
msgstr ""

#: ../../library/struct.rst:291
msgid "Added use of the :meth:`~object.__index__` method for non-integers."
msgstr "新增對非整數使用 :meth:`~object.__index__` 方法的支援。"

#: ../../library/struct.rst:295
msgid ""
"The ``'n'`` and ``'N'`` conversion codes are only available for the native "
"size (selected as the default or with the ``'@'`` byte order character). For "
"the standard size, you can use whichever of the other integer formats fits "
"your application."
msgstr ""

#: ../../library/struct.rst:301
msgid ""
"For the ``'f'``, ``'d'`` and ``'e'`` conversion codes, the packed "
"representation uses the IEEE 754 binary32, binary64 or binary16 format (for "
"``'f'``, ``'d'`` or ``'e'`` respectively), regardless of the floating-point "
"format used by the platform."
msgstr ""

#: ../../library/struct.rst:307
msgid ""
"The ``'P'`` format character is only available for the native byte ordering "
"(selected as the default or with the ``'@'`` byte order character). The byte "
"order character ``'='`` chooses to use little- or big-endian ordering based "
"on the host system. The struct module does not interpret this as native "
"ordering, so the ``'P'`` format is not available."
msgstr ""

#: ../../library/struct.rst:314
msgid ""
"The IEEE 754 binary16 \"half precision\" type was introduced in the 2008 "
"revision of the `IEEE 754 standard <ieee 754 standard_>`_. It has a sign "
"bit, a 5-bit exponent and 11-bit precision (with 10 bits explicitly stored), "
"and can represent numbers between approximately ``6.1e-05`` and ``6.5e+04`` "
"at full precision. This type is not widely supported by C compilers: on a "
"typical machine, an unsigned short can be used for storage, but not for math "
"operations. See the Wikipedia page on the `half-precision floating-point "
"format <half precision format_>`_ for more information."
msgstr ""

#: ../../library/struct.rst:324
msgid "When packing, ``'x'`` inserts one NUL byte."
msgstr ""

#: ../../library/struct.rst:327
msgid ""
"The ``'p'`` format character encodes a \"Pascal string\", meaning a short "
"variable-length string stored in a *fixed number of bytes*, given by the "
"count. The first byte stored is the length of the string, or 255, whichever "
"is smaller.  The bytes of the string follow.  If the string passed in "
"to :func:`pack` is too long (longer than the count minus 1), only the "
"leading ``count-1`` bytes of the string are stored.  If the string is "
"shorter than ``count-1``, it is padded with null bytes so that exactly count "
"bytes in all are used.  Note that for :func:`unpack`, the ``'p'`` format "
"character consumes ``count`` bytes, but that the string returned can never "
"contain more than 255 bytes."
msgstr ""

#: ../../library/struct.rst:339
msgid ""
"For the ``'s'`` format character, the count is interpreted as the length of "
"the bytes, not a repeat count like for the other format characters; for "
"example, ``'10s'`` means a single 10-byte string mapping to or from a single "
"Python byte string, while ``'10c'`` means 10 separate one byte character "
"elements (e.g., ``cccccccccc``) mapping to or from ten different Python byte "
"objects. (See :ref:`struct-examples` for a concrete demonstration of the "
"difference.) If a count is not given, it defaults to 1.  For packing, the "
"string is truncated or padded with null bytes as appropriate to make it fit. "
"For unpacking, the resulting bytes object always has exactly the specified "
"number of bytes.  As a special case, ``'0s'`` means a single, empty string "
"(while ``'0c'`` means 0 characters)."
msgstr ""

#: ../../library/struct.rst:352
msgid ""
"A format character may be preceded by an integral repeat count.  For "
"example, the format string ``'4h'`` means exactly the same as ``'hhhh'``."
msgstr ""

#: ../../library/struct.rst:355
msgid ""
"Whitespace characters between formats are ignored; a count and its format "
"must not contain whitespace though."
msgstr ""

#: ../../library/struct.rst:358
msgid ""
"When packing a value ``x`` using one of the integer formats (``'b'``, "
"``'B'``, ``'h'``, ``'H'``, ``'i'``, ``'I'``, ``'l'``, ``'L'``, ``'q'``, "
"``'Q'``), if ``x`` is outside the valid range for that format "
"then :exc:`struct.error` is raised."
msgstr ""

#: ../../library/struct.rst:363
msgid ""
"Previously, some of the integer formats wrapped out-of-range values and "
"raised :exc:`DeprecationWarning` instead of :exc:`struct.error`."
msgstr ""

#: ../../library/struct.rst:369
msgid ""
"For the ``'?'`` format character, the return value is either :const:`True` "
"or :const:`False`. When packing, the truth value of the argument object is "
"used. Either 0 or 1 in the native or standard bool representation will be "
"packed, and any non-zero value will be ``True`` when unpacking."
msgstr ""

#: ../../library/struct.rst:379
msgid "Examples"
msgstr "範例"

#: ../../library/struct.rst:382
msgid ""
"Native byte order examples (designated by the ``'@'`` format prefix or lack "
"of any prefix character) may not match what the reader's machine produces as "
"that depends on the platform and compiler."
msgstr ""

#: ../../library/struct.rst:387
msgid ""
"Pack and unpack integers of three different sizes, using big endian "
"ordering::"
msgstr ""

#: ../../library/struct.rst:390
msgid ""
">>> from struct import *\n"
">>> pack(\">bhl\", 1, 2, 3)\n"
"b'\\x01\\x00\\x02\\x00\\x00\\x00\\x03'\n"
">>> unpack('>bhl', b'\\x01\\x00\\x02\\x00\\x00\\x00\\x03')\n"
"(1, 2, 3)\n"
">>> calcsize('>bhl')\n"
"7"
msgstr ""
">>> from struct import *\n"
">>> pack(\">bhl\", 1, 2, 3)\n"
"b'\\x01\\x00\\x02\\x00\\x00\\x00\\x03'\n"
">>> unpack('>bhl', b'\\x01\\x00\\x02\\x00\\x00\\x00\\x03')\n"
"(1, 2, 3)\n"
">>> calcsize('>bhl')\n"
"7"

#: ../../library/struct.rst:398
msgid "Attempt to pack an integer which is too large for the defined field::"
msgstr ""

#: ../../library/struct.rst:400
msgid ""
">>> pack(\">h\", 99999)\n"
"Traceback (most recent call last):\n"
"  File \"<stdin>\", line 1, in <module>\n"
"struct.error: 'h' format requires -32768 <= number <= 32767"
msgstr ""
">>> pack(\">h\", 99999)\n"
"Traceback (most recent call last):\n"
"  File \"<stdin>\", line 1, in <module>\n"
"struct.error: 'h' format requires -32768 <= number <= 32767"

#: ../../library/struct.rst:405
msgid ""
"Demonstrate the difference between ``'s'`` and ``'c'`` format characters::"
msgstr ""

#: ../../library/struct.rst:408
msgid ""
">>> pack(\"@ccc\", b'1', b'2', b'3')\n"
"b'123'\n"
">>> pack(\"@3s\", b'123')\n"
"b'123'"
msgstr ""
">>> pack(\"@ccc\", b'1', b'2', b'3')\n"
"b'123'\n"
">>> pack(\"@3s\", b'123')\n"
"b'123'"

#: ../../library/struct.rst:413
msgid ""
"Unpacked fields can be named by assigning them to variables or by wrapping "
"the result in a named tuple::"
msgstr ""

#: ../../library/struct.rst:416
msgid ""
">>> record = b'raymond   \\x32\\x12\\x08\\x01\\x08'\n"
">>> name, serialnum, school, gradelevel = unpack('<10sHHb', record)\n"
"\n"
">>> from collections import namedtuple\n"
">>> Student = namedtuple('Student', 'name serialnum school gradelevel')\n"
">>> Student._make(unpack('<10sHHb', record))\n"
"Student(name=b'raymond   ', serialnum=4658, school=264, gradelevel=8)"
msgstr ""
">>> record = b'raymond   \\x32\\x12\\x08\\x01\\x08'\n"
">>> name, serialnum, school, gradelevel = unpack('<10sHHb', record)\n"
"\n"
">>> from collections import namedtuple\n"
">>> Student = namedtuple('Student', 'name serialnum school gradelevel')\n"
">>> Student._make(unpack('<10sHHb', record))\n"
"Student(name=b'raymond   ', serialnum=4658, school=264, gradelevel=8)"

#: ../../library/struct.rst:424
msgid ""
"The ordering of format characters may have an impact on size in native mode "
"since padding is implicit. In standard mode, the user is responsible for "
"inserting any desired padding. Note in the first ``pack`` call below that "
"three NUL bytes were added after the packed ``'#'`` to align the following "
"integer on a four-byte boundary. In this example, the output was produced on "
"a little endian machine::"
msgstr ""

#: ../../library/struct.rst:432
msgid ""
">>> pack('@ci', b'#', 0x12131415)\n"
"b'#\\x00\\x00\\x00\\x15\\x14\\x13\\x12'\n"
">>> pack('@ic', 0x12131415, b'#')\n"
"b'\\x15\\x14\\x13\\x12#'\n"
">>> calcsize('@ci')\n"
"8\n"
">>> calcsize('@ic')\n"
"5"
msgstr ""
">>> pack('@ci', b'#', 0x12131415)\n"
"b'#\\x00\\x00\\x00\\x15\\x14\\x13\\x12'\n"
">>> pack('@ic', 0x12131415, b'#')\n"
"b'\\x15\\x14\\x13\\x12#'\n"
">>> calcsize('@ci')\n"
"8\n"
">>> calcsize('@ic')\n"
"5"

#: ../../library/struct.rst:441
msgid ""
"The following format ``'llh0l'`` results in two pad bytes being added at the "
"end, assuming the platform's longs are aligned on 4-byte boundaries::"
msgstr ""

#: ../../library/struct.rst:444
msgid ""
">>> pack('@llh0l', 1, 2, 3)\n"
"b'\\x00\\x00\\x00\\x01\\x00\\x00\\x00\\x02\\x00\\x03\\x00\\x00'"
msgstr ""
">>> pack('@llh0l', 1, 2, 3)\n"
"b'\\x00\\x00\\x00\\x01\\x00\\x00\\x00\\x02\\x00\\x03\\x00\\x00'"

#: ../../library/struct.rst:450
msgid "Module :mod:`array`"
msgstr ":mod:`array` 模組"

#: ../../library/struct.rst:451
msgid "Packed binary storage of homogeneous data."
msgstr ""

#: ../../library/struct.rst:453
msgid "Module :mod:`json`"
msgstr ":mod:`json` 模組"

#: ../../library/struct.rst:454
msgid "JSON encoder and decoder."
msgstr ""

#: ../../library/struct.rst:456
msgid "Module :mod:`pickle`"
msgstr ":mod:`pickle` 模組"

#: ../../library/struct.rst:457
msgid "Python object serialization."
msgstr ""

#: ../../library/struct.rst:463
msgid "Applications"
msgstr ""

#: ../../library/struct.rst:465
msgid ""
"Two main applications for the :mod:`struct` module exist, data interchange "
"between Python and C code within an application or another application "
"compiled using the same compiler (:ref:`native formats<struct-native-"
"formats>`), and data interchange between applications using agreed upon data "
"layout (:ref:`standard formats<struct-standard-formats>`).  Generally "
"speaking, the format strings constructed for these two domains are distinct."
msgstr ""

#: ../../library/struct.rst:476
msgid "Native Formats"
msgstr ""

#: ../../library/struct.rst:478
msgid ""
"When constructing format strings which mimic native layouts, the compiler "
"and machine architecture determine byte ordering and padding. In such cases, "
"the ``@`` format character should be used to specify native byte ordering "
"and data sizes.  Internal pad bytes are normally inserted automatically.  It "
"is possible that a zero-repeat format code will be needed at the end of a "
"format string to round up to the correct byte boundary for proper alignment "
"of consecutive chunks of data."
msgstr ""

#: ../../library/struct.rst:486
msgid ""
"Consider these two simple examples (on a 64-bit, little-endian machine)::"
msgstr ""

#: ../../library/struct.rst:489
msgid ""
">>> calcsize('@lhl')\n"
"24\n"
">>> calcsize('@llh')\n"
"18"
msgstr ""
">>> calcsize('@lhl')\n"
"24\n"
">>> calcsize('@llh')\n"
"18"

#: ../../library/struct.rst:494
msgid ""
"Data is not padded to an 8-byte boundary at the end of the second format "
"string without the use of extra padding.  A zero-repeat format code solves "
"that problem::"
msgstr ""

#: ../../library/struct.rst:498
msgid ""
">>> calcsize('@llh0l')\n"
"24"
msgstr ""
">>> calcsize('@llh0l')\n"
"24"

#: ../../library/struct.rst:501
msgid ""
"The ``'x'`` format code can be used to specify the repeat, but for native "
"formats it is better to use a zero-repeat format like ``'0l'``."
msgstr ""

#: ../../library/struct.rst:504
msgid ""
"By default, native byte ordering and alignment is used, but it is better to "
"be explicit and use the ``'@'`` prefix character."
msgstr ""

#: ../../library/struct.rst:511
msgid "Standard Formats"
msgstr ""

#: ../../library/struct.rst:513
msgid ""
"When exchanging data beyond your process such as networking or storage, be "
"precise.  Specify the exact byte order, size, and alignment.  Do not assume "
"they match the native order of a particular machine. For example, network "
"byte order is big-endian, while many popular CPUs are little-endian.  By "
"defining this explicitly, the user need not care about the specifics of the "
"platform their code is running on. The first character should typically be "
"``<`` or ``>`` (or ``!``).  Padding is the responsibility of the "
"programmer.  The zero-repeat format character won't work.  Instead, the user "
"must explicitly add ``'x'`` pad bytes where needed.  Revisiting the examples "
"from the previous section, we have::"
msgstr ""

#: ../../library/struct.rst:525
msgid ""
">>> calcsize('<qh6xq')\n"
"24\n"
">>> pack('<qh6xq', 1, 2, 3) == pack('@lhl', 1, 2, 3)\n"
"True\n"
">>> calcsize('@llh')\n"
"18\n"
">>> pack('@llh', 1, 2, 3) == pack('<qqh', 1, 2, 3)\n"
"True\n"
">>> calcsize('<qqh6x')\n"
"24\n"
">>> calcsize('@llh0l')\n"
"24\n"
">>> pack('@llh0l', 1, 2, 3) == pack('<qqh6x', 1, 2, 3)\n"
"True"
msgstr ""
">>> calcsize('<qh6xq')\n"
"24\n"
">>> pack('<qh6xq', 1, 2, 3) == pack('@lhl', 1, 2, 3)\n"
"True\n"
">>> calcsize('@llh')\n"
"18\n"
">>> pack('@llh', 1, 2, 3) == pack('<qqh', 1, 2, 3)\n"
"True\n"
">>> calcsize('<qqh6x')\n"
"24\n"
">>> calcsize('@llh0l')\n"
"24\n"
">>> pack('@llh0l', 1, 2, 3) == pack('<qqh6x', 1, 2, 3)\n"
"True"

#: ../../library/struct.rst:540
msgid ""
"The above results (executed on a 64-bit machine) aren't guaranteed to match "
"when executed on different machines.  For example, the examples below were "
"executed on a 32-bit machine::"
msgstr ""

#: ../../library/struct.rst:544
msgid ""
">>> calcsize('<qqh6x')\n"
"24\n"
">>> calcsize('@llh0l')\n"
"12\n"
">>> pack('@llh0l', 1, 2, 3) == pack('<qqh6x', 1, 2, 3)\n"
"False"
msgstr ""
">>> calcsize('<qqh6x')\n"
"24\n"
">>> calcsize('@llh0l')\n"
"12\n"
">>> pack('@llh0l', 1, 2, 3) == pack('<qqh6x', 1, 2, 3)\n"
"False"

#: ../../library/struct.rst:555
msgid "Classes"
msgstr "類別"

#: ../../library/struct.rst:557
msgid "The :mod:`struct` module also defines the following type:"
msgstr ":mod:`struct` 模組也定義了以下型別："

#: ../../library/struct.rst:562
msgid ""
"Return a new Struct object which writes and reads binary data according to "
"the format string *format*.  Creating a ``Struct`` object once and calling "
"its methods is more efficient than calling module-level functions with the "
"same format since the format string is only compiled once."
msgstr ""

#: ../../library/struct.rst:569
msgid ""
"The compiled versions of the most recent format strings passed to the module-"
"level functions are cached, so programs that use only a few format strings "
"needn't worry about reusing a single :class:`Struct` instance."
msgstr ""

#: ../../library/struct.rst:574
msgid "Compiled Struct objects support the following methods and attributes:"
msgstr ""

#: ../../library/struct.rst:578
msgid ""
"Identical to the :func:`pack` function, using the compiled format. "
"(``len(result)`` will equal :attr:`size`.)"
msgstr ""

#: ../../library/struct.rst:584
msgid "Identical to the :func:`pack_into` function, using the compiled format."
msgstr ""

#: ../../library/struct.rst:589
msgid ""
"Identical to the :func:`unpack` function, using the compiled format. The "
"buffer's size in bytes must equal :attr:`size`."
msgstr ""

#: ../../library/struct.rst:595
msgid ""
"Identical to the :func:`unpack_from` function, using the compiled format. "
"The buffer's size in bytes, starting at position *offset*, must be at "
"least :attr:`size`."
msgstr ""

#: ../../library/struct.rst:602
msgid ""
"Identical to the :func:`iter_unpack` function, using the compiled format. "
"The buffer's size in bytes must be a multiple of :attr:`size`."
msgstr ""

#: ../../library/struct.rst:609
msgid "The format string used to construct this Struct object."
msgstr ""

#: ../../library/struct.rst:611
msgid "The format string type is now :class:`str` instead of :class:`bytes`."
msgstr ""

#: ../../library/struct.rst:616
msgid ""
"The calculated size of the struct (and hence of the bytes object produced by "
"the :meth:`pack` method) corresponding to :attr:`format`."
msgstr ""

#: ../../library/struct.rst:619
msgid "The *repr()* of structs has changed.  It is now:"
msgstr ""

#: ../../library/struct.rst:13
msgid "C"
msgstr "C"

#: ../../library/struct.rst:13
msgid "structures"
msgstr "structures（結構）"

#: ../../library/struct.rst:13
msgid "packing"
msgstr "packing（打包）"

#: ../../library/struct.rst:13
msgid "binary"
msgstr "binary（二進位）"

#: ../../library/struct.rst:13
msgid "data"
msgstr "data（資料）"

#: ../../library/struct.rst:136
msgid "@ (at)"
msgstr "@ （在）"

#: ../../library/struct.rst:136 ../../library/struct.rst:280
#: ../../library/struct.rst:367
msgid "in struct format strings"
msgstr "於 struct format strings（結構格式字串）"

#: ../../library/struct.rst:136
msgid "= (equals)"
msgstr "= （等號）"

#: ../../library/struct.rst:136
msgid "< (less)"
msgstr "< （小於）"

#: ../../library/struct.rst:136
msgid "> (greater)"
msgstr "> （大於）"

#: ../../library/struct.rst:136
msgid "! (exclamation)"
msgstr "! （驚嘆號）"

#: ../../library/struct.rst:280 ../../library/struct.rst:367
msgid "? (question mark)"
msgstr "? （問號）"