# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2025, 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

# Rainer Terroso, 2025

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

#

#, fuzzy

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2025-11-23 14:59+0000\n"

"PO-Revision-Date: 2025-09-15 01:03+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"

"Language: pt_BR\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % "

"1000000 == 0 ? 1 : 2;\n"

#: ../../extending/newtypes_tutorial.rst:7

msgid "Defining Extension Types: Tutorial"

msgstr "Definindo Tipos de Extensão: Tutorial"

#: ../../extending/newtypes_tutorial.rst:14

msgid ""

"Python allows the writer of a C extension module to define new types that "

"can be manipulated from Python code, much like the built-in :class:`str` "

"and :class:`list` types. The code for all extension types follows a "

"pattern, but there are some details that you need to understand before you "

"can get started. This document is a gentle introduction to the topic."

msgstr ""

"O Python permite que o desenvolvedor de um módulo de extensão em C defina "

"novos tipos que podem ser manipulados a partir do código Python, da mesma "

"forma que os tipos embutidos :class:`str` e :class:`list`. O código para de "

"todos tipos de extensão segue um padrão, mas há alguns detalhes que você "

"precisa entender antes de começar. Este documento é uma introdução suave ao "

"tópico."

#: ../../extending/newtypes_tutorial.rst:24

msgid "The Basics"

msgstr "O básico"

#: ../../extending/newtypes_tutorial.rst:26

msgid ""

"The :term:`CPython` runtime sees all Python objects as variables of type :c:"

"expr:`PyObject*`, which serves as a \"base type\" for all Python objects. "

"The :c:type:`PyObject` structure itself only contains the object's :term:"

"`reference count` and a pointer to the object's \"type object\". This is "

"where the action is; the type object determines which (C) functions get "

"called by the interpreter when, for instance, an attribute gets looked up on "

"an object, a method called, or it is multiplied by another object. These C "

"functions are called \"type methods\"."

msgstr ""

"O tempo de execução do :term:`CPython` trata todos os objetos Python como "

"variáveis do tipo :c:expr:`PyObject*`, que funciona como um “tipo base” para "

"todos os objetos Python. A estrutura :c:type:`PyObject` em si contém apenas "

"a :term:`contagem de referências` do objeto e um ponteiro para o “objeto de "

"tipo” correspondente. É nesse objeto de tipo que tudo acontece: ele "

"determina quais funções em C o interpretador chama quando, por exemplo, um "

"atributo é acessado em um objeto, um método é chamado ou o objeto é "

"multiplicado por outro. Essas funções em C são chamadas de “métodos de tipo”."

#: ../../extending/newtypes_tutorial.rst:35

msgid ""

"So, if you want to define a new extension type, you need to create a new "

"type object."

msgstr ""

"Então, se você quiser definir um novo tipo de extensão, você precisa criar "

"um novo objeto de tipo."

#: ../../extending/newtypes_tutorial.rst:38

msgid ""

"This sort of thing can only be explained by example, so here's a minimal, "

"but complete, module that defines a new type named :class:`!Custom` inside a "

"C extension module :mod:`!custom`:"

msgstr ""

"Esse tipo de coisa só pode ser explicado com exemplo, então aqui está um "

"módulo mínimo, mas completo, que define um novo tipo nomeado :class:`!"

"Custom` dentro de um módulo de extensão C :mod:`!custom`:"

#: ../../extending/newtypes_tutorial.rst:43

msgid ""

"What we're showing here is the traditional way of defining *static* "

"extension types. It should be adequate for most uses. The C API also "

"allows defining heap-allocated extension types using the :c:func:"

"`PyType_FromSpec` function, which isn't covered in this tutorial."

msgstr ""

"O que estamos mostrando aqui é a maneira tradicional de definir tipos de "

"extensão *estáticos*. Deve ser adequada para a maioria dos usos. A API C "

"também permite definir tipos de extensão alocados em heap usando a função :c:"

"func:`PyType_FromSpec`, que não é abordada neste tutorial."

#: ../../extending/newtypes_tutorial.rst:48

msgid ""

"#define PY_SSIZE_T_CLEAN\n"

"#include <Python.h>\n"

"\n"

"typedef struct {\n"

" PyObject_HEAD\n"

" /* Type-specific fields go here. */\n"

"} CustomObject;\n"

"\n"

"static PyTypeObject CustomType = {\n"

" .ob_base = PyVarObject_HEAD_INIT(NULL, 0)\n"

" .tp_name = \"custom.Custom\",\n"

" .tp_doc = PyDoc_STR(\"Custom objects\"),\n"

" .tp_basicsize = sizeof(CustomObject),\n"

" .tp_itemsize = 0,\n"

" .tp_flags = Py_TPFLAGS_DEFAULT,\n"

" .tp_new = PyType_GenericNew,\n"

"};\n"

"\n"

"static int\n"

"custom_module_exec(PyObject *m)\n"

"{\n"

" if (PyType_Ready(&CustomType) < 0) {\n"

" return -1;\n"

" }\n"

"\n"

" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) "

"{\n"

" return -1;\n"

" }\n"

"\n"

" return 0;\n"

"}\n"

"\n"

"static PyModuleDef_Slot custom_module_slots[] = {\n"

" {Py_mod_exec, custom_module_exec},\n"

" // Just use this while using static types\n"

" {Py_mod_multiple_interpreters, "

"Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED},\n"

" {0, NULL}\n"

"};\n"

"\n"

"static PyModuleDef custom_module = {\n"

" .m_base = PyModuleDef_HEAD_INIT,\n"

" .m_name = \"custom\",\n"

" .m_doc = \"Example module that creates an extension type.\",\n"

" .m_size = 0,\n"

" .m_slots = custom_module_slots,\n"

"};\n"

"\n"

"PyMODINIT_FUNC\n"

"PyInit_custom(void)\n"

"{\n"

" return PyModuleDef_Init(&custom_module);\n"

"}\n"

msgstr ""

"#define PY_SSIZE_T_CLEAN\n"

"#include <Python.h>\n"

"\n"

"typedef struct {\n"

" PyObject_HEAD\n"

" /* Campos específico do tipo vão aqui. */\n"

"} CustomObject;\n"

"\n"

"static PyTypeObject CustomType = {\n"

" .ob_base = PyVarObject_HEAD_INIT(NULL, 0)\n"

" .tp_name = \"custom.Custom\",\n"

" .tp_doc = PyDoc_STR(\"Custom objects\"),\n"

" .tp_basicsize = sizeof(CustomObject),\n"

" .tp_itemsize = 0,\n"

" .tp_flags = Py_TPFLAGS_DEFAULT,\n"

" .tp_new = PyType_GenericNew,\n"

"};\n"

"\n"

"static int\n"

"custom_module_exec(PyObject *m)\n"

"{\n"

" if (PyType_Ready(&CustomType) < 0) {\n"

" return -1;\n"

" }\n"

"\n"

" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) "

"{\n"

" return -1;\n"

" }\n"

"\n"

" return 0;\n"

"}\n"

"\n"

"static PyModuleDef_Slot custom_module_slots[] = {\n"

" {Py_mod_exec, custom_module_exec},\n"

" // Só use isso quando estiver usando tipos estáticos\n"

" {Py_mod_multiple_interpreters, "

"Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED},\n"

" {0, NULL}\n"

"};\n"

"\n"

"static PyModuleDef custom_module = {\n"

" .m_base = PyModuleDef_HEAD_INIT,\n"

" .m_name = \"custom\",\n"

" .m_doc = \"Example module that creates an extension type.\",\n"

" .m_size = 0,\n"

" .m_slots = custom_module_slots,\n"

"};\n"

"\n"

"PyMODINIT_FUNC\n"

"PyInit_custom(void)\n"

"{\n"

" return PyModuleDef_Init(&custom_module);\n"

"}\n"

#: ../../extending/newtypes_tutorial.rst:50

msgid ""

"Now that's quite a bit to take in at once, but hopefully bits will seem "

"familiar from the previous chapter. This file defines three things:"

msgstr ""

"Isso é bastante informação para assimilar de uma só vez, mas algumas partes "

"devem parecer familiares pelo que foi visto no capítulo anterior. Este "

"arquivo define três elementos:"

#: ../../extending/newtypes_tutorial.rst:53

msgid ""

"What a :class:`!Custom` **object** contains: this is the ``CustomObject`` "

"struct, which is allocated once for each :class:`!Custom` instance."

msgstr ""

"O que um **objeto** :class:`!Custom` contém: esta é uma estrutura "

"``CustomObject``, alocada uma vez para cada instância de :class:`!Custom`."

#: ../../extending/newtypes_tutorial.rst:55

msgid ""

"How the :class:`!Custom` **type** behaves: this is the ``CustomType`` "

"struct, which defines a set of flags and function pointers that the "

"interpreter inspects when specific operations are requested."

msgstr ""

"Como o **tipo** :class:`!Custom` se comporta: esta é a estrutura "

"``CustomType``, que define um conjunto de sinalizadores e ponteiros de "

"função que o interpretador inspeciona quando operações específicas são "

"solicitadas."

#: ../../extending/newtypes_tutorial.rst:58

msgid ""

"How to define and execute the :mod:`!custom` module: this is the "

"``PyInit_custom`` function and the associated ``custom_module`` struct for "

"defining the module, and the ``custom_module_exec`` function to set up a "

"fresh module object."

msgstr ""

"Como definir e executar o módulo :mod:`!custom`: esta é a função "

"``PyInit_custom`` e a estrutura associada ``custom_module`` para definir o "

"módulo, e a função ``custom_module_exec`` para configurar um novo objeto de "

"módulo."

#: ../../extending/newtypes_tutorial.rst:63

msgid "The first bit is::"

msgstr "O primeiro bit é ::"

#: ../../extending/newtypes_tutorial.rst:65

msgid ""

"typedef struct {\n"

" PyObject_HEAD\n"

"} CustomObject;"

msgstr ""

"typedef struct {\n"

" PyObject_HEAD\n"

"} CustomObject;"

#: ../../extending/newtypes_tutorial.rst:69

msgid ""

"This is what a Custom object will contain. ``PyObject_HEAD`` is mandatory "

"at the start of each object struct and defines a field called ``ob_base`` of "

"type :c:type:`PyObject`, containing a pointer to a type object and a "

"reference count (these can be accessed using the macros :c:macro:`Py_TYPE` "

"and :c:macro:`Py_REFCNT` respectively). The reason for the macro is to "

"abstract away the layout and to enable additional fields in :ref:`debug "

"builds <debug-build>`."

