bytes.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# python-doc bot, 2025
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-10-11 18:31+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
"teams/5390/pt_BR/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: pt_BR\n"
"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % "
"1000000 == 0 ? 1 : 2;\n"

#: ../../c-api/bytes.rst:6
msgid "Bytes Objects"
msgstr "Objetos Bytes"

#: ../../c-api/bytes.rst:8
msgid ""
"These functions raise :exc:`TypeError` when expecting a bytes parameter and "
"called with a non-bytes parameter."
msgstr ""
"Estas funções levantam :exc:`TypeError` quando se espera um parâmetro bytes "
"e são chamados com um parâmetro que não é bytes."

#: ../../c-api/bytes.rst:13
msgid ""
"The internal buffer of :c:type:`PyBytesObject` always includes an extra "
"trailing null byte for compatibility with null terminated C strings. This "
"extra byte is not counted in :c:func:`PyBytes_Size` nor in the various "
"*length* and *size* arguments of the functions below."
msgstr ""

#: ../../c-api/bytes.rst:23
msgid "This subtype of :c:type:`PyObject` represents a Python bytes object."
msgstr ""
"Esta é uma instância de :c:type:`PyObject` representando o objeto bytes do "
"Python."

#: ../../c-api/bytes.rst:28
msgid ""
"This instance of :c:type:`PyTypeObject` represents the Python bytes type; it "
"is the same object as :class:`bytes` in the Python layer."
msgstr ""
"Esta instância de :c:type:`PyTypeObject` representa o tipo de bytes Python; "
"é o mesmo objeto que :class:`bytes` na camada de Python."

#: ../../c-api/bytes.rst:34
msgid ""
"Return true if the object *o* is a bytes object or an instance of a subtype "
"of the bytes type.  This function always succeeds."
msgstr ""
"Retorna verdadeiro se o objeto *o* for um objeto bytes ou se for uma "
"instância de um subtipo do tipo bytes. Esta função sempre tem sucesso."

#: ../../c-api/bytes.rst:40
msgid ""
"Return true if the object *o* is a bytes object, but not an instance of a "
"subtype of the bytes type.  This function always succeeds."
msgstr ""
"Retorna verdadeiro se o objeto *o* for um objeto bytes, mas não uma "
"instância de um subtipo do tipo bytes. Esta função sempre tem sucesso."

#: ../../c-api/bytes.rst:46
msgid ""
"Return a new bytes object with a copy of the string *v* as value on success, "
"and ``NULL`` on failure.  The parameter *v* must not be ``NULL``; it will "
"not be checked."
msgstr ""
"Retorna um novo objeto de bytes com uma cópia da string *v* como valor em "
"caso de sucesso e ``NULL`` em caso de falha. O parâmetro *v* não deve ser "
"``NULL`` e isso não será verificado."

#: ../../c-api/bytes.rst:53
msgid ""
"Return a new bytes object with a copy of the string *v* as value and length "
"*len* on success, and ``NULL`` on failure.  If *v* is ``NULL``, the contents "
"of the bytes object are uninitialized."
msgstr ""
"Retorna um novo objeto de bytes com uma cópia da string *v* como valor e "
"comprimento *len* em caso de sucesso e ``NULL`` em caso de falha. Se *v* for "
"``NULL``, o conteúdo do objeto bytes não será inicializado."

#: ../../c-api/bytes.rst:57
msgid ""
"Use the :c:type:`PyBytesWriter` API instead of "
"``PyBytes_FromStringAndSize(NULL, len)``."
msgstr ""

#: ../../c-api/bytes.rst:64
msgid ""
"Take a C :c:func:`printf`\\ -style *format* string and a variable number of "
"arguments, calculate the size of the resulting Python bytes object and "
"return a bytes object with the values formatted into it.  The variable "
"arguments must be C types and must correspond exactly to the format "
"characters in the *format* string.  The following format characters are "
"allowed:"
msgstr ""
"Leva uma string tipo :c:func:`printf` do C *format* e um número variável de "
"argumentos, calcula o tamanho do objeto bytes do Python resultante e retorna "
"um objeto bytes com os valores formatados nela. Os argumentos da variável "
"devem ser tipos C e devem corresponder exatamente aos caracteres de formato "
"na string *format*. Os seguintes formatos de caracteres são permitidos:"

