# 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:

# Gustavo Reis, 2025

# python-doc bot, 2025

# Rafael Fontenelle <rffontenelle@gmail.com>, 2025

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.14\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2025-11-11 14:15+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/allocation.rst:6

msgid "Allocating Objects on the Heap"

msgstr "Alocando objetos na heap"

#: ../../c-api/allocation.rst:17

msgid ""

"Initialize a newly allocated object *op* with its type and initial "

"reference. Returns the initialized object. Other fields of the object are "

"not initialized. Despite its name, this function is unrelated to the "

"object's :meth:`~object.__init__` method (:c:member:`~PyTypeObject.tp_init` "

"slot). Specifically, this function does **not** call the object's :meth:`!"

"__init__` method."

msgstr ""

"Inicializa um objeto *op* recém-alocado com seu tipo e referência inicial. "

"Retorna o objeto inicializado. Outros campos do objeto não são "

"inicializados. Apesar do nome, esta função não tem relação com o método :"

"meth:`~object.__init__` do objeto (slot :c:member:`~PyTypeObject.tp_init`). "

"Especificamente, esta função **não** chama o método :meth:`!__init__` do "

"objeto."

#: ../../c-api/allocation.rst:24

msgid ""

"In general, consider this function to be a low-level routine. Use :c:member:"

"`~PyTypeObject.tp_alloc` where possible. For implementing :c:member:`!"

"tp_alloc` for your type, prefer :c:func:`PyType_GenericAlloc` or :c:func:"

"`PyObject_New`."

msgstr ""

"Em geral, considere esta função como uma rotina de baixo nível. Use :c:"

"member:`~PyTypeObject.tp_alloc` sempre que possível. Para implementar :c:"

"member:`!tp_alloc` para o seu tipo, prefira :c:func:`PyType_GenericAlloc` "

"ou :c:func:`PyObject_New`."

#: ../../c-api/allocation.rst:31

msgid ""

"This function only initializes the object's memory corresponding to the "

"initial :c:type:`PyObject` structure. It does not zero the rest."

msgstr ""

"Esta função inicializa apenas a memória do objeto correspondente à estrutura "

"inicial :c:type:`PyObject`. Não zera o restante."

#: ../../c-api/allocation.rst:37

msgid ""

"This does everything :c:func:`PyObject_Init` does, and also initializes the "

"length information for a variable-size object."

msgstr ""

"Isto faz tudo que o :c:func:`PyObject_Init` faz e também inicializa a "

"informação de comprimento para um objeto de tamanho variável."

#: ../../c-api/allocation.rst:42

msgid ""

"This function only initializes some of the object's memory. It does not "

"zero the rest."

msgstr ""

"Esta função inicializa apenas parte da memória do objeto. Não zera o "

"restante."

#: ../../c-api/allocation.rst:48

msgid ""

"Allocates a new Python object using the C structure type *TYPE* and the "

"Python type object *typeobj* (``PyTypeObject*``) by calling :c:func:"

"`PyObject_Malloc` to allocate memory and initializing it like :c:func:"

"`PyObject_Init`. The caller will own the only reference to the object (i.e. "

"its reference count will be one)."

msgstr ""

"Aloca um novo objeto Python usando o tipo de estrutura C *TYPE* e o objeto "

"de tipo Python *typeobj* (``PyTypeObject*``) chamando :c:func:"

"`PyObject_Malloc` para alocar memória e inicializando-o como :c:func:"

"`PyObject_Init`. O chamador possuirá a única referência ao objeto (ou seja, "

"sua contagem de referências será um)."

#: ../../c-api/allocation.rst:54 ../../c-api/allocation.rst:107

msgid ""

"Avoid calling this directly to allocate memory for an object; call the "

"type's :c:member:`~PyTypeObject.tp_alloc` slot instead."

msgstr ""

"Evite chamar isso diretamente para alocar memória para um objeto; em vez "

"disso, chame o slot :c:member:`~PyTypeObject.tp_alloc` do tipo."

#: ../../c-api/allocation.rst:57 ../../c-api/allocation.rst:110

msgid ""

"When populating a type's :c:member:`~PyTypeObject.tp_alloc` slot, :c:func:"

"`PyType_GenericAlloc` is preferred over a custom function that simply calls "

"this macro."

msgstr ""

"Ao preencher o slot :c:member:`~PyTypeObject.tp_alloc` de um tipo, :c:func:"

