Skip to content

Commit 95f9b14

Browse files
github-actions[bot]github-actions[bot]
committed
pomerge from 3.9 branch into 3.8
1 parent 342dad8 commit 95f9b14

8 files changed

Lines changed: 253 additions & 10 deletions

File tree

‎c-api/refcounting.po‎

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,26 +25,33 @@ msgstr ""
2525

2626
#: ../../c-api/refcounting.rst:8
2727
msgid "Reference Counting"
28-
msgstr "Contagem de Referência"
28+
msgstr "Contagem de Referências"
2929

3030
#: ../../c-api/refcounting.rst:10
3131
msgid ""
3232
"The macros in this section are used for managing reference counts of Python "
3333
"objects."
3434
msgstr ""
35+
"As macros nesta seção são usadas para gerenciar contagens de referências de "
36+
"objetos Python."
3537

3638
#: ../../c-api/refcounting.rst:16
3739
msgid ""
3840
"Increment the reference count for object *o*. The object must not be "
3941
"``NULL``; if you aren't sure that it isn't ``NULL``, use :c:func:"
4042
"`Py_XINCREF`."
4143
msgstr ""
44+
"Aumenta a contagem de referências para o objeto *o*. O objeto não deve ser "
45+
"``NULL``; se você não tem certeza de que não é ``NULL``, use :c:func:"
46+
"`Py_XINCREF`."
4247

4348
#: ../../c-api/refcounting.rst:22
4449
msgid ""
4550
"Increment the reference count for object *o*. The object may be ``NULL``, "
4651
"in which case the macro has no effect."
4752
msgstr ""
53+
"Aumenta a contagem de referências para o objeto *o*. O objeto pode ser "
54+
"``NULL``, caso em que a macro não tem efeito."
4855

4956
#: ../../c-api/refcounting.rst:28
5057
msgid ""
@@ -53,6 +60,10 @@ msgid ""
5360
"`Py_XDECREF`. If the reference count reaches zero, the object's type's "
5461
"deallocation function (which must not be ``NULL``) is invoked."
5562
msgstr ""
63+
"Diminui a contagem de referências para o objeto *o*. O objeto não deve ser "
64+
"``NULL``; se você não tem certeza de que não é ``NULL``, use :c:func:"
65+
"`Py_XDECREF`. Se a contagem de referências chegar a zero, a função de "
66+
"desalocação do tipo de objeto (que não deve ser ``NULL``) é chamada."
5667

5768
#: ../../c-api/refcounting.rst:35
5869
msgid ""
@@ -66,13 +77,26 @@ msgid ""
6677
"update the list data structure, and then call :c:func:`Py_DECREF` for the "
6778
"temporary variable."
6879
msgstr ""
80+
"A função de desalocação pode fazer com que o código Python arbitrário seja "
81+
"invocado (por exemplo, quando uma instância de classe com um método :meth:"
82+
"`__del__` é desalocada). Embora as exceções em tal código não sejam "
83+
"propagadas, o código executado tem acesso livre a todas as variáveis globais "
84+
"do Python. Isso significa que qualquer objeto que é alcançável de uma "
85+
"variável global deve estar em um estado consistente antes de :c:func:"
86+
"`Py_DECREF` ser invocado. Por exemplo, o código para excluir um objeto de "
87+
"uma lista deve copiar uma referência ao objeto excluído em uma variável "
88+
"temporária, atualizar a estrutura de dados da lista e então chamar :c:func:"
89+
"`Py_DECREF` para a variável temporária."
6990

7091
#: ../../c-api/refcounting.rst:47
7192
msgid ""
7293
"Decrement the reference count for object *o*. The object may be ``NULL``, "
7394
"in which case the macro has no effect; otherwise the effect is the same as "
7495
"for :c:func:`Py_DECREF`, and the same warning applies."
7596
msgstr ""
97+
"Diminui a contagem de referências para o objeto *o*. O objeto pode ser "
98+
"``NULL``, caso em que a macro não tem efeito; caso contrário, o efeito é o "
99+
"mesmo de :c:func:`Py_DECREF`, e o mesmo aviso se aplica."
76100