#: ../../c-api/bytes.rst:76
msgid "Format Characters"
msgstr "Caracteres Formatados"

#: ../../c-api/bytes.rst:76
msgid "Type"
msgstr "Tipo"

#: ../../c-api/bytes.rst:76
msgid "Comment"
msgstr "Comentário"

#: ../../c-api/bytes.rst:78
msgid "``%%``"
msgstr "``%%``"

#: ../../c-api/bytes.rst:78
msgid "*n/a*"
msgstr "*n/d*"

#: ../../c-api/bytes.rst:78
msgid "The literal % character."
msgstr "O caractere literal %."

#: ../../c-api/bytes.rst:80
msgid "``%c``"
msgstr "``%c``"

#: ../../c-api/bytes.rst:80 ../../c-api/bytes.rst:83 ../../c-api/bytes.rst:101
#: ../../c-api/bytes.rst:104
msgid "int"
msgstr "int"

#: ../../c-api/bytes.rst:80
msgid "A single byte, represented as a C int."
msgstr "Um único byte, representado como um C int."

#: ../../c-api/bytes.rst:83
msgid "``%d``"
msgstr "``%d``"

#: ../../c-api/bytes.rst:83
msgid "Equivalent to ``printf(\"%d\")``. [1]_"
msgstr "Equivalente a ``printf(\"%d\")``. [1]_"

#: ../../c-api/bytes.rst:86
msgid "``%u``"
msgstr "``%u``"

#: ../../c-api/bytes.rst:86
msgid "unsigned int"
msgstr "unsigned int"

#: ../../c-api/bytes.rst:86
msgid "Equivalent to ``printf(\"%u\")``. [1]_"
msgstr "Equivalente a ``printf(\"%u\")``. [1]_"

#: ../../c-api/bytes.rst:89
msgid "``%ld``"
msgstr "``%ld``"

#: ../../c-api/bytes.rst:89
msgid "long"
msgstr "long"

#: ../../c-api/bytes.rst:89
msgid "Equivalent to ``printf(\"%ld\")``. [1]_"
msgstr "Equivalente a ``printf(\"%ld\")``. [1]_"

#: ../../c-api/bytes.rst:92
msgid "``%lu``"
msgstr "``%lu``"

#: ../../c-api/bytes.rst:92
msgid "unsigned long"
msgstr "unsigned long"

#: ../../c-api/bytes.rst:92
msgid "Equivalent to ``printf(\"%lu\")``. [1]_"
msgstr "Equivalente a ``printf(\"%lu\")``. [1]_"

#: ../../c-api/bytes.rst:95
msgid "``%zd``"
msgstr "``%zd``"

#: ../../c-api/bytes.rst:95
msgid ":c:type:`\\ Py_ssize_t`"
msgstr ":c:type:`\\ Py_ssize_t`"

#: ../../c-api/bytes.rst:95
msgid "Equivalent to ``printf(\"%zd\")``. [1]_"
msgstr "Equivalente a ``printf(\"%zd\")``. [1]_"

#: ../../c-api/bytes.rst:98
msgid "``%zu``"
msgstr "``%zu``"

#: ../../c-api/bytes.rst:98
msgid "size_t"
msgstr "size_t"

#: ../../c-api/bytes.rst:98
msgid "Equivalent to ``printf(\"%zu\")``. [1]_"
msgstr "Equivalente a ``printf(\"%zu\")``. [1]_"

#: ../../c-api/bytes.rst:101
msgid "``%i``"
msgstr "``%i``"

#: ../../c-api/bytes.rst:101
msgid "Equivalent to ``printf(\"%i\")``. [1]_"
msgstr "Equivalente a ``printf(\"%i\")``. [1]_"