"`PyType_GenericAlloc` é preferível a uma função personalizada que "

"simplesmente chama esta macro."

#: ../../c-api/allocation.rst:61

msgid ""

"This macro does not call :c:member:`~PyTypeObject.tp_alloc`, :c:member:"

"`~PyTypeObject.tp_new` (:meth:`~object.__new__`), or :c:member:"

"`~PyTypeObject.tp_init` (:meth:`~object.__init__`)."

msgstr ""

"Esta macro não chama :c:member:`~PyTypeObject.tp_alloc`, :c:member:"

"`~PyTypeObject.tp_new` (:meth:`~object.__new__`) ou :c:member:`~PyTypeObject."

"tp_init` (:meth:`~object.__init__`)."

#: ../../c-api/allocation.rst:65

msgid ""

"This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in :c:"

"member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_New` instead."

msgstr ""

"Isso não pode ser usado para objetos com :c:macro:`Py_TPFLAGS_HAVE_GC` "

"definido em :c:member:`~PyTypeObject.tp_flags`; use :c:macro:"

"`PyObject_GC_New` em vez disso."

#: ../../c-api/allocation.rst:68

msgid ""

"Memory allocated by this macro must be freed with :c:func:`PyObject_Free` "

"(usually called via the object's :c:member:`~PyTypeObject.tp_free` slot)."

msgstr ""

"A memória alocada por esta macro deve ser liberada com :c:func:"

"`PyObject_Free` (geralmente chamado por meio do slot :c:member:"

"`~PyTypeObject.tp_free` do objeto)."

#: ../../c-api/allocation.rst:73 ../../c-api/allocation.rst:123

msgid ""

"The returned memory is not guaranteed to have been completely zeroed before "

"it was initialized."

msgstr ""

"Não há garantia de que a memória retornada tenha sido completamente zerada "

"antes de ser inicializada."

#: ../../c-api/allocation.rst:78 ../../c-api/allocation.rst:128

msgid ""

"This macro does not construct a fully initialized object of the given type; "

"it merely allocates memory and prepares it for further initialization by :c:"

"member:`~PyTypeObject.tp_init`. To construct a fully initialized object, "

"call *typeobj* instead. For example::"

msgstr ""

"Esta macro não constrói um objeto totalmente inicializado do tipo fornecido; "

"ela apenas aloca memória e a prepara para inicialização posterior por :c:"

"member:`~PyTypeObject.tp_init`. Para construir um objeto totalmente "

"inicializado, chame *typeobj*. Por exemplo:"

#: ../../c-api/allocation.rst:83

msgid "PyObject *foo = PyObject_CallNoArgs((PyObject *)&PyFoo_Type);"

msgstr "PyObject *foo = PyObject_CallNoArgs((PyObject *)&PyFoo_Type);"

#: ../../c-api/allocation.rst:87 ../../c-api/allocation.rst:137

#: ../../c-api/allocation.rst:182 ../../c-api/allocation.rst:184

#: ../../c-api/allocation.rst:186

msgid ":c:func:`PyObject_Free`"

msgstr ":c:func:`PyObject_Free`"

#: ../../c-api/allocation.rst:88

msgid ":c:macro:`PyObject_GC_New`"

msgstr ":c:macro:`PyObject_GC_New`"

#: ../../c-api/allocation.rst:89 ../../c-api/allocation.rst:139

msgid ":c:func:`PyType_GenericAlloc`"

msgstr ":c:func:`PyType_GenericAlloc`"

#: ../../c-api/allocation.rst:90 ../../c-api/allocation.rst:140

msgid ":c:member:`~PyTypeObject.tp_alloc`"

msgstr ":c:member:`~PyTypeObject.tp_alloc`"

#: ../../c-api/allocation.rst:95

msgid "Like :c:macro:`PyObject_New` except:"

msgstr "Como :c:macro:`PyObject_New`, exceto que:"

#: ../../c-api/allocation.rst:97

msgid ""

"It allocates enough memory for the *TYPE* structure plus *size* "

"(``Py_ssize_t``) fields of the size given by the :c:member:`~PyTypeObject."

"tp_itemsize` field of *typeobj*."

msgstr ""

"Ela aloca memória suficiente para a estrutura *TYPE* mais os *size* "

"(``Py_ssize_t``) campos do tamanho fornecido pelo campo :c:member:"

"`~PyTypeObject.tp_itemsize` de *typeobj*."

