Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
125 changes: 63 additions & 62 deletions main/locale/pot/LC_MESSAGES/c-api/bytes.pot
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.16\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-06-22 14:16+0000\n"
"POT-Creation-Date: 2026-07-20 11:48+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
Expand Down Expand Up @@ -312,55 +312,56 @@ msgstr ""
#: ../../../c-api/bytes.rst:186
msgid ""
"Create a new bytes object in *\\*bytes* containing the contents of *newpart* "
"appended to *bytes*; the caller will own the new reference. The reference "
"to the old value of *bytes* will be stolen. If the new object cannot be "
"created, the old reference to *bytes* will still be discarded and the value "
"of *\\*bytes* will be set to ``NULL``; the appropriate exception will be set."
"appended to *bytes*; the caller will own the new reference. The reference to "
"the old value of *bytes* will be \":term:`stolen <steal>`\". If the new "
"object cannot be created, the old reference to *bytes* will still be "
"\"stolen\", the value of *\\*bytes* will be set to ``NULL``, and the "
"appropriate exception will be set."
msgstr ""

#: ../../../c-api/bytes.rst:193 ../../../c-api/bytes.rst:203
#: ../../../c-api/bytes.rst:194 ../../../c-api/bytes.rst:204
msgid ""
"If *newpart* implements the buffer protocol, then the buffer must not be "
"mutated while the new bytes object is being created."
msgstr ""

#: ../../../c-api/bytes.rst:198
#: ../../../c-api/bytes.rst:199
msgid ""
"Create a new bytes object in *\\*bytes* containing the contents of *newpart* "
"appended to *bytes*. This version releases the :term:`strong reference` to "
"*newpart* (i.e. decrements its reference count)."
msgstr ""

#: ../../../c-api/bytes.rst:209
#: ../../../c-api/bytes.rst:210
msgid "Similar to ``sep.join(iterable)`` in Python."
msgstr ""

#: ../../../c-api/bytes.rst:211
#: ../../../c-api/bytes.rst:212
msgid ""
"*sep* must be Python :class:`bytes` object. (Note that :c:func:"
"`PyUnicode_Join` accepts ``NULL`` separator and treats it as a space, "
"whereas :c:func:`PyBytes_Join` doesn't accept ``NULL`` separator.)"
msgstr ""

#: ../../../c-api/bytes.rst:216
#: ../../../c-api/bytes.rst:217
msgid ""
"*iterable* must be an iterable object yielding objects that implement the :"
"ref:`buffer protocol <bufferobjects>`."
msgstr ""

#: ../../../c-api/bytes.rst:219
#: ../../../c-api/bytes.rst:220
msgid ""
"On success, return a new :class:`bytes` object. On error, set an exception "
"and return ``NULL``."
msgstr ""

#: ../../../c-api/bytes.rst:225
#: ../../../c-api/bytes.rst:226
msgid ""
"If *iterable* objects implement the buffer protocol, then the buffers must "
"not be mutated while the new bytes object is being created."
msgstr ""

#: ../../../c-api/bytes.rst:230
#: ../../../c-api/bytes.rst:231
msgid ""
"Resize a bytes object. *newsize* will be the new length of the bytes object. "
"You can think of it as creating a new bytes object and destroying the old "
Expand All @@ -372,23 +373,23 @@ msgid ""
"``NULL``, :exc:`MemoryError` is set, and ``-1`` is returned."
msgstr ""

#: ../../../c-api/bytes.rst:241
#: ../../../c-api/bytes.rst:242
msgid "Use the :c:type:`PyBytesWriter` API instead."
msgstr ""

#: ../../../c-api/bytes.rst:247
#: ../../../c-api/bytes.rst:248
msgid ""
"Get the string representation of *bytes*. This function is currently used to "
"implement :meth:`!bytes.__repr__` in Python."
msgstr ""

#: ../../../c-api/bytes.rst:250
#: ../../../c-api/bytes.rst:251
msgid ""
"This function does not do type checking; it is undefined behavior to pass "
"*bytes* as a non-bytes object or ``NULL``."
msgstr ""

#: ../../../c-api/bytes.rst:253
#: ../../../c-api/bytes.rst:254
msgid ""
"If *smartquotes* is true, the representation will use a double-quoted string "
"instead of single-quoted string when single-quotes are present in *bytes*. "
Expand All @@ -397,234 +398,234 @@ msgid ""
"is false."
msgstr ""

#: ../../../c-api/bytes.rst:259
#: ../../../c-api/bytes.rst:260
msgid ""
"On success, this function returns a :term:`strong reference` to a :class:"
"`str` object containing the representation. On failure, this returns "
"``NULL`` with an exception set."
msgstr ""

#: ../../../c-api/bytes.rst:266
#: ../../../c-api/bytes.rst:267
msgid ""
"Unescape a backslash-escaped string *s*. *s* must not be ``NULL``. *len* "
"must be the size of *s*."
msgstr ""

