Merge 3.11 into 3.10

github-actions · github-actions · commit b7dc7ffff494 · 2022-11-08T23:11:07.000Z
diff --git a/c-api/allocation.po b/c-api/allocation.po
@@ -37,6 +37,10 @@ msgid ""
 "detector's set of observed objects. Other fields of the object are not "
 "affected."
 msgstr ""
+"Inicializa um objeto *op* recém-alocado com seu tipo e referência inicial.  "
+"Retorna o objeto inicializado. Se o *type* indica que o objeto participa no "
+"detector de lixo cíclico ele é adicionado ao grupo do detector de objetos "
+"observados. Outros campos do objeto não são afetados."
 
 #: ../../c-api/allocation.rst:26
 msgid ""
diff --git a/c-api/apiabiversion.po b/c-api/apiabiversion.po
@@ -28,7 +28,7 @@ msgstr ""
 
 #: ../../c-api/apiabiversion.rst:7
 msgid "API and ABI Versioning"
-msgstr "API e Versionamento ABI"
+msgstr "API e Versionamento de ABI"
 
 #: ../../c-api/apiabiversion.rst:9
 msgid ""
diff --git a/c-api/arg.po b/c-api/arg.po
diff --git a/c-api/capsule.po b/c-api/capsule.po
@@ -45,6 +45,13 @@ msgid ""
 "regular import mechanism can be used to access C APIs defined in dynamically "
 "loaded modules."
 msgstr ""
+"Este subtipo de :c:type:`PyObject` representa um valor opaco, útil para "
+"módulos de extensão C que precisam passar um valor opaco (como ponteiro :c:"
+"expr:`void*`) através do código Python para outro código C . É "
+"frequentemente usado para disponibilizar um ponteiro de função C definido em "
+"um módulo para outros módulos, para que o mecanismo de importação regular "
+"possa ser usado para acessar APIs C definidas em módulos carregados "
+"dinamicamente."
 
 #: ../../c-api/capsule.rst:27
 msgid "The type of a destructor callback for a capsule.  Defined as::"
diff --git a/c-api/complex.po b/c-api/complex.po
@@ -179,11 +179,11 @@ msgstr "Retorna um novo objeto :c:type:`PyComplexObject` de *real* e *imag*."
 
 #: ../../c-api/complex.rst:118
 msgid "Return the real part of *op* as a C :c:expr:`double`."
-msgstr ""
+msgstr "Retorna a parte real de *op* como um :c:expr:`double` C."
 
 #: ../../c-api/complex.rst:123
 msgid "Return the imaginary part of *op* as a C :c:expr:`double`."
-msgstr ""
+msgstr "Retorna a parte imaginária de *op* como um :c:expr:`double` C."
 
 #: ../../c-api/complex.rst:128
 msgid "Return the :c:type:`Py_complex` value of the complex number *op*."
diff --git a/c-api/conversion.po b/c-api/conversion.po
@@ -73,6 +73,12 @@ msgid ""
 "equivalent to the C99 ``n = snprintf(NULL, 0, ...)`` which would determine "
 "the necessary buffer size."
 msgstr ""
+"Os invólucros garantem que ``str[size-1]`` seja sempre ``'\\0'`` no retorno. "
+"Eles nunca escrevem mais do que *size* bytes (incluindo o ``'\\0'`` ao "
+"final) em str. Ambas as funções exigem que ``str != NULL``, ``size > 0``, "
+"``format != NULL`` e ``size < INT_MAX``. Note que isso significa que não há "
+"equivalente ao ``n = snprintf(NULL, 0, ...)`` do C99 que determinaria o "
+"tamanho de buffer necessário."
 
 #: ../../c-api/conversion.rst:34
 msgid ""
@@ -127,6 +133,11 @@ msgid ""
 "have leading or trailing whitespace. The conversion is independent of the "
 "current locale."
 msgstr ""