msgstr ""

"Isto é o que um objeto Custom conterá. ``PyObject_HEAD`` é obrigatório no "

"início de cada estrutura de objeto e define um campo chamado ``ob_base`` do "

"tipo :c:type:`PyObject`, contendo um ponteiro para um objeto de tipo e uma "

"contagem de referências (esses podem ser acessados usando os macros :c:macro:"

"`Py_TYPE` e :c:macro:`Py_REFCNT`, respectivamente). O objetivo do macro é "

"abstrair o layout e permitir campos adicionais em :ref:`construções de "

"depuração <debug-build>`."

#: ../../extending/newtypes_tutorial.rst:78

msgid ""

"There is no semicolon above after the :c:macro:`PyObject_HEAD` macro. Be "

"wary of adding one by accident: some compilers will complain."

msgstr ""

"Não há ponto e vírgula acima após o macro :c:macro:`PyObject_HEAD`. Tenha "

"cuidado para não adicionar um por engano: alguns compiladores podem emitir "

"erros."

#: ../../extending/newtypes_tutorial.rst:81

msgid ""

"Of course, objects generally store additional data besides the standard "

"``PyObject_HEAD`` boilerplate; for example, here is the definition for "

"standard Python floats::"

msgstr ""

"Obviamente, objetos geralmente armazenam dados adicionais além do padrão "

"``PyObject_HEAD`` boilerplate; por exemplo, aqui está a definição do padrão "

"Python floats::"

#: ../../extending/newtypes_tutorial.rst:85

msgid ""

"typedef struct {\n"

" PyObject_HEAD\n"

" double ob_fval;\n"

"} PyFloatObject;"

msgstr ""

"typedef struct {\n"

" PyObject_HEAD\n"

" double ob_fval;\n"

"} PyFloatObject;"

#: ../../extending/newtypes_tutorial.rst:90

msgid "The second bit is the definition of the type object. ::"

msgstr "O segundo bit é a definição do objeto de tipo. ::"

#: ../../extending/newtypes_tutorial.rst:92

msgid ""

"static PyTypeObject CustomType = {\n"

" .ob_base = PyVarObject_HEAD_INIT(NULL, 0)\n"

" .tp_name = \"custom.Custom\",\n"

" .tp_doc = PyDoc_STR(\"Custom objects\"),\n"

" .tp_basicsize = sizeof(CustomObject),\n"

" .tp_itemsize = 0,\n"

" .tp_flags = Py_TPFLAGS_DEFAULT,\n"

" .tp_new = PyType_GenericNew,\n"

"};"

msgstr ""

"estático PyTypeObject CustomType = {\n"

" .ob_base = PyVarObject_HEAD_INIT(NULL, 0)\n"

" .tp_name = \"custom.Custom\",\n"

" .tp_doc = PyDoc_STR(\"Custom objeto\"),\n"

" .tp_basicsize = sizeof(CustomObject),\n"

" .tp_itemsize = 0,\n"

" .tp_flags = Py_TPFLAGS_DEFAULT,\n"

" .tp_new = PyType_GenericNew,\n"

"};"

#: ../../extending/newtypes_tutorial.rst:103

msgid ""

"We recommend using C99-style designated initializers as above, to avoid "

"listing all the :c:type:`PyTypeObject` fields that you don't care about and "

"also to avoid caring about the fields' declaration order."

msgstr ""

"Recomendamos usar inicializadores nomeados no estilo C99, como mostrado "

"acima, para evitar listar todos os campos de :c:type:`PyTypeObject` com os "

"quais você não precisa se preocupar e também para não depender da ordem de "

"declaração desses campos"

#: ../../extending/newtypes_tutorial.rst:107

msgid ""

"The actual definition of :c:type:`PyTypeObject` in :file:`object.h` has many "

"more :ref:`fields <type-structs>` than the definition above. The remaining "

"fields will be filled with zeros by the C compiler, and it's common practice "

"to not specify them explicitly unless you need them."

msgstr ""

"A definição real de :c:type:`PyTypeObject` no :file:`object.h` possui muito "

"mais :ref:`campos <type-structs>` do que a definição acima. Os campos "

"restantes serão preenchidos com zeros pelo compilador C, e é prática comum "

"não especificá-los explicitamente, a menos que sejam necessários."

#: ../../extending/newtypes_tutorial.rst:112

msgid "We're going to pick it apart, one field at a time::"

msgstr "Vamos separá-lo, um campo de cada vez ::"

#: ../../extending/newtypes_tutorial.rst:114

msgid ".ob_base = PyVarObject_HEAD_INIT(NULL, 0)"

msgstr ".ob_base = PyVarObject_HEAD_INIT(NULL, 0)"

#: ../../extending/newtypes_tutorial.rst:116

msgid ""

"This line is mandatory boilerplate to initialize the ``ob_base`` field "

"mentioned above. ::"

msgstr ""

"Essa linha é um boilerplate obrigatório para inicializar o campo ``ob_base`` "

"mencionado acima. ::"

#: ../../extending/newtypes_tutorial.rst:119

msgid ".tp_name = \"custom.Custom\","

msgstr ".tp_name = \"custom.Custom\","

#: ../../extending/newtypes_tutorial.rst:121

msgid ""

"The name of our type. This will appear in the default textual "

"representation of our objects and in some error messages, for example:"

msgstr ""