#: ../../../c-api/bytes.rst:269
#: ../../../c-api/bytes.rst:270
msgid ""
"*errors* must be one of ``\"strict\"``, ``\"replace\"``, or ``\"ignore\"``. "
"If *errors* is ``NULL``, then ``\"strict\"`` is used by default."
msgstr ""

#: ../../../c-api/bytes.rst:272
#: ../../../c-api/bytes.rst:273
msgid ""
"On success, this function returns a :term:`strong reference` to a Python :"
"class:`bytes` object containing the unescaped string. On failure, this "
"function returns ``NULL`` with an exception set."
msgstr ""

#: ../../../c-api/bytes.rst:276
#: ../../../c-api/bytes.rst:277
msgid "*unicode* and *recode_encoding* are now unused."
msgstr ""

#: ../../../c-api/bytes.rst:283
#: ../../../c-api/bytes.rst:284
msgid "PyBytesWriter"
msgstr ""

#: ../../../c-api/bytes.rst:285
#: ../../../c-api/bytes.rst:286
msgid ""
"The :c:type:`PyBytesWriter` API can be used to create a Python :class:"
"`bytes` object."
msgstr ""

#: ../../../c-api/bytes.rst:292
#: ../../../c-api/bytes.rst:293
msgid "A bytes writer instance."
msgstr ""

#: ../../../c-api/bytes.rst:294
#: ../../../c-api/bytes.rst:295
msgid ""
"The API is **not thread safe**: a writer should only be used by a single "
"thread at the same time."
msgstr ""

#: ../../../c-api/bytes.rst:297
#: ../../../c-api/bytes.rst:298
msgid ""
"The instance must be destroyed by :c:func:`PyBytesWriter_Finish` on success, "
"or :c:func:`PyBytesWriter_Discard` on error."
msgstr ""

#: ../../../c-api/bytes.rst:302
#: ../../../c-api/bytes.rst:303
msgid "Create, Finish, Discard"
msgstr ""

#: ../../../c-api/bytes.rst:306
#: ../../../c-api/bytes.rst:307
msgid "Create a :c:type:`PyBytesWriter` to write *size* bytes."
msgstr ""

#: ../../../c-api/bytes.rst:308
#: ../../../c-api/bytes.rst:309
msgid ""
"If *size* is greater than zero, allocate *size* bytes, and set the writer "
"size to *size*. The caller is responsible to write *size* bytes using :c:"
"func:`PyBytesWriter_GetData`. This function does not overallocate."
msgstr ""

#: ../../../c-api/bytes.rst:313 ../../../c-api/bytes.rst:442
#: ../../../c-api/bytes.rst:314 ../../../c-api/bytes.rst:443
msgid "On error, set an exception and return ``NULL``."
msgstr ""

#: ../../../c-api/bytes.rst:315 ../../../c-api/bytes.rst:418
#: ../../../c-api/bytes.rst:316 ../../../c-api/bytes.rst:419
msgid "*size* must be positive or zero."
msgstr ""

#: ../../../c-api/bytes.rst:319
#: ../../../c-api/bytes.rst:320
msgid ""
"Finish a :c:type:`PyBytesWriter` created by :c:func:`PyBytesWriter_Create`."
msgstr ""

#: ../../../c-api/bytes.rst:322
#: ../../../c-api/bytes.rst:323
msgid ""
"On success, return a Python :class:`bytes` object. On error, set an "
"exception and return ``NULL``."
msgstr ""

#: ../../../c-api/bytes.rst:325
#: ../../../c-api/bytes.rst:326
msgid ""
"The writer instance is invalid after the call in any case. No API can be "
"called on the writer after :c:func:`PyBytesWriter_Finish`."
msgstr ""

#: ../../../c-api/bytes.rst:330
#: ../../../c-api/bytes.rst:331
msgid ""
"Similar to :c:func:`PyBytesWriter_Finish`, but resize the writer to *size* "
"bytes before creating the :class:`bytes` object."
msgstr ""

#: ../../../c-api/bytes.rst:335
#: ../../../c-api/bytes.rst:336
msgid ""
"Similar to :c:func:`PyBytesWriter_Finish`, but resize the writer using *buf* "
"pointer before creating the :class:`bytes` object."
msgstr ""

#: ../../../c-api/bytes.rst:338
#: ../../../c-api/bytes.rst:339
msgid ""
"Set an exception and return ``NULL`` if *buf* pointer is outside the "
"internal buffer bounds."
msgstr ""

#: ../../../c-api/bytes.rst:341 ../../../c-api/bytes.rst:446
#: ../../../c-api/bytes.rst:342 ../../../c-api/bytes.rst:447
msgid "Function pseudo-code::"
msgstr ""

#: ../../../c-api/bytes.rst:348
#: ../../../c-api/bytes.rst:349
msgid ""
"Discard a :c:type:`PyBytesWriter` created by :c:func:`PyBytesWriter_Create`."
msgstr ""