77101
#: ../../c-api/refcounting.rst:54
78102
msgid ""
@@ -83,12 +107,21 @@ msgid ""
83107
"object passed because the macro carefully uses a temporary variable and sets "
84108
"the argument to ``NULL`` before decrementing its reference count."
85109
msgstr ""
110+
"Diminui a contagem de referências para o objeto *o*. O objeto pode ser "
111+
"``NULL``, caso em que a macro não tem efeito; caso contrário, o efeito é o "
112+
"mesmo de :c:func:`Py_DECREF`, exceto que o argumento também é definido como "
113+
"``NULL``. O aviso para :c:func:`Py_DECREF` não se aplica em relação ao "
114+
"objeto passado porque a macro usa cuidadosamente uma variável temporária e "
115+
"define o argumento como ``NULL`` antes de diminuir sua contagem de "
116+
"referências."
86117

87118
#: ../../c-api/refcounting.rst:61
88119
msgid ""
89120
"It is a good idea to use this macro whenever decrementing the reference "
90121
"count of an object that might be traversed during garbage collection."
91122
msgstr ""
123+
"É uma boa ideia usar essa macro sempre que diminuir a contagem de "
124+
"referências de um objeto que pode ser percorrido durante a coleta de lixo."
92125

93126
#: ../../c-api/refcounting.rst:65
94127
msgid ""
@@ -97,10 +130,17 @@ msgid ""
97130
"exported function versions of :c:func:`Py_XINCREF` and :c:func:`Py_XDECREF`, "
98131
"respectively."
99132
msgstr ""
133+
"As seguintes funções são para incorporação dinâmica de Python em tempo de "
134+
"execução: ``Py_IncRef(PyObject *o)``, ``Py_DecRef(PyObject *o)``. Elas são "
135+
"simplesmente versões de função exportadas de :c:func:`Py_XINCREF` e :c:func:"
136+
"`Py_XDECREF`, respectivamente."
100137

101138
#: ../../c-api/refcounting.rst:70
102139
msgid ""
103140
"The following functions or macros are only for use within the interpreter "
104141
"core: :c:func:`_Py_Dealloc`, :c:func:`_Py_ForgetReference`, :c:func:"
105142
"`_Py_NewReference`, as well as the global variable :c:data:`_Py_RefTotal`."
106143
msgstr ""
144+
"As seguintes funções ou macros são apenas para uso dentro do núcleo do "
145+
"interpretador: :c:func:`_Py_Dealloc`, :c:func:`_Py_ForgetReference`, :c:func:"
146+
"`_Py_NewReference`, bem como a variável global :c:data:`_Py_RefTotal`."

‎c-api/set.po‎

Lines changed: 79 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,16 @@ msgid ""
4242
"c:func:`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr`, and :c:func:"
4343
"`PyNumber_InPlaceXor`)."
4444
msgstr ""
45+
"Esta seção detalha a API pública para os objetos :class:`set` e :class:"
46+
"`frozenset`. Qualquer funcionalidade não listada abaixo é melhor acessada "
47+
"usando o protocolo de objeto abstrato (incluindo :c:func:"
48+
"`PyObject_CallMethod`, :c:func:`PyObject_RichCompareBool`, :c:func:"
49+
"`PyObject_Hash`, :c:func:`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:"
50+
"`PyObject_Print`, and :c:func:`PyObject_GetIter`) ou o protocolo abstrato de "
51+
"número (incluindo :c:func:`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:"
52+
"func:`PyNumber_Or`, :c:func:`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :"
53+
"c:func:`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr` e :c:func:"
54+
"`PyNumber_InPlaceXor`)."
4555

4656
#: ../../c-api/set.rst:29
4757
msgid ""
@@ -54,6 +64,15 @@ msgid ""
5464
"access should be done through the documented API rather than by manipulating "
5565
"the values in the structure."
5666
msgstr ""
67+
"Este subtipo de :c:type:`PyObject` é usado para manter os dados internos "
68+
"para ambos os objetos :class:`set` e :class:`frozenset`. É como um :c:type:"
69+
"`PyDictObject` em que tem um tamanho fixo para conjuntos pequenos (muito "
70+
"parecido com o armazenamento de tupla) e apontará para um bloco de memória "
71+
"de tamanho variável separado para conjuntos de tamanho médio e grande (muito "
72+
"parecido com lista armazenamento). Nenhum dos campos desta estrutura deve "
73+
"ser considerado público e está sujeito a alterações. Todo o acesso deve ser "
74+
"feito por meio da API documentada, em vez de manipular os valores na "
75+
"estrutura."
5776

5877
#: ../../c-api/set.rst:40
5978
msgid ""
@@ -68,41 +87,56 @@ msgid ""
6887
"This is an instance of :c:type:`PyTypeObject` representing the Python :class:"
6988
"`frozenset` type."
7089
msgstr ""
90+
"Esta é uma instância de :c:type:`PyTypeObject` representando o tipo Python :"
91+
"class:`frozenset`."
7192