+"Converte uma string ``s`` em :c:expr:`double`, levantando uma exceção Python "
+"em caso de falha. O conjunto de strings aceitas corresponde ao conjunto de "
+"strings aceito pelo construtor :func:`float` do Python, exceto que ``s`` não "
+"deve ter espaços em branco à esquerda ou à direita. A conversão é "
+"independente da localidade atual."
 
 #: ../../c-api/conversion.rst:59
 msgid ""
@@ -183,6 +194,8 @@ msgid ""
 "Convert a :c:expr:`double` *val* to a string using supplied *format_code*, "
 "*precision*, and *flags*."
 msgstr ""
+"Converte um :c:expr:`double` *val* para uma string usando *format_code*, "
+"*precision* e *flags* fornecidos."
 
 #: ../../c-api/conversion.rst:90
 msgid ""
diff --git a/c-api/datetime.po b/c-api/datetime.po
@@ -276,7 +276,7 @@ msgstr "Retorna o microssegundo, como um inteiro de 0 a 999999."
 
 #: ../../c-api/datetime.rst:198 ../../c-api/datetime.rst:236
 msgid "Return the fold, as an int from 0 through 1."
-msgstr ""
+msgstr "Retorna a dobra, como um inteiro de 0 a 1."
 
 #: ../../c-api/datetime.rst:205 ../../c-api/datetime.rst:243
 msgid "Return the tzinfo (which may be ``None``)."
diff --git a/c-api/dict.po b/c-api/dict.po
@@ -111,6 +111,10 @@ msgid ""
 "``PyUnicode_FromString(key)``.  Return ``0`` on success or ``-1`` on "
 "failure.  This function *does not* steal a reference to *val*."
 msgstr ""
+"Insere *val* no dicionário *p* usando *key* como uma chave. *key* deve ser "
+"a :c:expr:`const char*`. O objeto chave é criado usando "
+"``PyUnicode_FromString(key)``. Retorna ``0`` em caso de sucesso ou ``-1`` em "
+"caso de falha. Esta função *não* rouba uma referência a *val*."
 
 #: ../../c-api/dict.rst:83
 msgid ""
@@ -175,6 +179,8 @@ msgid ""
 "This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:"
 "expr:`const char*`, rather than a :c:expr:`PyObject*`."
 msgstr ""
+"É o mesmo que :c:func:`PyDict_GetItem`, mas *key* é especificada como um :c:"
+"expr:`const char*`, em vez de um :c:expr:`PyObject*`."
 
 #: ../../c-api/dict.rst:123
 msgid ""
@@ -242,6 +248,16 @@ msgid ""
 "represents offsets within the internal dictionary structure, and since the "
 "structure is sparse, the offsets are not consecutive."
 msgstr ""
+"Itera todos os pares de valores-chave no dicionário *p*. O :c:type:"
+"`Py_ssize_t` referido por *ppos* deve ser inicializado para ``0`` antes da "
+"primeira chamada para esta função para iniciar a iteração; a função retorna "
+"true para cada par no dicionário e false quando todos os pares forem "
+"relatados. Os parâmetros *pkey* e *pvalue* devem apontar para variáveis de :"
+"c:expr:`PyObject*` que serão preenchidas com cada chave e valor, "
+"respectivamente, ou podem ser ``NULL``. Todas as referências retornadas por "
+"meio deles são emprestadas. *ppos* não deve ser alterado durante a iteração. "
+"Seu valor representa deslocamentos dentro da estrutura do dicionário interno "
+"e, como a estrutura é esparsa, os deslocamentos não são consecutivos."
 
 #: ../../c-api/dict.rst:176
 msgid "For example::"
diff --git a/c-api/import.po b/c-api/import.po
@@ -405,6 +405,11 @@ msgid ""
 "could play tricks with this to provide a dynamically created collection of "
 "frozen modules."
 msgstr ""
+"Este ponteiro é inicializado para apontar para um vetor de registros de :c:"
+"struct:`_frozen`, terminado por um cujos membros são todos ``NULL`` ou zero. "
+"Quando um módulo congelado é importado, ele é pesquisado nesta tabela. O "
+"código de terceiros pode fazer truques com isso para fornecer uma coleção "
+"criada dinamicamente de módulos congelados."
 
 #: ../../c-api/import.rst:272
 msgid ""
