Complete struct.po translation - 100% translated!

Copilot · mattwang44 · Copilot · commit 18f2cbc723dd · 2025-07-14T08:13:19.000Z
Co-authored-by: mattwang44 &lt;24987826+mattwang44@users.noreply.github.com&gt;
diff --git a/library/struct.po b/library/struct.po
@@ -754,9 +754,9 @@ msgstr ""
 "``'p'`` 格式字元編碼一個「Pascal 字串」，意思是儲存在 *固定位元組數* 中的短變長\\"
 "字串，由計數指定。儲存的第一個位元組是字串的長度，或 255，取較小者。字串的位元組\\"
 "在其後。如果傳遞給\\ :func:`pack` 的字串太長（長於計數減 1），則只儲存字串的前 \\"
-"``count-1`` 個位元組。如果字串短於 ``count-1``，則用空位元組填充，使得總共使用\\"
-"恰好 count 個位元組。請注意，對於\\ :func:`unpack`，``'p'`` 格式字元消耗 ``count`` \\"
-"個位元組，但回傳的字串永遠不能包含超過 255 個位元組。"
+"``count-1`` 個位元組。如果字串短於 ``count-1``\ ，則用空位元組填充，使得總共使用\\"
+"恰好 count 個位元組。請注意，對於\\ :func:`unpack`，\\ ``'p'`` 格式字元消耗 \\"
+"``count`` 個位元組，但回傳的字串永遠不能包含超過 255 個位元組。"
 
 #: ../../library/struct.rst:339
 msgid ""
@@ -772,18 +772,28 @@ msgid ""
 "number of bytes.  As a special case, ``'0s'`` means a single, empty string "
 "(while ``'0c'`` means 0 characters)."
 msgstr ""
+"對於 ``'s'`` 格式字元，計數被解釋為位元組的長度，而不是像其他格式字元那樣的重複\\"
+"次數；例如，``'10s'`` 表示一個 10 位元組字串，對應於單一 Python 位元組字串，\\"
+"而 ``'10c'`` 表示 10 個獨立的單位元組字元元素（例如，\\ ``cccccccccc``\ ），對應於\\"
+"十個不同的 Python 位元組物件。（請參見\\ :ref:`struct-examples` 以了解具體差異\\"
+"的示範。）如果未給定計數，則預設為 1。打包時，會適當地截斷或用空位元組填充字串\\"
+"以使其適合。解包時，結果位元組物件總是恰好具有指定的位元組數。作為特殊情況，\\"
+"``'0s'`` 表示單一空字串（而 ``'0c'`` 表示 0 個字元）。"
 
 #: ../../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 ""
+"格式字元前面可以加上整數重複次數。例如，格式字串 ``'4h'`` 與 ``'hhhh'`` \\"
+"意思完全相同。"
 
 #: ../../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 ""
@@ -792,12 +802,17 @@ msgid ""
 "``'Q'``), if ``x`` is outside the valid range for that format "
 "then :exc:`struct.error` is raised."
 msgstr ""
+"當使用整數格式之一（``'b'``、``'B'``、``'h'``、``'H'``、``'i'``、``'I'``、\\"
+"``'l'``、``'L'``、``'q'``、``'Q'``）打包數值 ``x`` 時，如果 ``x`` 超出該\\"
+"格式的有效範圍，則會觸發\\ :exc:`struct.error`。"
 
 #: ../../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 ""
+"以前，一些整數格式會環繞超出範圍的數值並觸發\\ :exc:`DeprecationWarning` \\"
+"而不是\\ :exc:`struct.error`。"
 
 #: ../../library/struct.rst:369
 msgid ""
@@ -806,6 +821,9 @@ msgid ""
 "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 ""
+"對於 ``'?'`` 格式字元，回傳值是\\ :const:`True` 或\\ :const:`False`。打包時，\\"
+"使用引數物件的真值。原生或標準布林值表示法中的 0 或 1 將被打包，解包時任何\\"
+"非零值都將為 ``True``。"
 
 #: ../../library/struct.rst:379
 msgid "Examples"
@@ -817,12 +835,15 @@ msgid ""
 "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 ""
@@ -844,7 +865,7 @@ msgstr ""
 
 #: ../../library/struct.rst:398
 msgid "Attempt to pack an integer which is too large for the defined field::"
