8000 fix: Inline literal start-string without end-string. (#857) · python/python-docs-zh-tw@c79e8b2 · GitHub
[go: up one dir, main page]
Skip to content

Commit c79e8b2

Browse files
ken71301mattwang44
ken71301
and
mattwang44
authored
fix: Inline literal start-string without end-string. (#857)
feat: to rst:264 Update library/weakref.po Apply suggestions from code review Apply suggestions from code review fix: Apply suggestions from code review Apply suggestions from code review Co-authored-by: Wei-Hsiang (Matt) Wang <mattwang44@gmail.com>
1 parent d316665 commit c79e8b2

File tree

1 file changed

+96
-16
lines changed

1 file changed

+96
-16
lines changed

‎library/weakref.po

Lines changed: 96 additions & 16 deletions
#: ../../library/weakref.rst:126
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,8 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.12\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2024-04-18 00:04+0000\n"
11-
"PO-Revision-Date: 2018-05-23 16:15+0000\n"
10+
"POT-Creation-Date: 2023-10-11 17:13+0000\n"
11+
"PO-Revision-Date: 2024-05-08 22:24+0800\n"
1212
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
1414
"tw)\n"
@@ -17,10 +17,11 @@ msgstr ""
1717
"Content-Type: text/plain; charset=UTF-8\n"
1818
"Content-Transfer-Encoding: 8bit\n"
1919
"Plural-Forms: nplurals=1; plural=0;\n"
20+
"X-Generator: Poedit 3.4.1\n"
2021

2122
#: ../../library/weakref.rst:4
2223
msgid ":mod:`weakref` --- Weak references"
23-
msgstr ""
24+
msgstr ":mod:`weakref` --- 弱參照"
2425

2526
#: ../../library/weakref.rst:14
2627
msgid "**Source code:** :source:`Lib/weakref.py`"
@@ -30,13 +31,14 @@ msgstr "**原始碼：**\\ :source:`Lib/weakref.py`"
3031
msgid ""
3132
"The :mod:`weakref` module allows the Python programmer to create :dfn:`weak "
3233
"references` to objects."
33-
msgstr ""
34+
msgstr ":mod:`weakref` 模組允許 Python 程式設計師建立對物件的 :dfn:`弱參照`。"
3435

3536
#: ../../library/weakref.rst:24
3637
msgid ""
3738
"In the following, the term :dfn:`referent` means the object which is "
3839
"referred to by a weak reference."
3940
msgstr ""
41+
"在以下文章中，術語 :dfn:`參照目標 (referent)` 表示被弱參照所參考的物件。"
4042

4143
#: ../../library/weakref.rst:27
4244
msgid ""
@@ -47,13 +49,19 @@ msgid ""
4749
"weak reference may return the object even if there are no strong references "
4850
"to it."
4951
msgstr ""
52+
"對物件的弱參照不足以使物件保持存在：當對參照目標的唯一剩下的參照是弱參照時，:"
53+
"term:`garbage collection` 可以自由地銷毀參照目標並將其記憶體重新用於其他用"
54+
"途。然而，在物件被確實銷毀之前，即使沒有對該物件的強參照 (strong reference)，"
55+
"弱參照也可能會回傳該物件。"
5056

5157
#: ../../library/weakref.rst:33
5258
msgid ""
5359
"A primary use for weak references is to implement caches or mappings holding "
5460
"large objects, where it's desired that a large object not be kept alive "
5561
"solely because it appears in a cache or mapping."
5662
msgstr ""
63+
"弱參照的主要用途是實作保存大型物件的快取或對映，其不希望大型物件僅僅因為它出"
64+
"現在快取或對映中而保持存在。"
5765

5866
#: ../../library/weakref.rst:37
5967
msgid ""
@@ -70,6 +78,15 @@ msgid ""
7078
"collection can reclaim the object, and its corresponding entries in weak "
7179
"mappings are simply deleted."
7280
msgstr ""
81+
"例如，如果你有許多大型的二進位影像物件，你可能會想要為每個物件關聯 "
82+
"(associate) 一個名稱。如果你使用 Python 字典將名稱對映到影像，或將影像對映到"
83+
"名稱，則影像物件將保持存活，僅因為它們在字典中作為值 (value) 或鍵 (key) 出"
84+
"現。:mod:`weakref` 模組提供的 :class:`WeakKeyDictionary` 和 :class:"
85+
"`WeakValueDictionary` 類別是另一種選擇，它們使用弱參照來建構對映，這些對映不"
86+
"會僅因為物件出現在對映物件中而使物件保持存活。例如，如果一個影像物件是 :"
87+
"class:`WeakValueDictionary` 中的一個值，那麼當對該影像物件最後的參照是弱對映 "
88+
"(weak mapping) 所持有的弱參照時，垃圾回收 (garbage collection) 可以回收該物"
89+
"件，且其對應的條目在弱對映中會被完全地刪除。"
7390

7491
#: ../../library/weakref.rst:50
7592
msgid ""
@@ -80,6 +97,10 @@ msgid ""
8097
"class:`set` interface, but keeps weak references to its elements, just like "
8198
"a :class:`WeakKeyDictionary` does."
8299
msgstr ""
100+
":class:`WeakKeyDictionary` 和 :class:`WeakValueDictionary` 在其實作中使用弱參"
101+
"照，在弱參照上設定回呼函式，此弱參照在垃圾回收取回鍵或值時通知弱字典。:class:"
102+
"`WeakSet` 實作了 :class:`set` 介面，但保留對其元素的弱參照，就像 :class:"
103+
"`WeakKeyDictionary` 一樣。"
83104

84105
#: ../../library/weakref.rst:57
85106
msgid ""
@@ -89,6 +110,9 @@ msgid ""
89110
"the module automatically ensures that the finalizer remains alive until the "
90111
"object is collected."
91112
msgstr ""
113+
":class:`finalize` 提供了一種直接的方法來註冊在物件被垃圾回收時呼叫的清理函"
114+
"式。這比在原始弱參照上設定回呼函式更容易使用，因為模組在物件被收集前會自動確"
115+
"保終結函式 (finalizer) 保持存活。"
92116

93117
#: ../../library/weakref.rst:63
94118
msgid ""
@@ -97,6 +121,9 @@ msgid ""
97121
"your own weak references directly. The low-level machinery is exposed by "
98122
"the :mod:`weakref` module for the benefit of advanced uses."
99123
msgstr ""
124+
"大多數程式應該發現使用這些弱容器種類之一或 :class:`finalize` 就足夠了—通常不"
125+
"需要直接建立自己的弱參照。低層級的機制由 :mod:`weakref` 模組公開，以利於進階"
126+
"用途。"
100127

101128
#: ../../library/weakref.rst:68
102129
msgid ""
@@ -106,28 +133,38 @@ msgid ""
106133
"object>`, :term:`generators <generator>`, type objects, sockets, arrays, "
107134
"deques, regular expression pattern objects, and code objects."
108135
msgstr ""
136+
"並非所有物件都可以被弱參照。支援弱參照的物件包括類別實例、用 Python （但不是"
137+
"C）編寫的函式、實例方法、集合、凍結集合 (frozenset)、一些\\ :term:`檔案物件 "
138+
"<file object>`、:term:`產生器 <generator>`、類型物件、socket、陣列、雙向佇"
139+
"列、正規表示式模式物件和程式碼物件。"
109140

110141
#: ../../library/weakref.rst:74
111142
msgid "Added support for thread.lock, threading.Lock, and code objects."
112-
msgstr ""
143+
msgstr "新增了對 thread.lock、threading.Lock 和程式碼物件的支援。"
113144

114145
#: ../../library/weakref.rst:77
115146
msgid ""
116147
"Several built-in types such as :class:`list` and :class:`dict` do not "
117148
"directly support weak references but can add support through subclassing::"
118149
msgstr ""
150+
"一些內建型別，例如 :class:`list` 和 :class:`dict` 不直接支援弱參照，但可以透"
151+
"過子類別化來支援： ::"
119152

120153
#: ../../library/weakref.rst:87
121154
msgid ""
122155
"Other built-in types such as :class:`tuple` and :class:`int` do not support "
123156
"weak references even when subclassed."
124157
msgstr ""
158+
"其他內建型別，例如 :class:`tuple` 和 :class:`int` 即使在子類別化時也不支援弱"
159+
"參照。"
125160

126161
#: ../../library/weakref.rst:90
127162
msgid ""
128163
"Extension types can easily be made to support weak references; see :ref:"
129164
"`weakref-support`."
130165
msgstr ""
166+
"擴充型別 (extension type) 可以輕易地支援弱參照；請參閱 :ref:`weakref-"
167+
"support`。"
131168

132169
#: ../../library/weakref.rst:93
133170
msgid ""
@@ -136,6 +173,9 @@ msgid ""
136173
"of strings in the ``__slots__`` declaration. See :ref:`__slots__ "
137174
"documentation <slots>` for details."
138175
msgstr ""
176+
"當為給定的型別定義 ``__slots__`` 時，弱參照支援將被停用，除非 "
177+
"``'__weakref__'`` 字串也存在於 ``__slots__`` 宣告的字串序列中。詳情請參閱 :"
178+
"ref:`__slots__ 文件 <slots>`。"
139179

140180
#: ../../library/weakref.rst:100
141181
msgid ""
@@ -148,20 +188,29 @@ msgid ""
148188
"passed as the only parameter to the callback; the referent will no longer be "
149189
"available."
150190
msgstr ""
191+
"傳回對 *object* 的弱參照。如果參照目標仍存活，則可以透過呼叫參照物件來取回原"
192+
"始物件；如果參照目標已不存活，呼叫參照物件將導致 :const:`None` 被回傳。如果 "
193+
"*callback* 被提供而非 :const:`None`，且回傳的弱參照物件仍存活，那麼當物件即將"
194 F987 +
"被終結 (finalize) 時，回呼將被呼叫；弱參照物件將作為唯一的參數傳遞給回呼；參"
195+
"照物件將不再可用。"
151196

152197
#: ../../library/weakref.rst:108
153198
msgid ""
154199
"It is allowable for many weak references to be constructed for the same "
155200
"object. Callbacks registered for each weak reference will be called from the "
156201
"most recently registered callback to the oldest registered callback."
157202
msgstr ""
203+
"為同一個物件建構多個弱參照是可行的。為每個弱參照註冊的回呼將按照最新到最舊註"
204+
"冊的回呼順序來被呼叫。"
158205

159206
#: ../../library/weakref.rst:112
160207
msgid ""
161208
"Exceptions raised by the callback will be noted on the standard error "
162209
"output, but cannot be propagated; they are handled in exactly the same way "
163210
"as exceptions raised from an object's :meth:`~object.__del__` method."
164211
msgstr ""
212+
"回呼引發的例外將在標準錯誤輸出中被註明，但無法被傳播；它們的處理方式與物件"
213+
"的 :meth:`~object.__del__` 方法引發的例外完全相同。"
165214

166215
#: ../../library/weakref.rst:116
167216
msgid ""
@@ -170,6 +219,9 @@ msgid ""
170219
"`hash` is called the first time only after the *object* was deleted, the "
171220
"call will raise :exc:`TypeError`."
172221
msgstr ""
222+
"如果 *object* 是\\ :term:`可雜湊的 <hashable>`，那麼弱參照就是可雜湊的。即使"
223+
"在 *object* 被刪除後，它們仍將保留其雜湊值。如果僅在 *object* 刪除後才第一次"
224+
"呼叫 :func:`hash`，則該呼叫將引發 :exc:`TypeError`。"
173225

174226
#: ../../library/weakref.rst:121
175227
msgid ""
@@ -179,17 +231,22 @@ msgid ""
179231
"referent has been deleted, the references are equal only if the reference "
180232
"objects are the same object."
181233
msgstr ""
234+
"弱參照支援相等性的測試，但不支援排序。如果參照目標仍存活，則兩個參照與其參照"
235+
"目標具有相同的相等關係（無論 *callback* 如何）。如果任一參照目標已被刪除，則"
236+
"僅當參照物件是同一物件時，參照才相等。"
182237

183238
184239
msgid "This is a subclassable type rather than a factory function."
185-
msgstr ""
240+
msgstr "這是一個可子類別化的型別，而不是一個工廠函式。"
186241

187242
#: ../../library/weakref.rst:130
188243
msgid ""
189244
"This read-only attribute returns the callback currently associated to the "
190245
"weakref. If there is no callback or if the referent of the weakref is no "
191246
"longer alive then this attribute will have value ``None``."
192247
msgstr ""
248+
"此唯讀屬性回傳目前與弱參照關聯的回呼。如果沒有回呼或弱參照的參照目標已不存"
249+
"活，那麼該屬性的值為 ``None``。"
193250

194251
#: ../../library/weakref.rst:134
195252
msgid "Added the :attr:`__callback__` attribute."
@@ -207,29 +264,35 @@ msgid ""
207264
"keys. *callback* is the same as the parameter of the same name to the :func:"
208265
"`ref` function."
209266
msgstr ""
267+
"傳回一個使用弱參照的 *object* 的代理 (proxy)。這支援在大多數情境中使用代理，"
268+
"而不需要對弱參照物件明確地取消參照。回傳的物件將具有 ``ProxyType`` 或 "
269+
"``CallableProxyType`` 型別，具體取決於 *object* 是否為可呼叫物件。無論參照目"
270+
"標如何，代理物件都不是 :term:`hashable`；這避免了與其基本可變物件本質相關的許"
271+
"多問題，並阻止它們作為字典的鍵被使用。*callback* 與 :func:`ref` 函式的同名參"
272+
"數是相同的。"
210273

211274
#: ../../library/weakref.rst:149
212275
msgid ""
213276
"Accessing an attribute of the proxy object after the referent is garbage "
214277
"collected raises :exc:`ReferenceError`."
215-
msgstr ""
278+
msgstr "在參照目標被垃圾回收後存取代理物件的屬性會引發 :exc:`ReferenceError`。"
216279

217280
#: ../../library/weakref.rst:152
218281
msgid ""
219282
"Extended the operator support on proxy objects to include the matrix "
220283
"multiplication operators ``@`` and ``@=``."
221-
msgstr ""
284+
msgstr "提供對代理物件的運算子支援，以包括矩陣乘法運算子 ``@`` 和 ``@=``。"
222285

223286
#: ../../library/weakref.rst:159
224287
msgid ""
225288
"Return the number of weak references and proxies which refer to *object*."
226-
msgstr ""
289+
msgstr "回傳參照 *object* 的弱參照和代理的數量。"
227290

228291
#: ../../library/weakref.rst:164
229292
msgid ""
230293
"Return a list of all weak reference and proxy objects which refer to "
231294
"*object*."
232-
msgstr ""
295+
msgstr "回傳參照 *object* 的所有弱參照和代理物件的一個串列。"
233296

234297
#: ../../library/weakref.rst:169
235298
msgid ""
@@ -239,6 +302,9 @@ msgid ""
239302
"of an application without adding attributes to those objects. This can be "
240303
"especially useful with objects that override attribute accesses."
241304
msgstr ""
305+
"弱參照鍵的對映類別。當不再有對鍵的強參照時，字典中的條目將被丟棄。這可用於將"
306+
"附加資料與應用程式其他部分擁有的物件相關聯，而無需向這些物件新增屬性。這對於"
307+
"覆蓋屬性存取的物件特別有用。"
242308

243309
#: ../../library/weakref.rst:175
244310
msgid ""
@@ -247,10 +313,13 @@ msgid ""
247313
"not replace the existing key. Due to this, when the reference to the "
248314
"original key is deleted, it also deletes the entry in the dictionary::"
249315
msgstr ""
316+
"請注意，當將與現有鍵具有相同值的鍵（但識別性不相等）插入字典時，它會替換該"
317+
"值，但不會替換現有鍵。因此，當刪除對原始鍵的參照時，它也會刪除字典中的條"
318+
"目： ::"
250319

251320
#: ../../library/weakref.rst:188
252321
msgid "A workaround would be to remove the key prior to reassignment::"
253-
msgstr ""
322+
msgstr "一個變通的解法是在重新賦值 (reassignment) 之前刪除鍵： ::"
254323

255324
#: ../../library/weakref.rst:199
256325
msgid "Added support for ``|`` and ``|=`` operators, specified in :pep:`584`."
@@ -265,37 +334,44 @@ msgid ""
265334
"references that will cause the garbage collector to keep the keys around "
266335
"longer than needed."
267336
msgstr ""
337+
":class:`WeakKeyDictionary` 物件有一個直接公開內部參照的附加方法。參照在被使用"
338+
"時不保證是 \"存活的\"，因此在使用之前需要檢查呼叫參照的結果。這可以用來防止建"
339+
"立會導致垃圾回收器保留鍵的時間超過其所需時間的參照。"
268340

269341
#: ../../library/weakref.rst:212
270342
msgid "Return an iterable of the weak references to the keys."
271-
msgstr ""
343+
msgstr "傳回對鍵的弱參照的可疊代物件。"
272344

273345
#: ../../library/weakref.rst:217
274346
msgid ""
275347
"Mapping class that references values weakly. Entries in the dictionary will "
276348
"be discarded when no strong reference to the value exists any more."
277-
msgstr ""
349+
msgstr "弱參照值的對映類別。當不再存在對值的強參照時，字典中的條目將被丟棄。"
278350

279351
#: ../../library/weakref.rst:220
280352
msgid ""
281353
"Added support for ``|`` and ``|=`` operators, as specified in :pep:`584`."
282-
msgstr ""
354+
msgstr "新增對 ``|`` 和 ``|=`` 運算子的支持，如 :pep:`584` 中所說明。"
283355

284356
#: ../../library/weakref.rst:223
285357
msgid ""
286358
":class:`WeakValueDictionary` objects have an additional method that has the "
287359
"same issues as the :meth:`WeakKeyDictionary.keyrefs` method."
288360
msgstr ""
361+
":class:`WeakValueDictionary` 物件有一個附加方法，它與 :meth:"
362+
"`WeakKeyDictionary.keyrefs` 方法有相同的問題。"
289363

290364
#: ../../library/weakref.rst:229
291365
msgid "Return an iterable of the weak references to the values."
292-
msgstr ""
366+
msgstr "傳回對值的弱參照的可疊代物件。"
293367

294368
#: ../../library/weakref.rst:234
295369
msgid ""
296370
"Set class that keeps weak references to its elements. An element will be "
297371
"discarded when no strong reference to it exists any more."
298372
msgstr ""
373+
"保留對其元素的弱參照的集合類別。當不再存在對某個元素的強參照時，該元素將被丟"
374+
"棄。"
299375

300376
#: ../../library/weakref.rst:240
301377
msgid ""
@@ -305,12 +381,16 @@ msgid ""
305381
"hold of it. :class:`WeakMethod` has special code to recreate the bound "
306382
"method until either the object or the original function dies::"
307383
msgstr ""
384+
"一個特製的 :class:`ref` 子類別，其模擬對繫結方法 (bound method) （即在類別上"
385+
"定義並在實例上查找的方法）的弱參照。由於繫結方法是短暫存在的，因此標準弱參照"
386+
"無法保留它。:class:`WeakMethod` 有特殊的程式碼來重新建立繫結方法，直到物件或"
387+
"原始函式死亡： ::"
308388

309389
#: ../../library/weakref.rst:264
310390
msgid ""
311391
"*callback* is the same as the parameter of the same name to the :func:`ref` "
312392
"function."
313-
msgstr ""
393+
msgstr "*callback* 與 :func:`ref` 函式的同名參數是相同的。"
314394

315395
#: ../../library/weakref.rst:270
316396
msgid ""

0 commit comments

Comments
 (0)
0