#: ../../c-api/bytes.rst:104
msgid "``%x``"
msgstr "``%x``"

#: ../../c-api/bytes.rst:104
msgid "Equivalent to ``printf(\"%x\")``. [1]_"
msgstr "Equivalente a ``printf(\"%x\")``. [1]_"

#: ../../c-api/bytes.rst:107
msgid "``%s``"
msgstr "``%s``"

#: ../../c-api/bytes.rst:107
msgid "const char\\*"
msgstr "const char\\*"

#: ../../c-api/bytes.rst:107
msgid "A null-terminated C character array."
msgstr "Uma matriz de caracteres C com terminação nula."

#: ../../c-api/bytes.rst:110
msgid "``%p``"
msgstr "``%p``"

#: ../../c-api/bytes.rst:110
msgid "const void\\*"
msgstr "const void\\*"

#: ../../c-api/bytes.rst:110
msgid ""
"The hex representation of a C pointer. Mostly equivalent to "
"``printf(\"%p\")`` except that it is guaranteed to start with the literal "
"``0x`` regardless of what the platform's ``printf`` yields."
msgstr ""
"A representação hexadecimal de um ponteiro C. Principalmente equivalente a "
"``printf(\"%p\")`` exceto que é garantido que comece com o literal ``0x`` "
"independentemente do que o ``printf`` da plataforma ceda."

#: ../../c-api/bytes.rst:119
msgid ""
"An unrecognized format character causes all the rest of the format string to "
"be copied as-is to the result object, and any extra arguments discarded."
msgstr ""
"Um caractere de formato não reconhecido faz com que todo o resto da string "
"de formato seja copiado como é para o objeto resultante e todos os "
"argumentos extras sejam descartados."

#: ../../c-api/bytes.rst:122
msgid ""
"For integer specifiers (d, u, ld, lu, zd, zu, i, x): the 0-conversion flag "
"has effect even when a precision is given."
msgstr ""
"Para especificadores de número inteiro (d, u, ld, lu, zd, zu, i, x): o "
"sinalizador de conversão 0 tem efeito mesmo quando uma precisão é fornecida."

#: ../../c-api/bytes.rst:128
msgid ""
"Identical to :c:func:`PyBytes_FromFormat` except that it takes exactly two "
"arguments."
msgstr ""
"Idêntico a :c:func:`PyBytes_FromFormat` exceto que é preciso exatamente dois "
"argumentos."

#: ../../c-api/bytes.rst:134
msgid ""
"Return the bytes representation of object *o* that implements the buffer "
"protocol."
msgstr ""
"Retorna a representação de bytes do objeto *o* que implementa o protocolo de "
"buffer."

#: ../../c-api/bytes.rst:138
msgid ""
"If the object implements the buffer protocol, then the buffer must not be "
"mutated while the bytes object is being created."
msgstr ""

#: ../../c-api/bytes.rst:144
msgid "Return the length of the bytes in bytes object *o*."
msgstr "Retorna o comprimento dos bytes em objeto bytes *o*."

#: ../../c-api/bytes.rst:149
msgid "Similar to :c:func:`PyBytes_Size`, but without error checking."
msgstr "Similar a :c:func:`PyBytes_Size`, mas sem verificação de erro."

#: ../../c-api/bytes.rst:154
msgid ""
"Return a pointer to the contents of *o*.  The pointer refers to the internal "
"buffer of *o*, which consists of ``len(o) + 1`` bytes.  The last byte in the "
"buffer is always null, regardless of whether there are any other null "
"bytes.  The data must not be modified in any way, unless the object was just "
"created using ``PyBytes_FromStringAndSize(NULL, size)``. It must not be "
"deallocated.  If *o* is not a bytes object at all, :c:func:"
"`PyBytes_AsString` returns ``NULL`` and raises :exc:`TypeError`."
msgstr ""
"Retorna um ponteiro para o conteúdo de *o*. O ponteiro se refere ao buffer "
"interno de *o*, que consiste em ``len(o) + 1`` bytes. O último byte no "
"buffer é sempre nulo, independentemente de haver outros bytes nulos. Os "
"dados não devem ser modificados de forma alguma, a menos que o objeto tenha "
"sido criado usando ``PyBytes_FromStringAndSize(NULL, size)``. Não deve ser "
"desalocado. Se *o* não é um objeto de bytes, :c:func:`PyBytes_AsString` "
"retorna ``NULL`` e levanta :exc:`TypeError`."

