6
6
# Translators:
7
7
# Welington Carlos <wcarlos3@gmail.com>, 2021
8
8
# Felipefpl, 2021
9
+ # Claudio Rogerio Carvalho Filho <excriptbrasil@gmail.com>, 2025
9
10
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
10
11
#
11
12
#, fuzzy
12
13
msgid ""
13
14
msgstr ""
14
15
"Project-Id-Version :Python 3.14\n "
15
16
"Report-Msgid-Bugs-To :\n "
16
- "POT-Creation-Date :2025-05-08 02:53-0300 \n "
17
+ "POT-Creation-Date :2025-05-23 14:20+0000 \n "
17
18
"PO-Revision-Date :2021-06-28 00:47+0000\n "
18
19
"Last-Translator :Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n "
19
20
"Language-Team :Portuguese (Brazil) (https://app.transifex.com/python-doc/ "
@@ -33,82 +34,164 @@ msgstr "Alocando Objetos na Pilha"
33
34
msgid ""
34
35
"Initialize a newly allocated object *op* with its type and initial "
35
36
"reference. Returns the initialized object. Other fields of the object are "
36
- "not affected."
37
+ "not initialized. Despite its name, this function is unrelated to the "
38
+ "object's :meth:`~object.__init__` method (:c:member:`~PyTypeObject.tp_init` "
39
+ "slot). Specifically, this function does **not** call the object's :meth:`!"
40
+ "__init__` method."
37
41
msgstr ""
38
- "Inicializa um objeto *op* recém-alocado com seu tipo e referência inicial. "
39
- "Retorna o objeto inicializado. Outros campos do objeto não são afetados."
40
42
41
43
#: ../../c-api/allocation.rst:24
42
44
msgid ""
45
+ "In general, consider this function to be a low-level routine. Use :c:member:"
46
+ "`~PyTypeObject.tp_alloc` where possible. For implementing :c:member:`!"
47
+ "tp_alloc` for your type, prefer :c:func:`PyType_GenericAlloc` or :c:func:"
48
+ "`PyObject_New`."
49
+ msgstr ""
50
+
51
+ #: ../../c-api/allocation.rst:31
52
+ msgid ""
53
+ "This function only initializes the object's memory corresponding to the "
54
+ "initial :c:type:`PyObject` structure. It does not zero the rest."
55
+ msgstr ""
56
+
57
+ #: ../../c-api/allocation.rst:37
58
+ msgid ""
43
59
"This does everything :c:func:`PyObject_Init` does, and also initializes the "
44
60
"length information for a variable-size object."
45
61
msgstr ""
46
62
"Isto faz tudo que o :c:func:`PyObject_Init` faz e também inicializa a "
47
63
"informação de comprimento para um objeto de tamanho variável."
48
64
49
- #: ../../c-api/allocation.rst:30
50
- msgid ""
51
- "Allocate a new Python object using the C structure type *TYPE* and the "
52
- "Python type object *typeobj* (``PyTypeObject*``). Fields not defined by the "
53
- "Python object header are not initialized. The caller will own the only "
54
- "reference to the object (i.e. its reference count will be one). The size of "
55
- "the memory allocation is determined from the :c:member:`~PyTypeObject."
56
- "tp_basicsize` field of the type object."
57
- msgstr ""
58
- "Aloca um novo objeto Python usando o tipo de estrutura do C *TYPE* e o "
59
- "objeto Python do tipo *typeobj* (``PyTypeObject*``). Campos não definidos "
60
- "pelo cabeçalho do objeto Python não são inicializados. O chamador será dono "
61
- "da apenas a referência ao objeto (isto é, sua contagem de referências será "
62
- "uma). O tamanho da alocação de memória é determinado do campo :c:member:"
63
- "`~PyTypeObject.tp_basicsize` do objeto tipo."
64
-
65
- #: ../../c-api/allocation.rst:38
66
- msgid ""
67
- "Note that this function is unsuitable if *typeobj* has :c:macro:"
68
- "`Py_TPFLAGS_HAVE_GC` set. For such objects, use :c:func:`PyObject_GC_New` "
69
- "instead."
70
- msgstr ""
71
- "Note que esta função não é adequada se *typeobj* tiver :c:macro:"
72
- "`Py_TPFLAGS_HAVE_GC` definido. Para tais objetos, use :c:func:"
73
- "`PyObject_GC_New` em vez disso."
74
-
75
- #: ../../c-api/allocation.rst:45
76
- msgid ""
77
- "Allocate a new Python object using the C structure type *TYPE* and the "
78
- "Python type object *typeobj* (``PyTypeObject*``). Fields not defined by the "
79
- "Python object header are not initialized. The allocated memory allows for "
80
- "the *TYPE* structure plus *size* (``Py_ssize_t``) fields of the size given "
81
- "by the :c:member:`~PyTypeObject.tp_itemsize` field of *typeobj*. This is "
82
- "useful for implementing objects like tuples, which are able to determine "
83
- "their size at construction time. Embedding the array of fields into the "
84
- "same allocation decreases the number of allocations, improving the memory "
85
- "management efficiency."
86
- msgstr ""
87
- "Aloca um novo objeto Python usando o tipo de estrutura do C *TYPE* e o "
88
- "objeto Python do tipo *typeobj* (``PyTypeObject*``). Campos não definidos "
89
- "pelo cabeçalho do objeto Python não são inicializados. A memória alocada "
90
- "permite a estrutura *TYPE* e os campos *size* (``Py_ssize_t``) do tamanho "
91
- "dado pelo campo :c:member:`~PyTypeObject.tp_itemsize` do tipo *typeobj*. "
92
- "Isto é útil para implementar objetos como tuplas, as quais são capazes de "
93
- "determinar seu tamanho no tempo da construção. Incorporando o vetor de "
94
- "campos dentro da mesma alocação diminuindo o numero de alocações, melhorando "
95
- "a eficiência do gerenciamento de memória."
96
-
97
- #: ../../c-api/allocation.rst:56
98
- msgid ""
99
- "Note that this function is unsuitable if *typeobj* has :c:macro:"
100
- "`Py_TPFLAGS_HAVE_GC` set. For such objects, use :c:func:`PyObject_GC_NewVar` "
101
- "instead."
102
- msgstr ""
103
- "Note que esta função não é adequada se *typeobj* tiver :c:macro:"
104
- "`Py_TPFLAGS_HAVE_GC` definido. Para tais objetos, use :c:func:"
105
- "`PyObject_GC_NewVar` em vez disso."
106
-
107
- #: ../../c-api/allocation.rst:63
65
+ #: ../../c-api/allocation.rst:42
66
+ msgid ""
67
+ "This function only initializes some of the object's memory. It does not "
68
+ "zero the rest."
69
+ msgstr ""
70
+
71
+ #: ../../c-api/allocation.rst:48
72
+ msgid ""
73
+ "Allocates a new Python object using the C structure type *TYPE* and the "
74
+ "Python type object *typeobj* (``PyTypeObject*``) by calling :c:func:"
75
+ "`PyObject_Malloc` to allocate memory and initializing it like :c:func:"
76
+ "`PyObject_Init`. The caller will own the only reference to the object (i.e. "
77
+ "its reference count will be one)."
78
+ msgstr ""
79
+
80
+ #: ../../c-api/allocation.rst:54 ../../c-api/allocation.rst:107
81
+ msgid ""
82
+ "Avoid calling this directly to allocate memory for an object; call the "
83
+ "type's :c:member:`~PyTypeObject.tp_alloc` slot instead."
84
+ msgstr ""
85
+
86
+ #: ../../c-api/allocation.rst:57 ../../c-api/allocation.rst:110
87
+ msgid ""
88
+ "When populating a type's :c:member:`~PyTypeObject.tp_alloc` slot, :c:func:"
89
+ "`PyType_GenericAlloc` is preferred over a custom function that simply calls "
90
+ "this macro."
91
+ msgstr ""
92
+
93
+ #: ../../c-api/allocation.rst:61
94
+ msgid ""
95
+ "This macro does not call :c:member:`~PyTypeObject.tp_alloc`, :c:member:"
96
+ "`~PyTypeObject.tp_new` (:meth:`~object.__new__`), or :c:member:"
97
+ "`~PyTypeObject.tp_init` (:meth:`~object.__init__`)."
98
+ msgstr ""
99
+
100
+ #: ../../c-api/allocation.rst:65
101
+ msgid ""
102
+ "This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in :c:"
103
+ "member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_New` instead."
104
+ msgstr ""
105
+
106
+ #: ../../c-api/allocation.rst:68
107
+ msgid ""
108
+ "Memory allocated by this macro must be freed with :c:func:`PyObject_Free` "
109
+ "(usually called via the object's :c:member:`~PyTypeObject.tp_free` slot)."
110
+ msgstr ""
111
+
112
+ #: ../../c-api/allocation.rst:73 ../../c-api/allocation.rst:123
113
+ msgid ""
114
+ "The returned memory is not guaranteed to have been completely zeroed before "
115
+ "it was initialized."
116
+ msgstr ""
117
+
118
+ #: ../../c-api/allocation.rst:78 ../../c-api/allocation.rst:128
119
+ msgid ""
120
+ "This macro does not construct a fully initialized object of the given type; "
121
+ "it merely allocates memory and prepares it for further initialization by :c:"
122
+ "member:`~PyTypeObject.tp_init`. To construct a fully initialized object, "
123
+ "call *typeobj* instead. For example::"
124
+ msgstr ""
125
+
126
+ #: ../../c-api/allocation.rst:83
127
+ msgid "PyObject *foo = PyObject_CallNoArgs((PyObject *)&PyFoo_Type);"
128
+ msgstr ""
129
+
130
+ #: ../../c-api/allocation.rst:87 ../../c-api/allocation.rst:137
131
+ msgid ":c:func:`PyObject_Free`"
132
+ msgstr ":c:func:`PyObject_Free`"
133
+
134
+ #: ../../c-api/allocation.rst:88
135
+ msgid ":c:macro:`PyObject_GC_New`"
136
+ msgstr ""
137
+
138
+ #: ../../c-api/allocation.rst:89 ../../c-api/allocation.rst:139
139
+ msgid ":c:func:`PyType_GenericAlloc`"
140
+ msgstr ""
141
+
142
+ #: ../../c-api/allocation.rst:90 ../../c-api/allocation.rst:140
143
+ msgid ":c:member:`~PyTypeObject.tp_alloc`"
144
+ msgstr ":c:member:`~PyTypeObject.tp_alloc`"
145
+
146
+ #: ../../c-api/allocation.rst:95
147
+ msgid "Like :c:macro:`PyObject_New` except:"
148
+ msgstr ""
149
+
150
+ #: ../../c-api/allocation.rst:97
151
+ msgid ""
152
+ "It allocates enough memory for the *TYPE* structure plus *size* "
153
+ "(``Py_ssize_t``) fields of the size given by the :c:member:`~PyTypeObject."
154
+ "tp_itemsize` field of *typeobj*."
155
+ msgstr ""
156
+
157
+ #: ../../c-api/allocation.rst:100
158
+ msgid "The memory is initialized like :c:func:`PyObject_InitVar`."
159
+ msgstr ""
160
+
161
+ #: ../../c-api/allocation.rst:102
162
+ msgid ""
163
+ "This is useful for implementing objects like tuples, which are able to "
164
+ "determine their size at construction time. Embedding the array of fields "
165
+ "into the same allocation decreases the number of allocations, improving the "
166
+ "memory management efficiency."
167
+ msgstr ""
168
+
169
+ #: ../../c-api/allocation.rst:114
170
+ msgid ""
171
+ "This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in :c:"
172
+ "member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_NewVar` instead."
173
+ msgstr ""
174
+
175
+ #: ../../c-api/allocation.rst:118
176
+ msgid ""
177
+ "Memory allocated by this function must be freed with :c:func:`PyObject_Free` "
178
+ "(usually called via the object's :c:member:`~PyTypeObject.tp_free` slot)."
179
+ msgstr ""
180
+
181
+ #: ../../c-api/allocation.rst:133
182
+ msgid ""
183
+ "PyObject *list_instance = PyObject_CallNoArgs((PyObject *)&PyList_Type);"
184
+ msgstr ""
185
+
186
+ #: ../../c-api/allocation.rst:138
187
+ msgid ":c:macro:`PyObject_GC_NewVar`"
188
+ msgstr ""
189
+
190
+ #: ../../c-api/allocation.rst:145
108
191
msgid "Same as :c:func:`PyObject_Free`."
109
192
msgstr "Mesmo que :c:func:`PyObject_Free`."
110
193
111
- #: ../../c-api/allocation.rst:67
194
+ #: ../../c-api/allocation.rst:149
112
195
msgid ""
113
196
"Object which is visible in Python as ``None``. This should only be accessed "
114
197
"using the :c:macro:`Py_None` macro, which evaluates to a pointer to this "
@@ -118,10 +201,10 @@ msgstr ""
118
201
"usando a macro :c:macro:`Py_None`, o qual avalia como um ponteiro para este "
119
202
"objeto."
120
203
121
- #: ../../c-api/allocation.rst:74
204
+ #: ../../c-api/allocation.rst:156
122
205
msgid ":c:func:`PyModule_Create`"
123
206
msgstr ":c:func:`PyModule_Create`"
124
207
125
- #: ../../c-api/allocation.rst:75
208
+ #: ../../c-api/allocation.rst:157
126
209
msgid "To allocate and create extension modules."
127
210
msgstr "Para alocar e criar módulos de extensão."