#: ../../c-api/allocation.rst:100

msgid "The memory is initialized like :c:func:`PyObject_InitVar`."

msgstr "A memória é inicializada como :c:func:`PyObject_InitVar`."

#: ../../c-api/allocation.rst:102

msgid ""

"This is useful for implementing objects like tuples, which are able to "

"determine their size at construction time. Embedding the array of fields "

"into the same allocation decreases the number of allocations, improving the "

"memory management efficiency."

msgstr ""

"Isso é útil para implementar objetos como tuplas, que conseguem determinar "

"seu tamanho em tempo de construção. Incorporar o vetor de campos na mesma "

"alocação diminui o número de alocações, melhorando a eficiência do "

"gerenciamento de memória."

#: ../../c-api/allocation.rst:114

msgid ""

"This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in :c:"

"member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_NewVar` instead."

msgstr ""

"Isso não pode ser usado para objetos com :c:macro:`Py_TPFLAGS_HAVE_GC` "

"definido em :c:member:`~PyTypeObject.tp_flags`; use :c:macro:"

"`PyObject_GC_NewVar` em vez disso."

#: ../../c-api/allocation.rst:118

msgid ""

"Memory allocated by this function must be freed with :c:func:`PyObject_Free` "

"(usually called via the object's :c:member:`~PyTypeObject.tp_free` slot)."

msgstr ""

"A memória alocada por esta função deve ser liberada com :c:func:"

"`PyObject_Free` (geralmente chamado por meio do slot :c:member:"

"`~PyTypeObject.tp_free` do objeto)."

#: ../../c-api/allocation.rst:133

msgid ""

"PyObject *list_instance = PyObject_CallNoArgs((PyObject *)&PyList_Type);"

msgstr ""

"PyObject *list_instance = PyObject_CallNoArgs((PyObject *)&PyList_Type);"

#: ../../c-api/allocation.rst:138

msgid ":c:macro:`PyObject_GC_NewVar`"

msgstr ":c:macro:`PyObject_GC_NewVar`"

#: ../../c-api/allocation.rst:145

msgid ""

"Object which is visible in Python as ``None``. This should only be accessed "

"using the :c:macro:`Py_None` macro, which evaluates to a pointer to this "

"object."

msgstr ""

"Objeto o qual é visível no Python como ``None``. Isto só deve ser acessado "

"usando a macro :c:macro:`Py_None`, o qual avalia como um ponteiro para este "

"objeto."

#: ../../c-api/allocation.rst:152

msgid ":ref:`moduleobjects`"

msgstr ":ref:`moduleobjects`"

#: ../../c-api/allocation.rst:153

msgid "To allocate and create extension modules."

msgstr "Para alocar e criar módulos de extensão."

#: ../../c-api/allocation.rst:157

msgid "Deprecated aliases"

msgstr "Apelidos descontinuados"

#: ../../c-api/allocation.rst:159

msgid ""

"These are :term:`soft deprecated` aliases to existing functions and macros. "

"They exist solely for backwards compatibility."

msgstr ""

"Esses são apelidos :term:`suavemente descontinuados <suavemente "

"descontinuado>` para funções e macros existentes. Eles existem unicamente "

"para fins de retrocompatibilidade."

#: ../../c-api/allocation.rst:167

msgid "Deprecated alias"

msgstr "Apelido descontinuado"

#: ../../c-api/allocation.rst:168

msgid "Function"

msgstr "Função"

#: ../../c-api/allocation.rst:170

msgid ":c:macro:`PyObject_New`"

msgstr ":c:macro:`PyObject_New`"

#: ../../c-api/allocation.rst:172

msgid ":c:macro:`PyObject_NewVar`"

msgstr ":c:macro:`PyObject_NewVar`"

#: ../../c-api/allocation.rst:174

msgid ":c:func:`PyObject_Init`"

msgstr ":c:func:`PyObject_Init`"

#: ../../c-api/allocation.rst:176

msgid ":c:func:`PyObject_InitVar`"

msgstr ":c:func:`PyObject_InitVar`"

#: ../../c-api/allocation.rst:178

msgid ":c:func:`PyObject_Malloc`"

msgstr ":c:func:`PyObject_Malloc`"

#: ../../c-api/allocation.rst:180

msgid ":c:func:`PyObject_Realloc`"

msgstr ":c:func:`PyObject_Realloc`"