#: ../../../c-api/bytes.rst:350
#: ../../../c-api/bytes.rst:351
msgid "Do nothing if *writer* is ``NULL``."
msgstr ""

#: ../../../c-api/bytes.rst:352
#: ../../../c-api/bytes.rst:353
msgid ""
"The writer instance is invalid after the call. No API can be called on the "
"writer after :c:func:`PyBytesWriter_Discard`."
msgstr ""

#: ../../../c-api/bytes.rst:356
#: ../../../c-api/bytes.rst:357
msgid "High-level API"
msgstr ""

#: ../../../c-api/bytes.rst:360
#: ../../../c-api/bytes.rst:361
msgid ""
"Grow the *writer* internal buffer by *size* bytes, write *size* bytes of "
"*bytes* at the *writer* end, and add *size* to the *writer* size."
msgstr ""

#: ../../../c-api/bytes.rst:364
#: ../../../c-api/bytes.rst:365
msgid ""
"If *size* is equal to ``-1``, call ``strlen(bytes)`` to get the string "
"length."
msgstr ""

#: ../../../c-api/bytes.rst:367 ../../../c-api/bytes.rst:376
#: ../../../c-api/bytes.rst:415 ../../../c-api/bytes.rst:428
#: ../../../c-api/bytes.rst:368 ../../../c-api/bytes.rst:377
#: ../../../c-api/bytes.rst:416 ../../../c-api/bytes.rst:429
msgid "On success, return ``0``. On error, set an exception and return ``-1``."
msgstr ""

#: ../../../c-api/bytes.rst:372
#: ../../../c-api/bytes.rst:373
msgid ""
"Similar to :c:func:`PyBytes_FromFormat`, but write the output directly at "
"the writer end. Grow the writer internal buffer on demand. Then add the "
"written size to the writer size."
msgstr ""

#: ../../../c-api/bytes.rst:381
#: ../../../c-api/bytes.rst:382
msgid "Getters"
msgstr ""

#: ../../../c-api/bytes.rst:385
#: ../../../c-api/bytes.rst:386
msgid "Get the writer size."
msgstr ""

#: ../../../c-api/bytes.rst:387
#: ../../../c-api/bytes.rst:388
msgid ""
"The function does not invalidate pointers returned by :c:func:"
"`PyBytesWriter_GetData`."
msgstr ""

#: ../../../c-api/bytes.rst:390 ../../../c-api/bytes.rst:400
#: ../../../c-api/bytes.rst:391 ../../../c-api/bytes.rst:401
msgid "The function cannot fail."
msgstr ""

#: ../../../c-api/bytes.rst:394
#: ../../../c-api/bytes.rst:395
msgid "Get the writer data: start of the internal buffer."
msgstr ""

#: ../../../c-api/bytes.rst:396
#: ../../../c-api/bytes.rst:397
msgid ""
"The pointer remains valid until a :c:type:`PyBytesWriter` function other "
"than :c:func:`PyBytesWriter_GetData` or :c:func:`PyBytesWriter_GetSize` is "
"called on *writer*."
msgstr ""

#: ../../../c-api/bytes.rst:404
#: ../../../c-api/bytes.rst:405
msgid "Low-level API"
msgstr ""

#: ../../../c-api/bytes.rst:408
#: ../../../c-api/bytes.rst:409
msgid ""
"Resize the writer to *size* bytes. It can be used to enlarge or to shrink "
"the writer. This function typically overallocates to achieve amortized "
"performance when resizing multiple times."
msgstr ""

#: ../../../c-api/bytes.rst:413 ../../../c-api/bytes.rst:426
#: ../../../c-api/bytes.rst:414 ../../../c-api/bytes.rst:427
msgid "Newly allocated bytes are left uninitialized."
msgstr ""

#: ../../../c-api/bytes.rst:422
#: ../../../c-api/bytes.rst:423
msgid ""
"Resize the writer by adding *grow* bytes to the current writer size. This "
"function typically overallocates to achieve amortized performance when "
"resizing multiple times."
msgstr ""

#: ../../../c-api/bytes.rst:431
#: ../../../c-api/bytes.rst:432
msgid "*size* can be negative to shrink the writer."
msgstr ""

#: ../../../c-api/bytes.rst:435
#: ../../../c-api/bytes.rst:436
msgid ""
"Similar to :c:func:`PyBytesWriter_Grow`, but update also the *buf* pointer."
msgstr ""

#: ../../../c-api/bytes.rst:438
#: ../../../c-api/bytes.rst:439
msgid ""
"The *buf* pointer is moved if the internal buffer is moved in memory. The "
"*buf* relative position within the internal buffer is left unchanged."
msgstr ""

#: ../../../c-api/bytes.rst:444
#: ../../../c-api/bytes.rst:445
msgid "*buf* must not be ``NULL``."
msgstr ""

Expand Down
Loading