Update translation

github-actions[bot] · github-actions[bot] · commit 63c34f426208 · 2025-11-10T23:39:41.000Z
Co-Authored-By: Marcos Moraes
diff --git a/library/ctypes.po b/library/ctypes.po
@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-07 16:23+0000\n"
+"POT-Creation-Date: 2025-11-09 15:45+0000\n"
 "PO-Revision-Date: 2025-07-18 19:57+0000\n"
 "Last-Translator: Marcos Moraes, 2025\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
@@ -1419,6 +1419,11 @@ msgid ""
 "`BigEndianUnion`, and :class:`LittleEndianUnion` base classes.  These "
 "classes cannot contain pointer fields."
 msgstr ""
+":mod:`ctypes` usa a ordem de bytes nativa para Estruturas e Uniões. Para "
+"construir estruturas com ordem de bytes não nativa, você pode usar classes "
+"base :class:`BigEndianStructure`, :class:`LittleEndianStructure`, :class:"
+"`BigEndianUnion` e :class:`LittleEndianUnion`. Essas classes não podem "
+"conter campos de ponteiros."
 
 #: ../../library/ctypes.rst:683
 msgid "Bit fields in structures and unions"
@@ -1430,6 +1435,9 @@ msgid ""
 "fields are only possible for integer fields, the bit width is specified as "
 "the third item in the :attr:`~Structure._fields_` tuples::"
 msgstr ""
+"É possível criar estruturas e uniões contendo campos de bits. Campos de bits "
+"só são possíveis para campos de inteiros, a largura do bit é especificada "
+"como o terceiro item nas tuplas :attr:`~Structure._fields_`::"
 
 #: ../../library/ctypes.rst:689
 msgid ""
@@ -1795,7 +1803,7 @@ msgstr ""
 
 #: ../../library/ctypes.rst:902
 msgid "For these cases, the :func:`cast` function is handy."
-msgstr ""
+msgstr "Para esses casos, a função :func:`cast` é útil."
 
 #: ../../library/ctypes.rst:904
 msgid ""
@@ -1805,6 +1813,12 @@ msgid ""
 "ctypes pointer type.  It returns an instance of the second argument, which "
 "references the same memory block as the first argument::"
 msgstr ""
+"A função :func:`cast` pode ser usada para converter uma instância ctypes em "
+"um ponteiro para um diferente tipo de dado ctypes. :func:`cast` recebe dois "
+"parâmetros, um objeto ctypes que é ou pode ser convertido para um ponteiro "
+"de algum tipo, e um tipo ponteiro ctypes. Ela retorna uma instância do "
+"segundo argumento, que referencia o mesmo bloco de memória que o primeiro "
+"argumento:: "
 
 #: ../../library/ctypes.rst:910
 msgid ""
@@ -1819,6 +1833,8 @@ msgid ""
 "So, :func:`cast` can be used to assign to the ``values`` field of ``Bar`` "
 "the structure::"
 msgstr ""
+"Então, :func:`cast` pode ser usada para atribuir ao campo ``values`` da "
+"estrutura ``Bar``::"
 
 #: ../../library/ctypes.rst:918
 msgid ""
@@ -1839,6 +1855,9 @@ msgid ""
 "yet specified. In C, they are specified by forward declarations, which are "
 "defined later::"
 msgstr ""
+"*Tipos Incompletos* são estruturas, uniões ou vetores, cujos membros ainda "
+"não foram especificados. Em C, eles são especificados por declarações "
+"antecipadas, que são definidas posteriormente::"
 
 #: ../../library/ctypes.rst:934
 msgid ""
@@ -1854,7 +1873,7 @@ msgstr ""
 msgid ""
 "The straightforward translation into ctypes code would be this, but it does "
 "not work::"
-msgstr ""
+msgstr "A tradução direta para código ctypes seria esta, mas não funciona::"
 
 #: ../../library/ctypes.rst:944
 msgid ""
@@ -1875,6 +1894,10 @@ msgid ""
 "itself. In :mod:`ctypes`, we can define the ``cell`` class and set the :attr:"
 "`~Structure._fields_` attribute later, after the class statement::"
 msgstr ""
+"por que a nova ``class cell`` não está disponível na própria declaração da "
+"classe. Em :mod:`ctypes`, podemos definir a classe ``cell`` e definir o "
+"atributo :attr:`~Structure._fields_` posteriormente, após a declaração da "
+"classe::  "
 
 #: ../../library/ctypes.rst:958
 msgid ""
@@ -1892,6 +1915,9 @@ msgid ""
 "Let's try it. We create two instances of ``cell``, and let them point to "
 "each other, and finally follow the pointer chain a few times::"
 msgstr ""