7293
#: ../../c-api/set.rst:49
7394
msgid ""
7495
"The following type check macros work on pointers to any Python object. "
7596
"Likewise, the constructor functions work with any iterable Python object."
7697
msgstr ""
98+
"As macros de verificação de tipo a seguir funcionam em ponteiros para "
99+
"qualquer objeto Python. Da mesma forma, as funções construtoras funcionam "
100+
"com qualquer objeto Python iterável."
77101

78102
#: ../../c-api/set.rst:55
79103
msgid ""
80104
"Return true if *p* is a :class:`set` object or an instance of a subtype."
81105
msgstr ""
106+
"Retorna verdadeiro se *p* for um objeto :class:`set` ou uma instância de um "
107+
"subtipo."
82108

83109
#: ../../c-api/set.rst:59
84110
msgid ""
85111
"Return true if *p* is a :class:`frozenset` object or an instance of a "
86112
"subtype."
87113
msgstr ""
114+
"Retorna verdadeiro se *p* for um objeto :class:`frozenset` ou uma instância "
115+
"de um subtipo."
88116

89117
#: ../../c-api/set.rst:64
90118
msgid ""
91119
"Return true if *p* is a :class:`set` object, a :class:`frozenset` object, or "
92120
"an instance of a subtype."
93121
msgstr ""
122+
"Retorna verdadeiro se *p* for um objeto :class:`set`, um objeto :class:"
123+
"`frozenset` ou uma instância de um subtipo."
94124

95125
#: ../../c-api/set.rst:70
96126
msgid ""
97127
"Return true if *p* is a :class:`set` object or a :class:`frozenset` object "
98128
"but not an instance of a subtype."
99129
msgstr ""
130+
"Retorna verdadeiro se *p* for um objeto :class:`set` ou um objeto :class:"
131+
"`frozenset`, mas não uma instância de um subtipo."
100132

101133
#: ../../c-api/set.rst:76
102134
msgid ""
103135
"Return true if *p* is a :class:`frozenset` object but not an instance of a "
104136
"subtype."
105137
msgstr ""
138+
"Retorna verdadeiro se *p* for um objeto :class:`frozenset`, mas não uma "
139+
"instância de um subtipo."
106140

107141
#: ../../c-api/set.rst:82
108142
msgid ""
@@ -112,6 +146,11 @@ msgid ""
112146
"is not actually iterable. The constructor is also useful for copying a set "
113147
"(``c=set(s)``)."
114148
msgstr ""
149+
"Retorna uma nova :class:`set` contendo objetos retornados pelo iterável "
150+
"*iterable*. O *iterable* pode ser ``NULL`` para criar um novo conjunto "
151+
"vazio. Retorna o novo conjunto em caso de sucesso ou ``NULL`` em caso de "
152+
"falha. Levanta :exc:`TypeError` se *iterable* não for realmente iterável. O "
153+
"construtor também é útil para copiar um conjunto (``c=set(s)``)."
115154

116155
#: ../../c-api/set.rst:91
117156
msgid ""
@@ -120,23 +159,34 @@ msgid ""
120159
"Return the new set on success or ``NULL`` on failure. Raise :exc:"
121160
"`TypeError` if *iterable* is not actually iterable."
122161
msgstr ""
162+
"Retorna uma nova :class:`frozenset` contendo objetos retornados pelo "
163+
"iterável *iterable*. O *iterable* pode ser ``NULL`` para criar um novo "
164+
"frozenset vazio. Retorna o novo conjunto em caso de sucesso ou ``NULL`` em "
165+
"caso de falha. Levanta :exc:`TypeError` se *iterable* não for realmente "
166+
"iterável."
123167

124168
#: ../../c-api/set.rst:97
125169
msgid ""
126170
"The following functions and macros are available for instances of :class:"
127171
"`set` or :class:`frozenset` or instances of their subtypes."
128172
msgstr ""
173+
"As seguintes funções e macros estão disponíveis para instâncias de :class:"
174+
"`set` ou :class:`frozenset` ou instâncias de seus subtipos."
129175

130176
#: ../../c-api/set.rst:105
131177
msgid ""
132178
"Return the length of a :class:`set` or :class:`frozenset` object. Equivalent "
133179
"to ``len(anyset)``. Raises a :exc:`PyExc_SystemError` if *anyset* is not a :"
134180
"class:`set`, :class:`frozenset`, or an instance of a subtype."
135181
msgstr ""
182+
"Retorna o comprimento de um objeto :class:`set` ou :class:`frozenset`. "
183+
"Equivalente a ``len(anyset)``. Levanta um :exc:`PyExc_SystemError` se "
184+
"*anyset* não for um :class:`set`, :class:`frozenset`, ou uma instância de um "
185+
"subtipo."
136186