#: ../../c-api/bytes.rst:166
msgid "Similar to :c:func:`PyBytes_AsString`, but without error checking."
msgstr "Similar a :c:func:`PyBytes_AsString`, mas sem verificação de erro."

#: ../../c-api/bytes.rst:171
msgid ""
"Return the null-terminated contents of the object *obj* through the output "
"variables *buffer* and *length*. Returns ``0`` on success."
msgstr ""
"Retorna os conteúdos terminados nulos do objeto *obj* através das variáveis "
"de saída *buffer* e *length*. Retorna ``0`` em caso de sucesso."

#: ../../c-api/bytes.rst:175
msgid ""
"If *length* is ``NULL``, the bytes object may not contain embedded null "
"bytes; if it does, the function returns ``-1`` and a :exc:`ValueError` is "
"raised."
msgstr ""
"Se *length* for ``NULL``, o objeto bytes não poderá conter bytes nulos "
"incorporados; se isso acontecer, a função retornará ``-1`` e a :exc:"
"`ValueError` será levantado."

#: ../../c-api/bytes.rst:179
msgid ""
"The buffer refers to an internal buffer of *obj*, which includes an "
"additional null byte at the end (not counted in *length*).  The data must "
"not be modified in any way, unless the object was just created using "
"``PyBytes_FromStringAndSize(NULL, size)``.  It must not be deallocated.  If "
"*obj* is not a bytes object at all, :c:func:`PyBytes_AsStringAndSize` "
"returns ``-1`` and raises :exc:`TypeError`."
msgstr ""
"O buffer refere-se a um buffer interno de *obj*, que inclui um byte nulo "
"adicional no final (não contado em *length*). Os dados não devem ser "
"modificados de forma alguma, a menos que o objeto tenha sido criado apenas "
"usando ``PyBytes_FromStringAndSize(NULL, size)``. Não deve ser desalinhado. "
"Se *obj* não é um objeto bytes, :c:func:`PyBytes_AsStringAndSize` retorna "
"``-1`` e levanta :exc:`TypeError`."

#: ../../c-api/bytes.rst:186
msgid ""
"Previously, :exc:`TypeError` was raised when embedded null bytes were "
"encountered in the bytes object."
msgstr ""
"Anteriormente :exc:`TypeError` era levantado quando os bytes nulos "
"incorporados eram encontrados no objeto bytes."

#: ../../c-api/bytes.rst:193
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 \":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:201 ../../c-api/bytes.rst:211
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:206
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 ""
"\"Crie um novo objeto bytes em *\\*bytes* contendo o conteúdo de newpart "
"anexado a bytes. Esta versão libera a :term:`strong reference` (referência "
"forte) para newpart (ou seja, decrementa a contagem de referências a ele).\""

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

#: ../../c-api/bytes.rst:219
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 ""
"*sep* deve ser um objeto Python :class:`bytes`. (Observe que :c:func:"
"`PyUnicode_Join` aceita o separador ``NULL`` e o trata como um espaço, "
"enquanto :c:func:`PyBytes_Join` não aceita o separador ``NULL``.)"

#: ../../c-api/bytes.rst:224
msgid ""
"*iterable* must be an iterable object yielding objects that implement the :"
"ref:`buffer protocol <bufferobjects>`."
msgstr ""
"*iterable* deve ser um objeto iterável que produz objetos que implementam o :"
"ref:`protocolo de buffer <bufferobjects>`."

#: ../../c-api/bytes.rst:227
msgid ""
"On success, return a new :class:`bytes` object. On error, set an exception "
"and return ``NULL``."
msgstr ""
"Em caso de sucesso, retorna um novo objeto :class:`bytes`. Em caso de erro, "
"define uma exceção e retorna ``NULL``."

