marshal.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:
# python-doc bot, 2025
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-10-13 19:59+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 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/marshal.rst:6
msgid "Data marshalling support"
msgstr "Suporte a *marshalling* de dados"

#: ../../c-api/marshal.rst:8
msgid ""
"These routines allow C code to work with serialized objects using the same "
"data format as the :mod:`marshal` module.  There are functions to write data "
"into the serialization format, and additional functions that can be used to "
"read the data back.  Files used to store marshalled data must be opened in "
"binary mode."
msgstr ""
"Essas rotinas permitem que o código C trabalhe com objetos serializados "
"usando o mesmo formato de dados que o módulo :mod:`marshal`. Existem funções "
"para gravar dados no formato de serialização e funções adicionais que podem "
"ser usadas para ler os dados novamente. Os arquivos usados para armazenar "
"dados empacotados devem ser abertos no modo binário."

#: ../../c-api/marshal.rst:14
msgid "Numeric values are stored with the least significant byte first."
msgstr ""
"Os valores numéricos são armazenados primeiro com o byte menos significativo."

#: ../../c-api/marshal.rst:16
msgid ""
"The module supports several versions of the data format; see the :py:mod:"
"`Python module documentation <marshal>` for details."
msgstr ""
"O módulo oferece suporte a várias versões do formato de dados; consulte a :"
"py:mod:`documentação do módulo Python <marshal>` para obter detalhes."

#: ../../c-api/marshal.rst:21
msgid "The current format version. See :py:data:`marshal.version`."
msgstr "A versão atual do formato. Veja :py:data:`marshal.version`."

#: ../../c-api/marshal.rst:25
msgid ""
"Marshal a :c:expr:`long` integer, *value*, to *file*.  This will only write "
"the least-significant 32 bits of *value*; regardless of the size of the "
"native :c:expr:`long` type.  *version* indicates the file format."
msgstr ""
"Aplica *marshalling* em um inteiro :c:expr:`long`, *value*, para *file*. "
"Isso escreverá apenas os 32 bits menos significativos de *value*; "
"independentemente do tamanho do tipo nativo :c:expr:`long`. *version* indica "
"o formato do arquivo."

#: ../../c-api/marshal.rst:29 ../../c-api/marshal.rst:43
msgid ""
"This function can fail, in which case it sets the error indicator. Use :c:"
"func:`PyErr_Occurred` to check for that."
msgstr ""
"Esta função pode falhar, caso em que define o indicador de erro. Use :c:func:"
"`PyErr_Occurred` para verificar isso."

#: ../../c-api/marshal.rst:34
msgid ""
"In Python 3.15 and earlier, this function does not set the error indicator "
"if writing to *file* fails. The same caveat applies as for :c:func:"
"`PyMarshal_WriteObjectToFile`."
msgstr ""

#: ../../c-api/marshal.rst:40
msgid ""
"Marshal a Python object, *value*, to *file*. *version* indicates the file "
"format."
msgstr ""
"Aplica *marshalling* em um objeto Python, *value*, para *file*. *version* "
"indica o formato do arquivo."

#: ../../c-api/marshal.rst:48
msgid ""
"In Python 3.15 and earlier, this function can write only part of the data to "
"*file* and return without setting the error indicator, for example if "
"*value* contains an object which cannot be marshalled or if writing to "
"*file* fails (see :gh:`155907`). Code which has to support these versions "
"cannot rely on :c:func:`PyErr_Occurred` alone to know that all the data was "
"written. It can use :c:func:`PyMarshal_WriteObjectToString` and write the "
"result itself, or validate what was written."
msgstr ""

#: ../../c-api/marshal.rst:59
msgid ""
"Return a bytes object containing the marshalled representation of *value*. "
"*version* indicates the file format."
msgstr ""
"Retorna um objeto de bytes que contém a representação pós-*marshalling* de "
"*value*. *version* indica o formato do arquivo."

#: ../../c-api/marshal.rst:63
msgid "The following functions allow marshalled values to be read back in."
msgstr ""
"As seguintes funções permitem que os valores pós-*marshalling* sejam lidos "
"novamente."

#: ../../c-api/marshal.rst:68
msgid ""
"Return a C :c:expr:`long` from the data stream in a :c:expr:`FILE*` opened "
"for reading.  Only a 32-bit value can be read in using this function, "
"regardless of the native size of :c:expr:`long`."
msgstr ""
"Retorna um :c:expr:`long` C do fluxo de dados em um :c:expr:`FILE*` aberto "
"para leitura. Somente um valor de 32 bits pode ser lido usando essa função, "
"independentemente do tamanho nativo de :c:expr:`long`."

#: ../../c-api/marshal.rst:72 ../../c-api/marshal.rst:82
msgid ""
"On error, sets the appropriate exception (:exc:`EOFError`) and returns "
"``-1``."
msgstr ""
"Em caso de erro, define a exceção apropriada (:exc:`EOFError`) e retorna "
"``-1``."

#: ../../c-api/marshal.rst:78
msgid ""
"Return a C :c:expr:`short` from the data stream in a :c:expr:`FILE*` opened "
"for reading.  Only a 16-bit value can be read in using this function, "
"regardless of the native size of :c:expr:`short`."
msgstr ""
"Retorna um :c:expr:`short` C do fluxo de dados em um :c:expr:`FILE*` aberto "
"para leitura. Somente um valor de 16 bits pode ser lido usando essa função, "
"independentemente do tamanho nativo de :c:expr:`short`."

#: ../../c-api/marshal.rst:88
msgid ""
"Return a Python object from the data stream in a :c:expr:`FILE*` opened for "
"reading."
msgstr ""
"Retorna um objeto Python do fluxo de dados em um :c:expr:`FILE*` aberto para "
"leitura."

#: ../../c-api/marshal.rst:91 ../../c-api/marshal.rst:105
#: ../../c-api/marshal.rst:114
msgid ""
"On error, sets the appropriate exception (:exc:`EOFError`, :exc:`ValueError` "
"or :exc:`TypeError`) and returns ``NULL``."
msgstr ""
"Em caso de erro, define a exceção apropriada (:exc:`EOFError`, :exc:"
"`ValueError` ou :exc:`TypeError`) e retorna ``NULL``."

#: ../../c-api/marshal.rst:97
msgid ""
"Return a Python object from the data stream in a :c:expr:`FILE*` opened for "
"reading.  Unlike :c:func:`PyMarshal_ReadObjectFromFile`, this function "
"assumes that no further objects will be read from the file, allowing it to "
"aggressively load file data into memory so that the de-serialization can "
"operate from data in memory rather than reading a byte at a time from the "
"file.  Only use this variant if you are certain that you won't be reading "
"anything else from the file."
msgstr ""
"Retorna um objeto Python do fluxo de dados em um :c:expr:`FILE*` aberto para "
"leitura. Diferentemente de :c:func:`PyMarshal_ReadObjectFromFile`, essa "
"função presume que nenhum objeto adicional será lido do arquivo, permitindo "
"que ela carregue agressivamente os dados do arquivo na memória, para que a "
"desserialização possa operar a partir de dados na memória em vez de ler um "
"byte por vez do arquivo. Use essa variante apenas se tiver certeza de que "
"não estará lendo mais nada do arquivo."

#: ../../c-api/marshal.rst:111
msgid ""
"Return a Python object from the data stream in a byte buffer containing "
"*len* bytes pointed to by *data*."
msgstr ""
"Retorna um objeto Python do fluxo de dados em um buffer de bytes contendo "
"*len* bytes apontados por *data*."