|
7 | 7 | msgstr "" |
8 | 8 | "Project-Id-Version:Python 3.12\n" |
9 | 9 | "Report-Msgid-Bugs-To:\n" |
10 | | -"POT-Creation-Date:2023-05-09 00:15+0000\n" |
| 10 | +"POT-Creation-Date:2023-07-26 00:03+0000\n" |
11 | 11 | "PO-Revision-Date:YEAR-MO-DA HO:MI+ZONE\n" |
12 | 12 | "Last-Translator:FULL NAME <EMAIL@ADDRESS>\n" |
13 | 13 | "Language-Team:Chinese - TAIWAN (https://github.com/python/python-docs-zh-" |
@@ -212,63 +212,79 @@ msgstr "" |
212 | 212 | msgid"" |
213 | 213 | "Provides a mutable list-like object where all values stored within are " |
214 | 214 | "stored in a shared memory block. This constrains storable values to only " |
215 | | -"the ``int``, ``float``, ``bool``, ``str`` (less than 10M bytes each), " |
216 | | -"``bytes`` (less than 10M bytes each), and ``None`` built-in data types. It " |
217 | | -"also notably differs from the built-in ``list`` type in that these lists can " |
218 | | -"not change their overall length (i.e. no append, insert, etc.) and do not " |
219 | | -"support the dynamic creation of new :class:`ShareableList` instances via" |
220 | | -"slicing." |
| 215 | +"the ``int`` (signed 64-bit), ``float``, ``bool``, ``str`` (less than 10M " |
| 216 | +"bytes each when encoded as utf-8),``bytes`` (less than 10M bytes each), and " |
| 217 | +"``None`` built-in data types. Italso notably differs from the built-in " |
| 218 | +"``list`` type in that these lists cannot change their overall length (i.e. " |
| 219 | +"no append, insert, etc.) and do notsupport the dynamic creation of new :" |
| 220 | +"class:`ShareableList` instances viaslicing." |
221 | 221 | msgstr"" |
222 | 222 |
|
223 | | -#:../../library/multiprocessing.shared_memory.rst:269 |
| 223 | +#:../../library/multiprocessing.shared_memory.rst:270 |
224 | 224 | msgid"" |
225 | 225 | "*sequence* is used in populating a new ``ShareableList`` full of values. Set " |
226 | 226 | "to ``None`` to instead attach to an already existing ``ShareableList`` by " |
227 | 227 | "its unique shared memory name." |
228 | 228 | msgstr"" |
229 | 229 |
|
230 | | -#:../../library/multiprocessing.shared_memory.rst:273 |
| 230 | +#:../../library/multiprocessing.shared_memory.rst:274 |
231 | 231 | msgid"" |
232 | 232 | "*name* is the unique name for the requested shared memory, as described in " |
233 | 233 | "the definition for :class:`SharedMemory`. When attaching to an existing " |
234 | 234 | "``ShareableList``, specify its shared memory block's unique name while " |
235 | 235 | "leaving ``sequence`` set to ``None``." |
236 | 236 | msgstr"" |
237 | 237 |
|
238 | | -#:../../library/multiprocessing.shared_memory.rst:280 |
| 238 | +#:../../library/multiprocessing.shared_memory.rst:281 |
| 239 | +msgid"" |
| 240 | +"A known issue exists for :class:`bytes` and :class:`str` values. If they end " |
| 241 | +"with ``\\x00`` nul bytes or characters, those may be *silently stripped* " |
| 242 | +"when fetching them by index from the :class:`ShareableList`. This ``." |
| 243 | +"rstrip(b'\\x00')`` behavior is considered a bug and may go away in the " |
| 244 | +"future. See :gh:`106939`." |
| 245 | +msgstr"" |
| 246 | + |
| 247 | +#:../../library/multiprocessing.shared_memory.rst:287 |
| 248 | +msgid"" |
| 249 | +"For applications where rstripping of trailing nulls is a problem, work " |
| 250 | +"around it by always unconditionally appending an extra non-0 byte to the end " |
| 251 | +"of such values when storing and unconditionally removing it when fetching:" |
| 252 | +msgstr"" |
| 253 | + |
| 254 | +#:../../library/multiprocessing.shared_memory.rst:310 |
239 | 255 | msgid"Returns the number of occurrences of ``value``." |
240 | 256 | msgstr"" |
241 | 257 |
|
242 | | -#:../../library/multiprocessing.shared_memory.rst:284 |
| 258 | +#:../../library/multiprocessing.shared_memory.rst:314 |
243 | 259 | msgid"" |
244 | 260 | "Returns first index position of ``value``. Raises :exc:`ValueError` if " |
245 | 261 | "``value`` is not present." |
246 | 262 | msgstr"" |
247 | 263 |
|
248 | | -#:../../library/multiprocessing.shared_memory.rst:289 |
| 264 | +#:../../library/multiprocessing.shared_memory.rst:319 |
249 | 265 | msgid"" |
250 | 266 | "Read-only attribute containing the :mod:`struct` packing format used by all " |
251 | 267 | "currently stored values." |
252 | 268 | msgstr"" |
253 | 269 |
|
254 | | -#:../../library/multiprocessing.shared_memory.rst:294 |
| 270 | +#:../../library/multiprocessing.shared_memory.rst:324 |
255 | 271 | msgid"The :class:`SharedMemory` instance where the values are stored." |
256 | 272 | msgstr"" |
257 | 273 |
|
258 | | -#:../../library/multiprocessing.shared_memory.rst:297 |
| 274 | +#:../../library/multiprocessing.shared_memory.rst:327 |
259 | 275 | msgid"" |
260 | 276 | "The following example demonstrates basic use of a :class:`ShareableList` " |
261 | 277 | "instance:" |
262 | 278 | msgstr"" |
263 | 279 |
|
264 | | -#:../../library/multiprocessing.shared_memory.rst:330 |
| 280 | +#:../../library/multiprocessing.shared_memory.rst:360 |
265 | 281 | msgid"" |
266 | 282 | "The following example depicts how one, two, or many processes may access the " |
267 | 283 | "same :class:`ShareableList` by supplying the name of the shared memory block " |
268 | 284 | "behind it:" |
269 | 285 | msgstr"" |
270 | 286 |
|
271 | | -#:../../library/multiprocessing.shared_memory.rst:345 |
| 287 | +#:../../library/multiprocessing.shared_memory.rst:375 |
272 | 288 | msgid"" |
273 | 289 | "The following examples demonstrates that ``ShareableList`` (and underlying " |
274 | 290 | "``SharedMemory``) objects can be pickled and unpickled if needed. Note, that " |
|