#: ../../c-api/bytes.rst:233
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:238
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 "
"one, only more efficiently. Pass the address of an existing bytes object as "
"an lvalue (it may be written into), and the new size desired.  On success, "
"*\\*bytes* holds the resized bytes object and ``0`` is returned; the address "
"in *\\*bytes* may differ from its input value.  If the reallocation fails, "
"the original bytes object at *\\*bytes* is deallocated, *\\*bytes* is set to "
"``NULL``, :exc:`MemoryError` is set, and ``-1`` is returned."
msgstr ""
"Redimensiona um objeto de bytes. *newsize* será o novo tamanho do objeto "
"bytes. Você pode pensar nisso como se estivesse criando um novo objeto de "
"bytes e destruindo o antigo, só que de forma mais eficiente. Passe o "
"endereço de um objeto de bytes existente como um lvalue (pode ser gravado) e "
"o novo tamanho desejado. Em caso de sucesso, *\\*bytes* mantém o objeto de "
"bytes redimensionados e ``0`` é retornado; o endereço em *\\*bytes* pode "
"diferir do seu valor de entrada. Se a realocação falhar, o objeto de bytes "
"originais em *\\*bytes* é desalocado, *\\*bytes* é definido como ``NULL``, :"
"exc:`MemoryError` é definido e ``-1`` é retornado."

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

#: ../../c-api/bytes.rst:255
msgid ""
"Get the string representation of *bytes*. This function is currently used to "
"implement :meth:`!bytes.__repr__` in Python."
msgstr ""
"Obtém a representação em string de *bytes*. Esta função é atualmente usada "
"para implementar :meth:`!bytes.__repr__` em Python."

#: ../../c-api/bytes.rst:258
msgid ""
"This function does not do type checking; it is undefined behavior to pass "
"*bytes* as a non-bytes object or ``NULL``."
msgstr ""
"Esta função não realiza verificação de tipo; é um comportamento indefinido "
"passar *bytes* como um objeto que não seja do tipo bytes ou ``NULL``."

#: ../../c-api/bytes.rst:261
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*. "
"For example, the byte string ``'Python'`` would be represented as "
"``b\"'Python'\"`` when *smartquotes* is true, or ``b'\\'Python\\''`` when it "
"is false."
msgstr ""
"Se *smartquotes* for verdadeiro, a representação usará uma string entre "
"aspas duplas em vez de aspas simples quando aspas simples estiverem "
"presentes em *bytes*. Por exemplo, a string de bytes ``'Python'`` seria "
"representada como ``b\"'Python'\"`` quando *smartquotes* for verdadeiro, ou "
"``b'\\'Python\\''`` quando for falso."

#: ../../c-api/bytes.rst:267
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 ""
"Em caso de sucesso, esta função retorna uma :term:`referência forte` a um "
"objeto :class:`str` contendo a representação. Em caso de falha, ela retorna "
"``NULL`` com uma exceção definida."

#: ../../c-api/bytes.rst:274
msgid ""
"Unescape a backslash-escaped string *s*. *s* must not be ``NULL``. *len* "
"must be the size of *s*."
msgstr ""
"Remove um string *s* que foi escapada com contrabarra. *s* não pode ser "
"``NULL``. *len* deve ser o tamanho de *s*."

#: ../../c-api/bytes.rst:277
msgid ""
"*errors* must be one of ``\"strict\"``, ``\"replace\"``, or ``\"ignore\"``. "
"If *errors* is ``NULL``, then ``\"strict\"`` is used by default."
msgstr ""
"*errors* deve ser um dos seguintes valores: ``\"strict\"``, ``\"replace\"`` "
"ou ``\"ignore\"``. Se *errors* for ``NULL``, o valor padrão será "
"``\"strict\"``."