-msgstr ""
+msgstr "嘗試打包對於定義欄位來說太大的整數： ::"
 
 #: ../../library/struct.rst:400
 msgid ""
@@ -861,7 +882,7 @@ msgstr ""
 #: ../../library/struct.rst:405
 msgid ""
 "Demonstrate the difference between ``'s'`` and ``'c'`` format characters::"
-msgstr ""
+msgstr "示範 ``'s'`` 和 ``'c'`` 格式字元之間的差異： ::"
 
 #: ../../library/struct.rst:408
 msgid ""
@@ -880,6 +901,7 @@ 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 ""
@@ -908,6 +930,10 @@ msgid ""
 "integer on a four-byte boundary. In this example, the output was produced on "
 "a little endian machine::"
 msgstr ""
+"在原生模式下，格式字元的順序可能會影響大小，因為填充是隱式的。在標準模式下，\\"
+"使用者負責插入任何所需的填充。請注意下面第一個 ``pack`` 呼叫中，在打包的 ``'#'`` \\"
+"之後加入了三個 NUL 位元組，以將後續整數對齊到四位元組邊界。在此範例中，輸出是在\\"
+"小端序機器上產生的： ::"
 
 #: ../../library/struct.rst:432
 msgid ""
@@ -934,6 +960,8 @@ 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 ""
+"假設平台的 long 對齊到 4 位元組邊界，以下格式 ``'llh0l'`` 會在結尾加入兩個\\"
+"填充位元組： ::"
 
 #: ../../library/struct.rst:444
 msgid ""
@@ -949,27 +977,27 @@ msgstr ":mod:`array` 模組"
 
 #: ../../library/struct.rst:451
 msgid "Packed binary storage of homogeneous data."
-msgstr ""
+msgstr "同質資料的打包二進位儲存。"
 
 #: ../../library/struct.rst:453
 msgid "Module :mod:`json`"
 msgstr ":mod:`json` 模組"
 
 #: ../../library/struct.rst:454
 msgid "JSON encoder and decoder."
-msgstr ""
+msgstr "JSON 編碼器和解碼器。"
 
 #: ../../library/struct.rst:456
 msgid "Module :mod:`pickle`"
 msgstr ":mod:`pickle` 模組"
 
 #: ../../library/struct.rst:457
 msgid "Python object serialization."
-msgstr ""
+msgstr "Python 物件序列化。"
 
 #: ../../library/struct.rst:463
 msgid "Applications"
-msgstr ""
+msgstr "應用"
 
 #: ../../library/struct.rst:465
 msgid ""
@@ -980,10 +1008,14 @@ msgid ""
 "layout (:ref:`standard formats<struct-standard-formats>`).  Generally "
 "speaking, the format strings constructed for these two domains are distinct."
 msgstr ""
+":mod:`struct` 模組有兩個主要應用：在應用程式內或使用相同編譯器編譯的另一個應用\\"
+"程式之間進行 Python 和 C 程式碼的資料交換（\\ :ref:`原生格式<struct-native-formats>`），\\"
+"以及使用約定資料配置的應用程式之間的資料交換（\\ :ref:`標準格式<struct-standard-formats>`）。\\"
+"一般來說，為這兩個領域構造的格式字串是不同的。"
 
 #: ../../library/struct.rst:476
 msgid "Native Formats"
-msgstr ""
+msgstr "原生格式"
 
 #: ../../library/struct.rst:478
 msgid ""
@@ -995,11 +1027,15 @@ msgid ""
 "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 ""
+msgstr "考慮這兩個簡單範例（在 64 位元小端序機器上）： ::"
 
 #: ../../library/struct.rst:489
 msgid ""
@@ -1019,6 +1055,8 @@ msgid ""
 "string without the use of extra padding.  A zero-repeat format code solves "
 "that problem::"
 msgstr ""
+"在第二個格式字串的結尾，如果不使用額外填充，資料不會填充到 8 位元組邊界。\\"
+"零重複格式代碼解決了這個問題： ::"
 
 #: ../../library/struct.rst:498
 msgid ""
@@ -1033,16 +1071,19 @@ 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 ""
+"``'x'`` 格式代碼可以用來指定重複，但對於原生格式，最好使用像 ``'0l'`` 這樣的\\"
+"零重複格式。"
 
 #: ../../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 ""
+msgstr "標準格式"
 
 #: ../../library/struct.rst:513
 msgid ""