137187
#: ../../c-api/set.rst:112
138188
msgid "Macro form of :c:func:`PySet_Size` without error checking."
139-
msgstr ""
189+
msgstr "Forma macro de :c:func:`PySet_Size` sem verificação de erros."
140190

141191
#: ../../c-api/set.rst:117
142192
msgid ""
@@ -147,6 +197,12 @@ msgid ""
147197
"`PyExc_SystemError` if *anyset* is not a :class:`set`, :class:`frozenset`, "
148198
"or an instance of a subtype."
149199
msgstr ""
200+
"Retorna ``1`` se encontrado, ``0`` se não encontrado, e ``-1`` se um erro é "
201+
"encontrado. Ao contrário do método Python :meth:`__contains__`, esta função "
202+
"não converte automaticamente conjuntos não hasheáveis em frozensets "
203+
"temporários. Levanta um :exc:`TypeError` se a *key* não for hasheável. "
204+
"Levanta :exc:`PyExc_SystemError` se *anyset* não é um :class:`set`, :class:"
205+
"`frozenset`, ou uma instância de um subtipo."
150206

151207
#: ../../c-api/set.rst:126
152208
msgid ""
@@ -158,12 +214,23 @@ msgid ""
158214
"grow. Raise a :exc:`SystemError` if *set* is not an instance of :class:"
159215
"`set` or its subtype."
160216
msgstr ""
217+
"Adiciona *key* a uma instância de :class:`set`. Também funciona com "
218+
"instâncias de :class:`frozenset` (como :c:func:`PyTuple_SetItem`, ele pode "
219+
"ser usado para preencher os valores de novos conjuntos de congelamentos "
220+
"antes que eles sejam expostos a outro código). Retorna ``0`` em caso de "
221+
"sucesso ou ``-1`` em caso de falha. Levanta um :exc:`TypeError` se a *key* "
222+
"não for hasheável. Levanta uma :exc:`MemoryError` se não houver espaço para "
223+
"crescer. Levanta uma :exc:`SystemError` se *set* não for uma instância de :"
224+
"class:`set` ou seu subtipo."
161225

162226
#: ../../c-api/set.rst:135
163227
msgid ""
164228
"The following functions are available for instances of :class:`set` or its "
165229
"subtypes but not for instances of :class:`frozenset` or its subtypes."
166230
msgstr ""
231+
"As seguintes funções estão disponíveis para instâncias de :class:`set` ou "
232+
"seus subtipos, mas não para instâncias de :class:`frozenset` ou seus "
233+
"subtipos."
167234

168235
#: ../../c-api/set.rst:141
169236
msgid ""
@@ -175,6 +242,13 @@ msgid ""
175242
"`PyExc_SystemError` if *set* is not an instance of :class:`set` or its "
176243
"subtype."
177244
msgstr ""
245+
"Retorna ``1`` se encontrado e removido, ``0`` se não encontrado (nenhuma "
246+
"ação realizada) e ``-1`` se um erro for encontrado. Não levanta :exc:"
247+
"`KeyError` para chaves ausentes. Levanta uma :exc:`TypeError` se a *key* não "
248+
"for hasheável. Ao contrário do método Python :meth:`~set.discard`, esta "
249+
"função não converte automaticamente conjuntos não hasheáveis em frozensets "
250+
"temporários. Levanta :exc:`PyExc_SystemError` se *set* não é uma instância "
251+
"de :class:`set` ou seu subtipo."
178252

179253
#: ../../c-api/set.rst:151
180254
msgid ""
@@ -183,6 +257,10 @@ msgid ""
183257
"if the set is empty. Raise a :exc:`SystemError` if *set* is not an instance "
184258
"of :class:`set` or its subtype."
185259
msgstr ""
260+
"Retorna uma nova referência a um objeto arbitrário no *set* e remove o "
261+
"objeto do *set*. Retorna ``NULL`` em caso de falha. Levanta :exc:`KeyError` "
262+
"se o conjunto estiver vazio. Levanta uma :exc:`SystemError` se *set* não for "
263+
"uma instância de :class:`set` ou seu subtipo."
186264

187265
#: ../../c-api/set.rst:159
188266
msgid "Empty an existing set of all elements."

0 commit comments

Comments
 (0)