#: ../../c-api/bytes.rst:280
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 ""
"Em caso de sucesso, esta função retorna uma :term:`referência forte` a um "
"objeto Python :class:`bytes` contendo a string sem escape. Em caso de falha, "
"esta função retorna ``NULL`` com uma exceção definida."

#: ../../c-api/bytes.rst:284
msgid "*unicode* and *recode_encoding* are now unused."
msgstr "*unicode* e *recode_encoding* não são mais usadas."

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

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

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

#: ../../c-api/bytes.rst:302
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:305
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:310
msgid "Create, Finish, Discard"
msgstr ""

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

#: ../../c-api/bytes.rst:316
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:321 ../../c-api/bytes.rst:450
msgid "On error, set an exception and return ``NULL``."
msgstr ""

#: ../../c-api/bytes.rst:323 ../../c-api/bytes.rst:426
msgid "*size* must be positive or zero."
msgstr ""

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

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

#: ../../c-api/bytes.rst:333
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:338
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:343
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:346
msgid ""
"Set an exception and return ``NULL`` if *buf* pointer is outside the "
"internal buffer bounds."
msgstr ""

#: ../../c-api/bytes.rst:349 ../../c-api/bytes.rst:454
msgid "Function pseudo-code::"
msgstr ""

#: ../../c-api/bytes.rst:351
msgid ""
"Py_ssize_t size = (char*)buf - (char*)PyBytesWriter_GetData(writer);\n"
"return PyBytesWriter_FinishWithSize(writer, size);"
msgstr ""

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

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

#: ../../c-api/bytes.rst:360
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:364
msgid "High-level API"
msgstr ""

#: ../../c-api/bytes.rst:368
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:372
msgid ""
"If *size* is equal to ``-1``, call ``strlen(bytes)`` to get the string "
"length."
msgstr ""

#: ../../c-api/bytes.rst:375 ../../c-api/bytes.rst:384
#: ../../c-api/bytes.rst:423 ../../c-api/bytes.rst:436
msgid "On success, return ``0``. On error, set an exception and return ``-1``."
msgstr ""

#: ../../c-api/bytes.rst:380
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:389
msgid "Getters"
msgstr ""

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

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

#: ../../c-api/bytes.rst:398 ../../c-api/bytes.rst:408
msgid "The function cannot fail."
msgstr ""

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

#: ../../c-api/bytes.rst:404
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:412
msgid "Low-level API"
msgstr ""

#: ../../c-api/bytes.rst:416
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:421 ../../c-api/bytes.rst:434
msgid "Newly allocated bytes are left uninitialized."
msgstr ""

#: ../../c-api/bytes.rst:430
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:439
msgid "*size* can be negative to shrink the writer."
msgstr ""

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

#: ../../c-api/bytes.rst:446
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:452
msgid "*buf* must not be ``NULL``."
msgstr ""

#: ../../c-api/bytes.rst:456
msgid ""
"Py_ssize_t pos = (char*)buf - (char*)PyBytesWriter_GetData(writer);\n"
"if (PyBytesWriter_Grow(writer, size) < 0) {\n"
"    return NULL;\n"
"}\n"
"return (char*)PyBytesWriter_GetData(writer) + pos;"
msgstr ""

#: ../../c-api/bytes.rst:464
msgid "Example creating the string ``b'abc'``"
msgstr ""

#: ../../c-api/bytes.rst:466
msgid ""
"Example creating the bytes string ``b\"abc\"``, with a fixed size of 3 "
"bytes::"
msgstr ""

#: ../../c-api/bytes.rst:468
msgid ""
"PyObject* create_abc(void)\n"
"{\n"
"    PyBytesWriter *writer = PyBytesWriter_Create(3);\n"
"    if (writer == NULL) {\n"
"        return NULL;\n"
"    }\n"
"\n"
"    char *str = PyBytesWriter_GetData(writer);\n"
"    memcpy(str, \"abc\", 3);\n"
"    return PyBytesWriter_Finish(writer);\n"
"}"
msgstr ""

#: ../../c-api/bytes.rst:480
msgid "Variant using a pointer to compute the final size::"
msgstr ""