+"Vamos tentar. Criamos duas instâncias de ``cell``, e deixamos que elas "
+"apontem uma para a outra, e finalmente seguimos a cadeia de ponteiros "
+"algumas vezes::"
 
 #: ../../library/ctypes.rst:969
 msgid ""
@@ -1919,13 +1945,18 @@ msgid ""
 ":mod:`ctypes` allows creating C callable function pointers from Python "
 "callables. These are sometimes called *callback functions*."
 msgstr ""
+":mod:`ctypes` permite criar ponteiros de função C chamáveis a partir de "
+"chamáveis Python. Estas são às vezes chamadas de *funções de retorno*."
 
 #: ../../library/ctypes.rst:992
 msgid ""
 "First, you must create a class for the callback function. The class knows "
 "the calling convention, the return type, and the number and types of "
 "arguments this function will receive."
 msgstr ""
+"Primeiro, você deve criar uma classe para função de retorno. A classe sabe a "
+"convenção de chamada , o tipo de retorno, e o número e tipos de argumentos "
+"que essa função irá receber."
 
 #: ../../library/ctypes.rst:996
 msgid ""
@@ -1934,13 +1965,20 @@ msgid ""
 "factory function creates types for callback functions using the ``stdcall`` "
 "calling convention."
 msgstr ""
+"A função de fábrica :func:`CFUNCTYPE` cria tipos para funções de retorno "
+"usando a convenção de chamada ``cdecl``. No Windows, a função de fábrica :"
+"func:`WINFUNCTYPE` cria tipos para funções de retorno usando a convenção de "
+"chamada ``stdcall``."
 
 #: ../../library/ctypes.rst:1001
 msgid ""
 "Both of these factory functions are called with the result type as first "
 "argument, and the callback functions expected argument types as the "
 "remaining arguments."
 msgstr ""
+"Ambas estas funções de fábrica são chamadas com o tipo de resultado como "
+"primeiro argumento, e os tipos de argumento esperados da função de retorno "
+"como os argumentos restantes."
 
 #: ../../library/ctypes.rst:1005
 msgid ""
@@ -2048,6 +2086,8 @@ msgid ""
 "The function factories can be used as decorator factories, so we may as well "
 "write::"
 msgstr ""
+"As fábricas de funções podem ser usadas como fábricas de decoradores, então "
+"também podemos escrever::"
 
 #: ../../library/ctypes.rst:1072
 msgid ""
@@ -2071,6 +2111,10 @@ msgid ""
 "are used from C code. :mod:`ctypes` doesn't, and if you don't, they may be "
 "garbage collected, crashing your program when a callback is made."
 msgstr ""
+"Certifique-se de manter referências aos objetos :func:`CFUNCTYPE` enquanto "
+"eles forem usados a partir do código C. O :mod:`ctypes` não faz isso, e se "
+"você não o fizer, eles podem ser coletados pelo coletor de lixo, travando "
+"seu programa quando uma função de retorno é chamada."
 
 #: ../../library/ctypes.rst:1091
 msgid ""
@@ -2081,24 +2125,38 @@ msgid ""
 "with :class:`threading.local` will *not* survive across different callbacks, "
 "even when those calls are made from the same C thread."
 msgstr ""
+"Além disso, note que se a função de retorno for chamada em uma thread criada "
+"fora do controle do Python (por exemplo, pelo código externo que chama a "
+"função de retorno), o ctypes cria uma nova thread Python "
+"\"dummy\" (fictícia) em cada invocação. Este comportamento é correto para a "
+"maioria dos propósitos, mas significa que os valores armazenados com :class:"
+"`threading.local` *não* sobreviverão entre diferentes funções de retorno, "
+"mesmo quando essas chamadas são feitas a partir da mesma thread C."
 
 #: ../../library/ctypes.rst:1101
 msgid "Accessing values exported from dlls"
-msgstr ""
+msgstr "Acessando valores exportados de dlls"
 
 #: ../../library/ctypes.rst:1103
 msgid ""
 "Some shared libraries not only export functions, they also export variables. "
 "An example in the Python library itself is the :c:data:`Py_Version`, Python "
 "runtime version number encoded in a single constant integer."
 msgstr ""
+"Algumas bibliotecas compartilhadas não exportam apenas funções, elas também "
+"exportam variáveis. Um exemplo na própria biblioteca Python é a :c:data:"
+"`Py_Version`, o número da versão de tempo de execução do Python codificado "
+"em um único inteiro constante."
 
 #: ../../library/ctypes.rst:1107
 msgid ""
 ":mod:`ctypes` can access values like this with the :meth:`~_CData.in_dll` "
 "class methods of the type.  *pythonapi* is a predefined symbol giving access "
 "to the Python C api::"
 msgstr ""
