11# SOME DESCRIPTIVE TITLE.
2- # Copyright (C) 2001-2025 , Python Software Foundation
2+ # Copyright (C) 2001-2026 , Python Software Foundation
33# This file is distributed under the same license as the Python package.
44# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
55#
@@ -11,7 +11,7 @@ msgid ""
1111msgstr ""
1212"Project-Id-Version : Python 3.13\n "
1313"Report-Msgid-Bugs-To : \n "
14- "POT-Creation-Date : 2025-11-27 15:00 +0000\n "
14+ "POT-Creation-Date : 2026-01-29 15:24 +0000\n "
1515"PO-Revision-Date : 2025-09-15 01:03+0000\n "
1616"Last-Translator : python-doc bot, 2025\n "
1717"Language-Team : Portuguese (Brazil) (https://app.transifex.com/python-doc/ "
@@ -709,7 +709,11 @@ msgid ""
709709"``PyModule_Create`` or ``PyModule_FromDefAndSpec``."
710710msgstr ""
711711
712- #: ../../c-api/module.rst:536
712+ #: ../../c-api/module.rst:532
713+ msgid "Return ``0`` on success. Return ``-1`` with an exception set on error."
714+ msgstr ""
715+
716+ #: ../../c-api/module.rst:539
713717msgid ""
714718"Add the functions from the ``NULL`` terminated *functions* array to "
715719"*module*. Refer to the :c:type:`PyMethodDef` documentation for details on "
@@ -721,41 +725,41 @@ msgid ""
721725"``PyModule_FromDefAndSpec``."
722726msgstr ""
723727
724- #: ../../c-api/module.rst:545
728+ #: ../../c-api/module.rst:548
725729msgid ""
726730"The *functions* array must be statically allocated (or otherwise guaranteed "
727731"to outlive the module object)."
728732msgstr ""
729733
730- #: ../../c-api/module.rst:551
734+ #: ../../c-api/module.rst:554
731735msgid "Support functions"
732736msgstr ""
733737
734- #: ../../c-api/module.rst:553
738+ #: ../../c-api/module.rst:556
735739msgid ""
736740"The module initialization function (if using single phase initialization) or "
737741"a function called from a module execution slot (if using multi-phase "
738742"initialization), can use the following functions to help initialize the "
739743"module state:"
740744msgstr ""
741745
742- #: ../../c-api/module.rst:560
746+ #: ../../c-api/module.rst:563
743747msgid ""
744748"Add an object to *module* as *name*. This is a convenience function which "
745749"can be used from the module's initialization function."
746750msgstr ""
747751
748- #: ../../c-api/module.rst:563
752+ #: ../../c-api/module.rst:566
749753msgid ""
750754"On success, return ``0``. On error, raise an exception and return ``-1``."
751755msgstr ""
752756
753- #: ../../c-api/module.rst:565 ../../c-api/module.rst:616
754- #: ../../c-api/module.rst:643
757+ #: ../../c-api/module.rst:568 ../../c-api/module.rst:619
758+ #: ../../c-api/module.rst:646
755759msgid "Example usage::"
756760msgstr "Exemplo de uso::"
757761
758- #: ../../c-api/module.rst:567
762+ #: ../../c-api/module.rst:570
759763msgid ""
760764"static int\n"
761765"add_spam(PyObject *module, int value)\n"
@@ -770,22 +774,22 @@ msgid ""
770774" }"
771775msgstr ""
772776
773- #: ../../c-api/module.rst:579
777+ #: ../../c-api/module.rst:582
774778msgid ""
775779"To be convenient, the function accepts ``NULL`` *value* with an exception "
776780"set. In this case, return ``-1`` and just leave the raised exception "
777781"unchanged."
778782msgstr ""
779783
780- #: ../../c-api/module.rst:583
784+ #: ../../c-api/module.rst:586
781785msgid ""
782786"The example can also be written without checking explicitly if *obj* is "
783787"``NULL``::"
784788msgstr ""
785789"O exemplo também pode ser escrito sem verificar explicitamente se *obj* é "
786790"``NULL``::"
787791
788- #: ../../c-api/module.rst:586
792+ #: ../../c-api/module.rst:589
789793msgid ""
790794"static int\n"
791795"add_spam(PyObject *module, int value)\n"
@@ -797,13 +801,13 @@ msgid ""
797801" }"
798802msgstr ""
799803
800- #: ../../c-api/module.rst:595
804+ #: ../../c-api/module.rst:598
801805msgid ""
802806"Note that ``Py_XDECREF()`` should be used instead of ``Py_DECREF()`` in this "
803807"case, since *obj* can be ``NULL``."
804808msgstr ""
805809
806- #: ../../c-api/module.rst:598
810+ #: ../../c-api/module.rst:601
807811msgid ""
808812"The number of different *name* strings passed to this function should be "
809813"kept small, usually by only using statically allocated strings as *name*. "
@@ -813,47 +817,47 @@ msgid ""
813817"internally to create a key object."
814818msgstr ""
815819
816- #: ../../c-api/module.rst:611
820+ #: ../../c-api/module.rst:614
817821msgid ""
818822"Similar to :c:func:`PyModule_AddObjectRef`, but \" steals\" a reference to "
819823"*value*. It can be called with a result of function that returns a new "
820824"reference without bothering to check its result or even saving it to a "
821825"variable."
822826msgstr ""
823827
824- #: ../../c-api/module.rst:618
828+ #: ../../c-api/module.rst:621
825829msgid ""
826830"if (PyModule_Add(module, \" spam\" , PyBytes_FromString(value)) < 0) {\n"
827831" goto error;\n"
828832"}"
829833msgstr ""
830834
831- #: ../../c-api/module.rst:627
835+ #: ../../c-api/module.rst:630
832836msgid ""
833837"Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to "
834838"*value* on success (if it returns ``0``)."
835839msgstr ""
836840
837- #: ../../c-api/module.rst:630
841+ #: ../../c-api/module.rst:633
838842msgid ""
839843"The new :c:func:`PyModule_Add` or :c:func:`PyModule_AddObjectRef` functions "
840844"are recommended, since it is easy to introduce reference leaks by misusing "
841845"the :c:func:`PyModule_AddObject` function."
842846msgstr ""
843847
844- #: ../../c-api/module.rst:637
848+ #: ../../c-api/module.rst:640
845849msgid ""
846850"Unlike other functions that steal references, ``PyModule_AddObject()`` only "
847851"releases the reference to *value* **on success**."
848852msgstr ""
849853
850- #: ../../c-api/module.rst:640
854+ #: ../../c-api/module.rst:643
851855msgid ""
852856"This means that its return value must be checked, and calling code must :c:"
853857"func:`Py_XDECREF` *value* manually on error."
854858msgstr ""
855859
856- #: ../../c-api/module.rst:645
860+ #: ../../c-api/module.rst:648
857861msgid ""
858862"PyObject *obj = PyBytes_FromString(value);\n"
859863"if (PyModule_AddObject(module, \" spam\" , obj) < 0) {\n"
@@ -867,59 +871,59 @@ msgid ""
867871"// Py_XDECREF(obj) is not needed here."
868872msgstr ""
869873
870- #: ../../c-api/module.rst:658
874+ #: ../../c-api/module.rst:661
871875msgid ":c:func:`PyModule_AddObject` is :term:`soft deprecated`."
872876msgstr ""
873877
874- #: ../../c-api/module.rst:663
878+ #: ../../c-api/module.rst:666
875879msgid ""
876880"Add an integer constant to *module* as *name*. This convenience function "
877881"can be used from the module's initialization function. Return ``-1`` with an "
878882"exception set on error, ``0`` on success."
879883msgstr ""
880884
881- #: ../../c-api/module.rst:667
885+ #: ../../c-api/module.rst:670
882886msgid ""
883887"This is a convenience function that calls :c:func:`PyLong_FromLong` and :c:"
884888"func:`PyModule_AddObjectRef`; see their documentation for details."
885889msgstr ""
886890
887- #: ../../c-api/module.rst:673
891+ #: ../../c-api/module.rst:676
888892msgid ""
889893"Add a string constant to *module* as *name*. This convenience function can "
890894"be used from the module's initialization function. The string *value* must "
891895"be ``NULL``-terminated. Return ``-1`` with an exception set on error, ``0`` "
892896"on success."
893897msgstr ""
894898
895- #: ../../c-api/module.rst:678
899+ #: ../../c-api/module.rst:681
896900msgid ""
897901"This is a convenience function that calls :c:func:"
898902"`PyUnicode_InternFromString` and :c:func:`PyModule_AddObjectRef`; see their "
899903"documentation for details."
900904msgstr ""
901905
902- #: ../../c-api/module.rst:685
906+ #: ../../c-api/module.rst:688
903907msgid ""
904908"Add an int constant to *module*. The name and the value are taken from "
905909"*macro*. For example ``PyModule_AddIntMacro(module, AF_INET)`` adds the int "
906910"constant *AF_INET* with the value of *AF_INET* to *module*. Return ``-1`` "
907911"with an exception set on error, ``0`` on success."
908912msgstr ""
909913
910- #: ../../c-api/module.rst:693
914+ #: ../../c-api/module.rst:696
911915msgid "Add a string constant to *module*."
912916msgstr ""
913917
914- #: ../../c-api/module.rst:697
918+ #: ../../c-api/module.rst:700
915919msgid ""
916920"Add a type object to *module*. The type object is finalized by calling "
917921"internally :c:func:`PyType_Ready`. The name of the type object is taken from "
918922"the last component of :c:member:`~PyTypeObject.tp_name` after dot. Return "
919923"``-1`` with an exception set on error, ``0`` on success."
920924msgstr ""
921925
922- #: ../../c-api/module.rst:707
926+ #: ../../c-api/module.rst:710
923927msgid ""
924928"Indicate that *module* does or does not support running without the global "
925929"interpreter lock (GIL), using one of the values from :c:macro:`Py_mod_gil`. "
@@ -930,25 +934,25 @@ msgid ""
930934"Return ``-1`` with an exception set on error, ``0`` on success."
931935msgstr ""
932936
933- #: ../../c-api/module.rst:720
937+ #: ../../c-api/module.rst:723
934938msgid "Module lookup"
935939msgstr "Pesquisa por módulos"
936940
937- #: ../../c-api/module.rst:722
941+ #: ../../c-api/module.rst:725
938942msgid ""
939943"Single-phase initialization creates singleton modules that can be looked up "
940944"in the context of the current interpreter. This allows the module object to "
941945"be retrieved later with only a reference to the module definition."
942946msgstr ""
943947
944- #: ../../c-api/module.rst:726
948+ #: ../../c-api/module.rst:729
945949msgid ""
946950"These functions will not work on modules created using multi-phase "
947951"initialization, since multiple such modules can be created from a single "
948952"definition."
949953msgstr ""
950954
951- #: ../../c-api/module.rst:731
955+ #: ../../c-api/module.rst:734
952956msgid ""
953957"Returns the module object that was created from *def* for the current "
954958"interpreter. This method requires that the module object has been attached "
@@ -957,18 +961,18 @@ msgid ""
957961"to the interpreter state yet, it returns ``NULL``."
958962msgstr ""
959963
960- #: ../../c-api/module.rst:738
964+ #: ../../c-api/module.rst:741
961965msgid ""
962966"Attaches the module object passed to the function to the interpreter state. "
963967"This allows the module object to be accessible via :c:func:"
964968"`PyState_FindModule`."
965969msgstr ""
966970
967- #: ../../c-api/module.rst:741
971+ #: ../../c-api/module.rst:744
968972msgid "Only effective on modules created using single-phase initialization."
969973msgstr ""
970974
971- #: ../../c-api/module.rst:743
975+ #: ../../c-api/module.rst:746
972976msgid ""
973977"Python calls ``PyState_AddModule`` automatically after importing a module, "
974978"so it is unnecessary (but harmless) to call it from module initialization "
@@ -979,17 +983,17 @@ msgid ""
979983"state updates)."
980984msgstr ""
981985
982- #: ../../c-api/module.rst:751 ../../c-api/module.rst:762
986+ #: ../../c-api/module.rst:754 ../../c-api/module.rst:765
983987msgid "The caller must hold the GIL."
984988msgstr ""
985989
986- #: ../../c-api/module.rst:753
990+ #: ../../c-api/module.rst:756
987991msgid "Return ``-1`` with an exception set on error, ``0`` on success."
988992msgstr ""
989993"Retorna ``-1`` com uma exceção definida em caso de erro, ``0`` em caso de "
990994"sucesso."
991995
992- #: ../../c-api/module.rst:759
996+ #: ../../c-api/module.rst:762
993997msgid ""
994998"Removes the module object created from *def* from the interpreter state. "
995999"Return ``-1`` with an exception set on error, ``0`` on success."
0 commit comments