diff --git a/c-api/intro.po b/c-api/intro.po
@@ -392,6 +392,18 @@ msgid ""
 "never be deallocated, they are typically static :c:type:`PyTypeObject` "
 "objects."
 msgstr ""
+"A maioria das funções da API Python/C tem um ou mais argumentos, bem como um "
+"valor de retorno do tipo :c:expr:`PyObject*`. Este tipo é um ponteiro para "
+"um tipo de dados opaco que representa um objeto Python arbitrário. Como "
+"todos os tipos de objeto Python são tratados da mesma maneira pela linguagem "
+"Python na maioria das situações (por exemplo, atribuições, regras de escopo "
+"e passagem de argumento), é adequado que eles sejam representados por um "
+"único tipo C. Quase todos os objetos Python vivem na pilha: você nunca "
+"declara uma variável automática ou estática do tipo :c:type:`PyObject`, "
+"variáveis de apenas ponteiro do tipo :c:expr:`PyObject*` podem ser "
+"declaradas. A única exceção são os objetos de tipo; uma vez que estes nunca "
+"devem ser desalocados, eles são normalmente objetos estáticos :c:type:"
+"`PyTypeObject`."
 
 #: ../../c-api/intro.rst:242
 msgid ""
@@ -739,6 +751,13 @@ msgid ""
 "of a complex number.  These will  be discussed together with the functions "
 "that use them."
 msgstr ""
+"Existem alguns outros tipos de dados que desempenham um papel significativo "
+"na API Python/C; a maioria são tipos C simples, como :c:expr:`int`,  :c:expr:"
+"`long`, :c:expr:`double` e :c:expr:`char*`. Alguns tipos de estrutura são "
+"usados para descrever tabelas estáticas usadas para listar as funções "
+"exportadas por um módulo ou os atributos de dados de um novo tipo de objeto, "
+"e outro é usado para descrever o valor de um número complexo. Eles serão "
+"discutidos junto com as funções que os utilizam."
 
 #: ../../c-api/intro.rst:507
 msgid ""
@@ -1072,6 +1091,13 @@ msgid ""
 "most frequently used builds will be described in the remainder of this "
 "section."
 msgstr ""
+"Uma lista completa dos vários tipos de compilações de depuração está no "
+"arquivo :file:`Misc/SpecialBuilds.txt` na distribuição do código-fonte do "
+"Python. Estão disponíveis compilações que oferecem suporte ao rastreamento "
+"de contagens de referências, depuração do alocador de memória ou criação de "
+"perfil de baixo nível do laço do interpretador principal. Apenas as "
+"compilações usadas com mais frequência serão descritas no restante desta "
+"seção."
 
 #: ../../c-api/intro.rst:751
 msgid ""
diff --git a/library/ctypes.po b/library/ctypes.po
@@ -1042,6 +1042,11 @@ msgid ""
 "could play tricks with this to provide a dynamically created collection of "
 "frozen modules."
 msgstr ""
+"Este ponteiro é inicializado para apontar para um vetor de registros de :c:"
+"struct:`_frozen`, terminado por um cujos membros são todos ``NULL`` ou zero. "
+"Quando um módulo congelado é importado, ele é pesquisado nesta tabela. O "
+"código de terceiros pode fazer truques com isso para fornecer uma coleção "
+"criada dinamicamente de módulos congelados."
 
 #: ../../library/ctypes.rst:1083
 msgid ""
diff --git a/library/tkinter.po b/library/tkinter.po
@@ -107,7 +107,7 @@ msgstr ""
 
 #: ../../library/tkinter.rst:43
 msgid "`TkDocs <https://tkdocs.com/>`_"
-msgstr ""
+msgstr "`TkDocs <https://tkdocs.com/>`_"
 
 #: ../../library/tkinter.rst:42
 msgid ""