@@ -1057,6 +1098,12 @@ msgid ""
 "must explicitly add ``'x'`` pad bytes where needed.  Revisiting the examples "
 "from the previous section, we have::"
 msgstr ""
+"當與您的程序之外的網路或儲存等交換資料時，要精確。指定確切的位元組順序、大小\\"
+"和對齊。不要假設它們與特定機器的原生順序匹配。例如，網路位元組順序是大端序，\\"
+"而許多流行的 CPU 是小端序。透過明確定義這一點，使用者無需關心其程式碼運行的\\"
+"平台細節。第一個字元通常應該是 ``<`` 或 ``>``\ （或 ``!``\ ）。填充是程式設計師\\"
+"的責任。零重複格式字元不會起作用。相反，使用者必須在需要的地方明確加入 ``'x'`` \\"
+"填充位元組。重新檢視上一節的範例，我們有： ::"
 
 #: ../../library/struct.rst:525
 msgid ""
@@ -1096,6 +1143,8 @@ msgid ""
 "when executed on different machines.  For example, the examples below were "
 "executed on a 32-bit machine::"
 msgstr ""
+"上述結果（在 64 位元機器上執行）在不同機器上執行時不保證匹配。例如，下面的\\"
+"範例是在 32 位元機器上執行的： ::"
 
 #: ../../library/struct.rst:544
 msgid ""
@@ -1128,64 +1177,77 @@ msgid ""
 "its methods is more efficient than calling module-level functions with the "
 "same format since the format string is only compiled once."
 msgstr ""
+"回傳一個新的 Struct 物件，它根據格式字串 *format* 寫入和讀取二進位資料。\\"
+"建立一次 ``Struct`` 物件並呼叫其方法比使用相同格式呼叫模組層級函式更有效率，\\"
+"因為格式字串只編譯一次。"
 
 #: ../../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 ""
+"傳遞給模組層級函式的最近格式字串的編譯版本會被快取，因此僅使用少數格式字串的\\"
+"程式無需擔心重複使用單一\\ :class:`Struct` 實例。"
 
 #: ../../library/struct.rst:574
 msgid "Compiled Struct objects support the following methods and attributes:"
-msgstr ""
+msgstr "編譯的 Struct 物件支援以下方法和屬性："
 
 #: ../../library/struct.rst:578
 msgid ""
 "Identical to the :func:`pack` function, using the compiled format. "
 "(``len(result)`` will equal :attr:`size`.)"
 msgstr ""
+"與\\ :func:`pack` 函式相同，使用編譯的格式。（``len(result)`` 將等於\\ :attr:`size`。）"
 
 #: ../../library/struct.rst:584
 msgid "Identical to the :func:`pack_into` function, using the compiled format."
-msgstr ""
+msgstr "與\\ :func:`pack_into` 函式相同，使用編譯的格式。"
 
 #: ../../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 ""
+"與\\ :func:`unpack` 函式相同，使用編譯的格式。緩衝區的位元組大小必須等於\\ :attr:`size`。"
 
 #: ../../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 ""
+"與\\ :func:`unpack_from` 函式相同，使用編譯的格式。緩衝區從位置 *offset* \\"
+"開始的位元組大小必須至少為\\ :attr:`size`。"
 
 #: ../../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 ""
+"與\\ :func:`iter_unpack` 函式相同，使用編譯的格式。緩衝區的位元組大小必須是\\ :attr:`size` \\"
+"的倍數。"
 
 #: ../../library/struct.rst:609
 msgid "The format string used to construct this Struct object."
-msgstr ""
+msgstr "用於構造此 Struct 物件的格式字串。"
 
 #: ../../library/struct.rst:611
 msgid "The format string type is now :class:`str` instead of :class:`bytes`."
-msgstr ""
+msgstr "格式字串型別現在是\\ :class:`str` 而不是\\ :class:`bytes`。"
 
 #: ../../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 ""
+"對應於\\ :attr:`format` 的結構的計算大小（因此也是\\ :meth:`pack` 方法所產生的\\"
+"bytes 物件的大小）。"
 
 #: ../../library/struct.rst:619
 msgid "The *repr()* of structs has changed.  It is now:"
-msgstr ""
+msgstr "結構的 *repr()* 已經改變。現在是："
 
 #: ../../library/struct.rst:13
 msgid "C"