#: ../../c-api/bytes.rst:482
msgid ""
"PyObject* create_abc_ptr(void)\n"
"{\n"
"    PyBytesWriter *writer = PyBytesWriter_Create(3);\n"
"    if (writer == NULL) {\n"
"        return NULL;\n"
"    }\n"
"\n"
"    char *str = PyBytesWriter_GetData(writer);\n"
"    memcpy(str, \"abc\", 3);\n"
"    str += 1;\n"
"    return PyBytesWriter_FinishWithPointer(writer, str);\n"
"}"
msgstr ""

#: ../../c-api/bytes.rst:497
msgid "Update ``PyBytes_FromStringAndSize()`` code"
msgstr ""

#: ../../c-api/bytes.rst:499
msgid ""
"Example of code using the soft deprecated ``PyBytes_FromStringAndSize(NULL, "
"size)`` API::"
msgstr ""

#: ../../c-api/bytes.rst:502
msgid ""
"int copy_bytes(char *dest, const char *src, Py_ssize_t num_bytes)\n"
"{\n"
"    ...\n"
"}\n"
"\n"
"PyObject* create_string(const char *start, Py_ssize_t num_bytes)\n"
"{\n"
"    PyObject *result = PyBytes_FromStringAndSize(NULL, num_bytes);\n"
"    if (result == NULL) {\n"
"        return NULL;\n"
"    }\n"
"    if (copy_bytes(PyBytes_AS_STRING(result), start, num_bytes) < 0) {\n"
"        Py_CLEAR(result);\n"
"    }\n"
"    return result;\n"
"}"
msgstr ""

#: ../../c-api/bytes.rst:519 ../../c-api/bytes.rst:556
msgid "It can now be updated to::"
msgstr ""

#: ../../c-api/bytes.rst:521
msgid ""
"PyObject* create_string(const char *start, Py_ssize_t num_bytes)\n"
"{\n"
"    PyBytesWriter *writer = PyBytesWriter_Create(num_bytes);\n"
"    if (writer == NULL) {\n"
"        return NULL;\n"
"    }\n"
"    if (copy_bytes(PyBytesWriter_GetData(writer), start, num_bytes) < 0) {\n"
"        PyBytesWriter_Discard(writer);\n"
"        return NULL;\n"
"    }\n"
"    return PyBytesWriter_Finish(writer);\n"
"}"
msgstr ""

#: ../../c-api/bytes.rst:536
msgid "Update ``_PyBytes_Resize()`` code"
msgstr ""

#: ../../c-api/bytes.rst:538
msgid "Example of code using the soft deprecated ``_PyBytes_Resize()`` API::"
msgstr ""

#: ../../c-api/bytes.rst:540
msgid ""
"void create_string(Py_ssize_t size)\n"
"{\n"
"    PyObject *bytes = PyBytes_FromStringAndSize(NULL, size);\n"
"    if (bytes == NULL) {\n"
"        return NULL;\n"
"    }\n"
"    char *str = PyBytes_AS_STRING(bytes);\n"
"\n"
"    // ... write data into str ...\n"
"\n"
"    if (_PyBytes_Resize(&bytes, (str - PyBytes_AS_STRING(bytes)))) {\n"
"        return NULL;\n"
"    }\n"
"    return bytes;\n"
"}"
msgstr ""

#: ../../c-api/bytes.rst:558
msgid ""
"void create_string(Py_ssize_t size)\n"
"{\n"
"    PyBytesWriter *writer = PyBytesWriter_Create(size);\n"
"    if (writer == NULL) {\n"
"        return NULL;\n"
"    }\n"
"    char *str = PyBytesWriter_GetData(writer);\n"
"\n"
"    // ... write data into str ...\n"
"\n"
"    return PyBytesWriter_FinishWithPointer(writer, str);\n"
"}"
msgstr ""

#: ../../c-api/bytes.rst:18
msgid "object"
msgstr "objeto"

#: ../../c-api/bytes.rst:18
msgid "bytes"
msgstr "bytes"