FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

pomerge from 3.9 branch into 3.7 · python-doc-ja/python-docs-pt-br@7ada37e · GitHub

  1. python-doc-ja
  2. python-docs-pt-br

Repository navigation

Commit 7ada37e

Browse files
github-actions[bot]
committed
pomerge from 3.9 branch into 3.7
1 parent 3a15075 commit 7ada37e

8 files changed

Lines changed: 240 additions & 7 deletions

File tree

‎c-api/refcounting.po‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,19 +32,26 @@ 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,6 +107,13 @@ 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 ""
@@ -97,10 +128,17 @@ msgid ""
97128
"exported function versions of :c:func:`Py_XINCREF` and :c:func:`Py_XDECREF`, "
98129
"respectively."
99130
msgstr ""
131+
"As seguintes funções são para incorporação dinâmica de Python em tempo de "
132+
"execução: ``Py_IncRef(PyObject *o)``, ``Py_DecRef(PyObject *o)``. Elas são "
133+
"simplesmente versões de função exportadas de :c:func:`Py_XINCREF` e :c:func:"
134+
"`Py_XDECREF`, respectivamente."
100135

101136
#: ../../c-api/refcounting.rst:70
102137
msgid ""
103138
"The following functions or macros are only for use within the interpreter "
104139
"core: :c:func:`_Py_Dealloc`, :c:func:`_Py_ForgetReference`, :c:func:"
105140
"`_Py_NewReference`, as well as the global variable :c:data:`_Py_RefTotal`."
106141
msgstr ""
142+
"As seguintes funções ou macros são apenas para uso dentro do núcleo do "
143+
"interpretador: :c:func:`_Py_Dealloc`, :c:func:`_Py_ForgetReference`, :c:func:"
144+
"`_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
@@ -41,6 +41,16 @@ msgid ""
4141
"c:func:`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr`, and :c:func:"
4242
"`PyNumber_InPlaceXor`)."
4343
msgstr ""
44+
"Esta seção detalha a API pública para os objetos :class:`set` e :class:"
45+
"`frozenset`. Qualquer funcionalidade não listada abaixo é melhor acessada "
46+
"usando o protocolo de objeto abstrato (incluindo :c:func:"
47+
"`PyObject_CallMethod`, :c:func:`PyObject_RichCompareBool`, :c:func:"
48+
"`PyObject_Hash`, :c:func:`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:"
49+
"`PyObject_Print`, and :c:func:`PyObject_GetIter`) ou o protocolo abstrato de "
50+
"número (incluindo :c:func:`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:"
51+
"func:`PyNumber_Or`, :c:func:`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :"
52+
"c:func:`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr` e :c:func:"
53+
"`PyNumber_InPlaceXor`)."
4454

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

5776
#: ../../c-api/set.rst:40
5877
msgid ""
@@ -67,41 +86,56 @@ msgid ""
6786
"This is an instance of :c:type:`PyTypeObject` representing the Python :class:"
6887
"`frozenset` type."
6988
msgstr ""
89+
"Esta é uma instância de :c:type:`PyTypeObject` representando o tipo Python :"
90+
"class:`frozenset`."
7091

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

0 commit comments

Comments
 (0)
Back | FazBrowse Home | New Git URL