"O nome do nosso tipo. Ele aparecerá na representação textual padrão do "

"nosso objeto e em algumas mensagens erro, por exemplo:"

#: ../../extending/newtypes_tutorial.rst:124

msgid ""

">>> \"\" + custom.Custom()\n"

"Traceback (most recent call last):\n"

" File \"<stdin>\", line 1, in <module>\n"

"TypeError: can only concatenate str (not \"custom.Custom\") to str"

msgstr ""

">>> \"\" + custom.Custom()\n"

"Traceback (most recent call last):\n"

" File \"<stdin>\", line 1, in <module>\n"

"TypeError: can only concatenate str (not \"custom.Custom\") to str"

#: ../../extending/newtypes_tutorial.rst:131

msgid ""

"Note that the name is a dotted name that includes both the module name and "

"the name of the type within the module. The module in this case is :mod:`!"

"custom` and the type is :class:`!Custom`, so we set the type name to :class:"

"`!custom.Custom`. Using the real dotted import path is important to make "

"your type compatible with the :mod:`pydoc` and :mod:`pickle` modules. ::"

msgstr ""

"Observe que o nome é um nome pontilhado que inclui o nome módulo e o nome do "

"tipo dentro do módulo. O módulo, neste caso, é :mod:`!custom` e o tipo é :"

"class:`!Custom`, portanto, definimos o nome do tipo como :class:`!custom."

"Custom`. O uso do pontilhado real caminho de importação é importante para "

"tornar seu tipo compatível com o :mod:`pydoc` e os módulos :mod:`pickle`. ::"

#: ../../extending/newtypes_tutorial.rst:137

msgid ""

".tp_basicsize = sizeof(CustomObject),\n"

".tp_itemsize = 0,"

msgstr ""

".tp_basicsize = sizeof(CustomObject),\n"

".tp_itemsize = 0,"

#: ../../extending/newtypes_tutorial.rst:140

msgid ""

"This is so that Python knows how much memory to allocate when creating new :"

"class:`!Custom` instances. :c:member:`~PyTypeObject.tp_itemsize` is only "

"used for variable-sized objects and should otherwise be zero."

msgstr ""

"Isso serve para que o Python saiba quanta memória deve ser alocada ao criar "

"novas instâncias do :class:`!Custom`. O :c:member:`~PyTypeObject."

"tp_itemsize` é usado somente para objeto de tamanho variável e, caso "

"contrário, deve ser zero."

#: ../../extending/newtypes_tutorial.rst:146

msgid ""

"If you want your type to be subclassable from Python, and your type has the "

"same :c:member:`~PyTypeObject.tp_basicsize` as its base type, you may have "

"problems with multiple inheritance. A Python subclass of your type will "

"have to list your type first in its :attr:`~type.__bases__`, or else it will "

"not be able to call your type's :meth:`~object.__new__` method without "

"getting an error. You can avoid this problem by ensuring that your type has "

"a larger value for :c:member:`~PyTypeObject.tp_basicsize` than its base type "

"does. Most of the time, this will be true anyway, because either your base "

"type will be :class:`object`, or else you will be adding data members to "

"your base type, and therefore increasing its size."

msgstr ""

"Se você quiser que seu tipo possa ser subclassificado a partir do Python, e "

"seu tipo tiver o mesmo :c:member:`~PyTypeObject.tp_basicsize` que seu tipo "

"base, você poderá ter problemas com herança múltipla. Uma subclasse Python "

"do seu tipo terá de listar o seu tipo primeiro em :attr:`~type.__bases__`, "

"caso contrário ela não conseguirá chamar o método :meth:`~object.__new__` do "

"seu tipo sem gerar um erro. Você pode evitar esse problema garantindo que "

"seu tipo tenha um valor de :c:member:`~PyTypeObject.tp_basicsize` maior que "

"o do tipo base. Na maior parte do tempo, isso já será verdadeiro, pois ou o "

"tipo base será :class:`object`, ou você estará adicionando membros de dados "

"ao seu tipo base e, portanto, aumentando seu tamanho."

#: ../../extending/newtypes_tutorial.rst:156

msgid "We set the class flags to :c:macro:`Py_TPFLAGS_DEFAULT`. ::"

msgstr ""

"Definimos os sinalizadores da classe como :c:macro:`Py_TPFLAGS_DEFAULT`. ::"

#: ../../extending/newtypes_tutorial.rst:158

msgid ".tp_flags = Py_TPFLAGS_DEFAULT,"

msgstr ".tp_flags = Py_TPFLAGS_DEFAULT,"

#: ../../extending/newtypes_tutorial.rst:160

msgid ""

"All types should include this constant in their flags. It enables all of "

"the members defined until at least Python 3.3. If you need further members, "

"you will need to OR the corresponding flags."

msgstr ""

"Todos os tipos devem incluir essa constante em seus sinalizadores. Ela "

"habilita todos os membros definidos até pelo menos o Python 3.3. Se você "

"precisar de membros adicionais, será necessário fazer um OR com os "

"sinalizadores correspondentes."

#: ../../extending/newtypes_tutorial.rst:164

msgid ""

"We provide a doc string for the type in :c:member:`~PyTypeObject.tp_doc`. ::"

msgstr ""

"Fornecemos uma docstring para o tipo em tp_doc :c:member:`~PyTypeObject."

"tp_doc`. ::"