+":mod:`ctypes` pode acessar valores como este com os métodos de classe :meth:"
+"`~_CData.in_dll` do tipo. *pythonapi* é um símbolo predefinido que dá acesso "
+"à API C do Python::"
 
 #: ../../library/ctypes.rst:1111
 msgid ""
@@ -2112,10 +2170,12 @@ msgid ""
 "An extended example which also demonstrates the use of pointers accesses "
 "the :c:data:`PyImport_FrozenModules` pointer exported by Python."
 msgstr ""
+"Um exemplo estendido que também demonstra o uso de ponteiros acessa o "
+"ponteiro :c:data:`PyImport_FrozenModules` exportado pelo Python."
 
 #: ../../library/ctypes.rst:1118
 msgid "Quoting the docs for that value:"
-msgstr ""
+msgstr "Citando a documentação para esse valor:"
 
 #: ../../library/ctypes.rst:1120
 msgid ""
@@ -2136,6 +2196,9 @@ msgid ""
 "So manipulating this pointer could even prove useful. To restrict the "
 "example size, we show only how this table can be read with :mod:`ctypes`::"
 msgstr ""
+"Então, manipular este ponteiro pode até ser útil. Para restringir o tamanho "
+"do exemplo, mostramos apenas como esta tabela pode ser lida com :mod:"
+"`ctypes`::"
 
 #: ../../library/ctypes.rst:1128
 msgid ""
@@ -2156,6 +2219,8 @@ msgid ""
 "We have defined the :c:struct:`_frozen` data type, so we can get the pointer "
 "to the table::"
 msgstr ""
+"Nós definimos tipo de dado :c:struct:`_frozen`, para que possamos obter o "
+"ponteiro para a tabela::"
 
 #: ../../library/ctypes.rst:1142
 msgid ""
@@ -2172,6 +2237,11 @@ msgid ""
 "crash with an access violation or whatever, so it's better to break out of "
 "the loop when we hit the ``NULL`` entry::"
 msgstr ""
+"Como ``table`` é um ``pointer`` para o vetor de registros ``struct_frozen``, "
+"nós podemos iterar sobre ele, mas só temos que nos certificar de que nosso "
+"loop termine, porque ponteiros não têm tamanho. Cedo ou tarde, ele "
+"provavelmente travaria com uma violação de acesso ou algo assim, então é "
+"melhor sair do loop quando atingirmos a entrada ``NULL``::"
 
 #: ../../library/ctypes.rst:1152
 msgid ""
@@ -2192,20 +2262,25 @@ msgid ""
 "(indicated by the negative ``size`` member) is not well known, it is only "
 "used for testing. Try it out with ``import __hello__`` for example."
 msgstr ""
+"O fato de que o Python padrão tem um módulo congelado e um pacote congelado "
+"(indicado pelo membro ``size`` negativo) não é bem conhecido, é usado apenas "
+"para testes. Experimente com ``import __hello__`` por exemplo."
 
 #: ../../library/ctypes.rst:1170
 msgid "Surprises"
-msgstr ""
+msgstr "Surpresas"
 
 #: ../../library/ctypes.rst:1172
 msgid ""
 "There are some edges in :mod:`ctypes` where you might expect something other "
 "than what actually happens."
 msgstr ""
+"Existem algumas pontos limites no :mod:`ctypes` onde você pode esperar algo "
+"diferente do que realmente ocorre."
 
 #: ../../library/ctypes.rst:1175
 msgid "Consider the following example::"
-msgstr ""
+msgstr "Considere o exemplo a seguir::"
 
 #: ../../library/ctypes.rst:1177
 msgid ""
@@ -2233,6 +2308,9 @@ msgid ""
 "Hm. We certainly expected the last statement to print ``3 4 1 2``. What "
 "happened? Here are the steps of the ``rc.a, rc.b = rc.b, rc.a`` line above::"
 msgstr ""
+"Hm. Nós com certeza esperávamos que a última instrução exibisse ``3 4 1 2``. "
+"O que aconteceu? Aqui estão os passos da linha ``rc.a, rc.b = rc.b, rc.a`` "
+"acima::"
 
 #: ../../library/ctypes.rst:1198
 msgid ""
@@ -2250,19 +2328,29 @@ msgid ""
 "the contents of ``temp1``. So, the last assignment ``rc.b = temp1``, doesn't "
 "have the expected effect."
 msgstr ""