#: ../../extending/newtypes_tutorial.rst:166

msgid ".tp_doc = PyDoc_STR(\"Custom objects\"),"

msgstr ".tp_doc = PyDoc_STR(\"Custom objects\"),"

#: ../../extending/newtypes_tutorial.rst:168

msgid ""

"To enable object creation, we have to provide a :c:member:`~PyTypeObject."

"tp_new` handler. This is the equivalent of the Python method :meth:`~object."

"__new__`, but has to be specified explicitly. In this case, we can just use "

"the default implementation provided by the API function :c:func:"

"`PyType_GenericNew`. ::"

msgstr ""

"Para habilitar a criação de objetos, precisamos fornecer um manipulador "

"para :c:member:`~PyTypeObject.tp_new`. Esse é o equivalente ao método "

"Python :meth:`~object.__new__`, mas precisa ser especificado explicitamente. "

"Neste caso, podemos simplesmente usar a implementação padrão fornecida pela "

"função da API :c:func:`PyType_GenericNew`. ::"

#: ../../extending/newtypes_tutorial.rst:173

msgid ".tp_new = PyType_GenericNew,"

msgstr ".tp_new = PyType_GenericNew,"

#: ../../extending/newtypes_tutorial.rst:175

msgid ""

"Everything else in the file should be familiar, except for some code in :c:"

"func:`!custom_module_exec`::"

msgstr ""

"Todo o restante do arquivo deve ser familiar, exceto por alguns códigos em :"

"c:func:`!custom_module_exec`::"

#: ../../extending/newtypes_tutorial.rst:178

msgid ""

"if (PyType_Ready(&CustomType) < 0) {\n"

" return -1;\n"

"}"

msgstr ""

"se (PyType_Ready(&CustomType) < 0) {\n"

" retorno -1;\n"

"}"

#: ../../extending/newtypes_tutorial.rst:182

msgid ""

"This initializes the :class:`!Custom` type, filling in a number of members "

"to the appropriate default values, including :c:member:`~PyObject.ob_type` "

"that we initially set to ``NULL``. ::"

msgstr ""

"Isso inicializa o tipo :class:`!Custom`, preenchendo vários membros com os "

"valores padrão apropriados, incluindo :c:member:`~PyObject.ob_type`, que "

"definimos inicialmente como ``NULL``. ::"

#: ../../extending/newtypes_tutorial.rst:186

msgid ""

"if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) {\n"

" return -1;\n"

"}"

msgstr ""

"if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) {\n"

"return -1;\n"

"}"

#: ../../extending/newtypes_tutorial.rst:190

msgid ""

"This adds the type to the module dictionary. This allows us to create :"

"class:`!Custom` instances by calling the :class:`!Custom` class:"

msgstr ""

"Isso adiciona o tipo ao dicionário do módulo.\n"

"Isso nos permite criar instâncias de :class:`!Custom` chamando a classe :"

"class:`!Custom`:"

#: ../../extending/newtypes_tutorial.rst:193

msgid ""

">>> import custom\n"

">>> mycustom = custom.Custom()"

msgstr ""

">>> import custom\n"

">>> mycustom = custom.Custom()"

#: ../../extending/newtypes_tutorial.rst:198

msgid ""

"That's it! All that remains is to build it; put the above code in a file "

"called :file:`custom.c`,"

msgstr ""

"É isso! Só resta compilá-lo; coloque o código acima em um arquivo chamado :"

"file:`custom.c`,"

#: ../../extending/newtypes_tutorial.rst:201

msgid ""

"[build-system]\n"

"requires = [\"setuptools\"]\n"

"build-backend = \"setuptools.build_meta\"\n"

"\n"

"[project]\n"

"name = \"custom\"\n"

"version = \"1\"\n"

msgstr ""

"[build-system]\n"

"requires = [\"setuptools\"]\n"

"build-backend = \"setuptools.build_meta\"\n"

"\n"

"[project]\n"

"name = \"custom\"\n"

"version = \"1\"\n"

#: ../../extending/newtypes_tutorial.rst:203

msgid "in a file called :file:`pyproject.toml`, and"

msgstr "Em um arquivo chamado :file:`pyproject.toml`, e"

#: ../../extending/newtypes_tutorial.rst:205

msgid ""

"from setuptools import Extension, setup\n"

"setup(ext_modules=[Extension(\"custom\", [\"custom.c\"])])"

msgstr ""

"from setuptools import Extension, setup\n"

"setup(ext_modules=[Extension(\"custom\", [\"custom.c\"])])"

#: ../../extending/newtypes_tutorial.rst:210

msgid "in a file called :file:`setup.py`; then typing"

msgstr "Em um arquivo chamado :file:`setup.py`; e então digitando"

#: ../../extending/newtypes_tutorial.rst:212

#: ../../extending/newtypes_tutorial.rst:527

msgid "$ python -m pip install ."

msgstr "$ python -m pip install ."

#: ../../extending/newtypes_tutorial.rst:216

msgid ""

"in a shell should produce a file :file:`custom.so` in a subdirectory and "

"install it; now fire up Python --- you should be able to ``import custom`` "

"and play around with ``Custom`` objects."

msgstr ""

"no console deverá gerar um arquivo :file:`custom.so` em um subdiretório e "

"instalá-lo; agora abra o Python — você já deve conseguir ``import custom`` e "