+"Observe que ``temp0`` e ``temp1`` ainda são objetos que utilizam o buffer "
+"interno do objeto ``rc`` acima. Portanto, executar ``rc.a = temp0`` copia o "
+"conteúdo do buffer de ``temp0`` para o buffer de ``rc``. Isso, por sua vez, "
+"altera o conteúdo de ``temp1``. Assim, a última atribuição ``rc.b = temp1`` "
+"não produz o efeito esperado."
 
 #: ../../library/ctypes.rst:1209
 msgid ""
 "Keep in mind that retrieving sub-objects from Structure, Unions, and Arrays "
 "doesn't *copy* the sub-object, instead it retrieves a wrapper object "
 "accessing the root-object's underlying buffer."
 msgstr ""
+"Tenha em mente que obter sub-objetos de estruturas, uniões e vetores não "
+"copia o sub-objeto; em vez disso, recupera um objeto de encapsulamento "
+"(wrapper) que acessa o buffer subjacente do objeto raiz."
 
 #: ../../library/ctypes.rst:1213
 msgid ""
 "Another example that may behave differently from what one would expect is "
 "this::"
 msgstr ""
+"Outro exemplo que pode se comportar de maneira diferente do que alguém "
+"poderia esperar é o seguinte::"
 
 #: ../../library/ctypes.rst:1215
 msgid ""
@@ -2280,6 +2368,8 @@ msgid ""
 "Objects instantiated from :class:`c_char_p` can only have their value set to "
 "bytes or integers."
 msgstr ""
+"Objetos instanciados a partir de :class:`c_char_p` só podem ter seu valor "
+"definido para bytes ou inteiros."
 
 #: ../../library/ctypes.rst:1228
 msgid ""
@@ -2289,10 +2379,16 @@ msgid ""
 "object itself, instead the ``contents`` of the object is stored.  Accessing "
 "the contents again constructs a new Python object each time!"
 msgstr ""
+"Por que está imprimindo ``False``? Instâncias de ctypes são objetos que "
+"contêm um bloco de memória, além de alguns :term:`descriptor`\\s que acessam "
+"o conteúdo dessa memória. Armazenar um objeto Python no bloco de memória não "
+"armazena o próprio objeto; em vez disso, armazena-se o seu atributo "
+"``contents``. Acessar o contents novamente constrói um novo objeto Python a "
+"cada vez!"
 
 #: ../../library/ctypes.rst:1238
 msgid "Variable-sized data types"
-msgstr ""
+msgstr "Tipos de dados de tamanho variável"
 
 #: ../../library/ctypes.rst:1240
 msgid ""
diff --git a/potodo.md b/potodo.md
@@ -1,12 +1,12 @@
-1 directory  65.23% done
-└── 3.12/  65.23% done
+1 directory  65.30% done
+└── 3.12/  65.30% done
     ├── installing/  100.00% done
     ├── distributing/  100.00% done
     ├── faq/  99.68% done
     │   └── library.po                   157 / 162 ( 96.0% translated)
     ├── using/  100.00% done
     ├── reference/  100.00% done
-    ├── library/  58.69% done
+    ├── library/  58.81% done
     │   ├── 2to3.po                      121 / 132 ( 91.0% translated)
     │   ├── array.po                      80 /  84 ( 95.0% translated)
     │   ├── ast.po                       255 / 306 ( 83.0% translated)
@@ -31,7 +31,7 @@
     │   ├── contextlib.po                 56 / 172 ( 32.0% translated)
     │   ├── contextvars.po                50 /  51 ( 98.0% translated)
     │   ├── crypt.po                       6 /  36 ( 16.0% translated)
-    │   ├── ctypes.po                    191 / 523 ( 36.0% translated)
+    │   ├── ctypes.po                    226 / 523 ( 43.0% translated)
     │   ├── curses.po                     64 / 484 ( 13.0% translated)
     │   ├── dataclasses.po                71 / 153 ( 46.0% translated)
     │   ├── datetime.po                  633 / 637 ( 99.0% translated)
diff --git a/stats.json b/stats.json
@@ -1 +1 @@
-{"completion": "65.23%", "translated": 43871, "entries": 62010, "updated_at": "2025-11-09T23:40:01+00:00Z"}
+{"completion": "65.3%", "translated": 43906, "entries": 62010, "updated_at": "2025-11-10T23:39:38+00:00Z"}

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{"completion": "65.23%", "translated": 43871, "entries": 62010, "updated_at": "2025-11-09T23:40:01+00:00Z"}`
	`1`	`+{"completion": "65.3%", "translated": 43906, "entries": 62010, "updated_at": "2025-11-10T23:39:38+00:00Z"}`