"experimentar objetos ``Custom``."

#: ../../extending/newtypes_tutorial.rst:220

msgid "That wasn't so hard, was it?"

msgstr "Isso não foi tão difícil, foi?"

#: ../../extending/newtypes_tutorial.rst:222

msgid ""

"Of course, the current Custom type is pretty uninteresting. It has no data "

"and doesn't do anything. It can't even be subclassed."

msgstr ""

"Naturalmente, o tipo Custom atual é bastante desinteressante. Não tem dados "

"e não faz nada. Não pode nem ser subclassificado."

#: ../../extending/newtypes_tutorial.rst:227

msgid "Adding data and methods to the Basic example"

msgstr "Adicionando dados e métodos ao exemplo básico"

#: ../../extending/newtypes_tutorial.rst:229

msgid ""

"Let's extend the basic example to add some data and methods. Let's also "

"make the type usable as a base class. We'll create a new module, :mod:`!"

"custom2` that adds these capabilities:"

msgstr ""

"Vamos estender o exemplo básico para adicionar alguns dados e métodos. "

"Também vamos tornar o tipo utilizável como uma classe base. Iremos criar um "

"novo módulo, :mod:`!custom2`, que adiciona esses recursos:"

#: ../../extending/newtypes_tutorial.rst:233

msgid ""

"#define PY_SSIZE_T_CLEAN\n"

"#include <Python.h>\n"

"#include <stddef.h> /* for offsetof() */\n"

"\n"

"typedef struct {\n"

" PyObject_HEAD\n"

" PyObject *first; /* first name */\n"

" PyObject *last; /* last name */\n"

" int number;\n"

"} CustomObject;\n"

"\n"

"static void\n"

"Custom_dealloc(CustomObject *self)\n"

"{\n"

" Py_XDECREF(self->first);\n"

" Py_XDECREF(self->last);\n"

" Py_TYPE(self)->tp_free((PyObject *) self);\n"

"}\n"

"\n"

"static PyObject *\n"

"Custom_new(PyTypeObject *type, PyObject *args, PyObject *kwds)\n"

"{\n"

" CustomObject *self;\n"

" self = (CustomObject *) type->tp_alloc(type, 0);\n"

" if (self != NULL) {\n"

" self->first = PyUnicode_FromString(\"\");\n"

" if (self->first == NULL) {\n"

" Py_DECREF(self);\n"

" return NULL;\n"

" }\n"

" self->last = PyUnicode_FromString(\"\");\n"

" if (self->last == NULL) {\n"

" Py_DECREF(self);\n"

" return NULL;\n"

" }\n"

" self->number = 0;\n"

" }\n"

" return (PyObject *) self;\n"

"}\n"

"\n"

"static int\n"

"Custom_init(CustomObject *self, PyObject *args, PyObject *kwds)\n"

"{\n"

" static char *kwlist[] = {\"first\", \"last\", \"number\", NULL};\n"

" PyObject *first = NULL, *last = NULL;\n"

"\n"

" if (!PyArg_ParseTupleAndKeywords(args, kwds, \"|OOi\", kwlist,\n"

" &first, &last,\n"

" &self->number))\n"

" return -1;\n"

"\n"

" if (first) {\n"

" Py_XSETREF(self->first, Py_NewRef(first));\n"

" }\n"

" if (last) {\n"

" Py_XSETREF(self->last, Py_NewRef(last));\n"

" }\n"

" return 0;\n"

"}\n"

"\n"

"static PyMemberDef Custom_members[] = {\n"

" {\"first\", Py_T_OBJECT_EX, offsetof(CustomObject, first), 0,\n"

" \"first name\"},\n"

" {\"last\", Py_T_OBJECT_EX, offsetof(CustomObject, last), 0,\n"

" \"last name\"},\n"

" {\"number\", Py_T_INT, offsetof(CustomObject, number), 0,\n"

" \"custom number\"},\n"

" {NULL} /* Sentinel */\n"

"};\n"

"\n"

"static PyObject *\n"

"Custom_name(CustomObject *self, PyObject *Py_UNUSED(ignored))\n"

"{\n"

" if (self->first == NULL) {\n"

" PyErr_SetString(PyExc_AttributeError, \"first\");\n"

" return NULL;\n"

" }\n"

" if (self->last == NULL) {\n"

" PyErr_SetString(PyExc_AttributeError, \"last\");\n"

" return NULL;\n"

" }\n"

" return PyUnicode_FromFormat(\"%S %S\", self->first, self->last);\n"

"}\n"

"\n"

"static PyMethodDef Custom_methods[] = {\n"

" {\"name\", (PyCFunction) Custom_name, METH_NOARGS,\n"

" \"Return the name, combining the first and last name\"\n"

" },\n"

" {NULL} /* Sentinel */\n"

"};\n"

"\n"

"static PyTypeObject CustomType = {\n"

" .ob_base = PyVarObject_HEAD_INIT(NULL, 0)\n"

" .tp_name = \"custom2.Custom\",\n"

" .tp_doc = PyDoc_STR(\"Custom objects\"),\n"

" .tp_basicsize = sizeof(CustomObject),\n"

" .tp_itemsize = 0,\n"

" .tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,\n"

" .tp_new = Custom_new,\n"

" .tp_init = (initproc) Custom_init,\n"

" .tp_dealloc = (destructor) Custom_dealloc,\n"

" .tp_members = Custom_members,\n"

" .tp_methods = Custom_methods,\n"

"};\n"

"\n"

"static int\n"

"custom_module_exec(PyObject *m)\n"

"{\n"

" if (PyType_Ready(&CustomType) < 0) {\n"

" return -1;\n"

" }\n"

"\n"

" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) "

"{\n"

" return -1;\n"

" }\n"

"\n"

" return 0;\n"

"}\n"

"\n"

"static PyModuleDef_Slot custom_module_slots[] = {\n"

" {Py_mod_exec, custom_module_exec},\n"

" {Py_mod_multiple_interpreters, "

"Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED},\n"

" {0, NULL}\n"

"};\n"

"\n"

"static PyModuleDef custom_module = {\n"

" .m_base = PyModuleDef_HEAD_INIT,\n"

" .m_name = \"custom2\",\n"

" .m_doc = \"Example module that creates an extension type.\",\n"

" .m_size = 0,\n"

" .m_slots = custom_module_slots,\n"

"};\n"

"\n"

"PyMODINIT_FUNC\n"

"PyInit_custom2(void)\n"

"{\n"

" return PyModuleDef_Init(&custom_module);\n"

"}\n"

msgstr ""

#: ../../extending/newtypes_tutorial.rst:236

msgid "This version of the module has a number of changes."

msgstr "Esta versão do módulo possui várias alterações."

#: ../../extending/newtypes_tutorial.rst:238

msgid ""

"The :class:`!Custom` type now has three data attributes in its C struct, "

"*first*, *last*, and *number*. The *first* and *last* variables are Python "

"strings containing first and last names. The *number* attribute is a C "

"integer."

msgstr ""

"O tipo :class:`!Custom` agora possui três atributos de dados em sua "

"estrutura C: first, last e number. As variáveis first e last são strings "

"Python contendo o primeiro e o último nome. O atributo number é um inteiro "

"em C."

#: ../../extending/newtypes_tutorial.rst:242

msgid "The object structure is updated accordingly::"

msgstr "A estrutura do objeto é atualizada de acordo ::"

#: ../../extending/newtypes_tutorial.rst:244

msgid ""

"typedef struct {\n"

" PyObject_HEAD\n"

" PyObject *first; /* first name */\n"

" PyObject *last; /* last name */\n"

" int number;\n"

"} CustomObject;"

msgstr ""

"typedef struct {\n"

"PyObject_HEAD\n"

"PyObject *first; /* first name */\n"

"PyObject *last; /* last name */\n"

"int number;\n"

"} CustomObject;"

#: ../../extending/newtypes_tutorial.rst:251

msgid ""

"Because we now have data to manage, we have to be more careful about object "

"allocation and deallocation. At a minimum, we need a deallocation method::"

msgstr ""

"Como agora temos dados para gerenciar, precisamos ter mais cuidado com a "

"alocação e a desalocação do objeto. No mínimo, precisamos de método de "

"desalocação::"

#: ../../extending/newtypes_tutorial.rst:254

msgid ""

"static void\n"

"Custom_dealloc(CustomObject *self)\n"

"{\n"

" Py_XDECREF(self->first);\n"

" Py_XDECREF(self->last);\n"

" Py_TYPE(self)->tp_free((PyObject *) self);\n"

"}"

msgstr ""

#: ../../extending/newtypes_tutorial.rst:262

msgid "which is assigned to the :c:member:`~PyTypeObject.tp_dealloc` member::"

msgstr "que é atribuído ao membro :c:member:`~PyTypeObject.tp_dealloc`::"

#: ../../extending/newtypes_tutorial.rst:264

msgid ".tp_dealloc = (destructor) Custom_dealloc,"

msgstr ""

#: ../../extending/newtypes_tutorial.rst:266

msgid ""

"This method first clears the reference counts of the two Python attributes. :"

"c:func:`Py_XDECREF` correctly handles the case where its argument is "

"``NULL`` (which might happen here if ``tp_new`` failed midway). It then "

"calls the :c:member:`~PyTypeObject.tp_free` member of the object's type "

"(computed by ``Py_TYPE(self)``) to free the object's memory. Note that the "

"object's type might not be :class:`!CustomType`, because the object may be "

"an instance of a subclass."

msgstr ""

"Esse método primeiro limpa a contagem de referências dos dois atributos "

"Python. :c:func:`Py_XDECREF` lida corretamente com o caso em que seu "

"argumento é ``NULL`` (o que pode acontecer aqui se ``tp_new`` falhou no meio "

"do processo). Em seguida, ele chama o membro :c:member:`~PyTypeObject."

"tp_free` do tipo do objeto (obtido por ``Py_TYPE(self)``) para liberar a "

"memória do objeto. Observe que o tipo do objeto pode não ser :class:`!"

"CustomType`, pois o objeto pode ser uma instância de uma subclasse."

#: ../../extending/newtypes_tutorial.rst:275

msgid ""

"The explicit cast to ``destructor`` above is needed because we defined "

"``Custom_dealloc`` to take a ``CustomObject *`` argument, but the "

"``tp_dealloc`` function pointer expects to receive a ``PyObject *`` "

"argument. Otherwise, the compiler will emit a warning. This is object-"

"oriented polymorphism, in C!"

msgstr ""

#: ../../extending/newtypes_tutorial.rst:281

msgid ""

"We want to make sure that the first and last names are initialized to empty "

"strings, so we provide a ``tp_new`` implementation::"

msgstr ""

"Queremos nos certificar de que o primeiro e o último nome sejam "

"inicializados como strings vazias, portanto, fornecemos uma implementação:: "

"``tp_new``::"

#: ../../extending/newtypes_tutorial.rst:284

msgid ""

"static PyObject *\n"

"Custom_new(PyTypeObject *type, PyObject *args, PyObject *kwds)\n"

"{\n"

" CustomObject *self;\n"

" self = (CustomObject *) type->tp_alloc(type, 0);\n"

" if (self != NULL) {\n"

" self->first = PyUnicode_FromString(\"\");\n"

" if (self->first == NULL) {\n"

" Py_DECREF(self);\n"

" return NULL;\n"

" }\n"

" self->last = PyUnicode_FromString(\"\");\n"

" if (self->last == NULL) {\n"

" Py_DECREF(self);\n"

" return NULL;\n"

" }\n"

" self->number = 0;\n"

" }\n"

" return (PyObject *) self;\n"

"}"

msgstr ""

"static PyObject *\n"

"Custom_new(PyTypeObject *type, PyObject *args, PyObject *kwds)\n"

"{\n"

"CustomObject *self;\n"

"self = (CustomObject *) type->tp_alloc(type, 0);\n"

"if (self != NULL) {\n"

"self->first = PyUnicode_FromString(\"\");\n"

"if (self->first == NULL) {\n"

"Py_DECREF(self);\n"

"return NULL;\n"

"}\n"

"self->last = PyUnicode_FromString(\"\");\n"

"if (self->last == NULL) {\n"

"Py_DECREF(self);\n"

"return NULL;\n"

"}\n"

"self->number = 0;\n"

"}\n"

"return (PyObject *) self;\n"

"}"

#: ../../extending/newtypes_tutorial.rst:305

msgid "and install it in the :c:member:`~PyTypeObject.tp_new` member::"

msgstr "e instale-o no membro:: :c:member:`~PyTypeObject.tp_new`"

#: ../../extending/newtypes_tutorial.rst:307

msgid ".tp_new = Custom_new,"

msgstr ".tp_new = Custom_new,"

#: ../../extending/newtypes_tutorial.rst:309

msgid ""

"The ``tp_new`` handler is responsible for creating (as opposed to "

"initializing) objects of the type. It is exposed in Python as the :meth:"

"`~object.__new__` method. It is not required to define a ``tp_new`` member, "

"and indeed many extension types will simply reuse :c:func:"

"`PyType_GenericNew` as done in the first version of the :class:`!Custom` "

"type above. In this case, we use the ``tp_new`` handler to initialize the "

"``first`` and ``last`` attributes to non-``NULL`` default values."

msgstr ""

"O manipulador ``tp_new`` é responsável por criar (em oposição a inicializar) "

"os objetos do tipo. Ele é exposto no Python como o método :meth:`~object."

"__new__`. Não é obrigatório definir um membro ``tp_new`` e, de fato, muitos "

"tipos de extensão simplesmente reutilizam :c:func:`PyType_GenericNew`, como "

"na primeira versão do tipo :class:`!Custom` acima. Neste caso, usamos o "

"manipulador ``tp_new`` para inicializar os atributos ``first`` e ``last`` "

"com valores padrão que não sejam ``NULL``."

#: ../../extending/newtypes_tutorial.rst:317

msgid ""

"``tp_new`` is passed the type being instantiated (not necessarily "

"``CustomType``, if a subclass is instantiated) and any arguments passed when "

"the type was called, and is expected to return the instance created. "

"``tp_new`` handlers always accept positional and keyword arguments, but they "

"often ignore the arguments, leaving the argument handling to initializer (a."

"k.a. ``tp_init`` in C or ``__init__`` in Python) methods."

msgstr ""

"O ``tp_new`` recebe o tipo que está sendo instanciado (não necessariamente "

"``CustomType``, caso uma subclasse esteja sendo instanciada) e quaisquer "

"argumentos passados quando o tipo foi chamado, e deve retornar a instância "

"criada. Manipuladores ``tp_new`` sempre aceitam argumentos posicionais e "

"argumentos nomeados, mas frequentemente os ignoram, deixando o tratamento "

"dos argumentos para os métodos inicializadores (ou seja, ``tp_init`` em C ou "

"``__init__`` em Python)."

#: ../../extending/newtypes_tutorial.rst:325

msgid ""

"``tp_new`` shouldn't call ``tp_init`` explicitly, as the interpreter will do "

"it itself."

msgstr ""

"``tp_new`` não deve chamar ``tp_init`` explicitamente, pois o interpretador "

"fará isso por conta própria."

#: ../../extending/newtypes_tutorial.rst:328

msgid ""

"The ``tp_new`` implementation calls the :c:member:`~PyTypeObject.tp_alloc` "

"slot to allocate memory::"

msgstr ""

"A implementação de ``tp_new`` chama o slot :c:member:`~PyTypeObject."

"tp_alloc` para alocar memória::"

#: ../../extending/newtypes_tutorial.rst:331

msgid "self = (CustomObject *) type->tp_alloc(type, 0);"

msgstr "self = (CustomObject *) type->tp_alloc(type, 0);"

#: ../../extending/newtypes_tutorial.rst:333