@@ -11,7 +11,7 @@ msgid ""
1111msgstr ""
1212"Project-Id-Version : Python 3.14\n "
1313"Report-Msgid-Bugs-To : \n "
14- "POT-Creation-Date : 2025-06-27 14:20 +0000\n "
14+ "POT-Creation-Date : 2025-07-25 14:21 +0000\n "
1515"PO-Revision-Date : 2025-07-18 18:48+0000\n "
1616"Last-Translator : Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n "
1717"Language-Team : Portuguese (Brazil) (https://app.transifex.com/python-doc/ "
@@ -3299,19 +3299,30 @@ msgid ""
32993299"issue a fatal error."
33003300msgstr ""
33013301
3302- #: ../../c-api/init.rst:2447
3302+ #: ../../c-api/init.rst:2446
3303+ msgid "Returns non-zero if the mutex *m* is currently locked, zero otherwise."
3304+ msgstr ""
3305+
3306+ #: ../../c-api/init.rst:2450
3307+ msgid ""
3308+ "This function is intended for use in assertions and debugging only and "
3309+ "should not be used to make concurrency control decisions, as the lock state "
3310+ "may change immediately after the check."
3311+ msgstr ""
3312+
3313+ #: ../../c-api/init.rst:2459
33033314msgid "Python Critical Section API"
33043315msgstr ""
33053316
3306- #: ../../c-api/init.rst:2449
3317+ #: ../../c-api/init.rst:2461
33073318msgid ""
33083319"The critical section API provides a deadlock avoidance layer on top of per-"
33093320"object locks for :term:`free-threaded <free threading>` CPython. They are "
33103321"intended to replace reliance on the :term:`global interpreter lock`, and are "
33113322"no-ops in versions of Python with the global interpreter lock."
33123323msgstr ""
33133324
3314- #: ../../c-api/init.rst:2454
3325+ #: ../../c-api/init.rst:2466
33153326msgid ""
33163327"Critical sections avoid deadlocks by implicitly suspending active critical "
33173328"sections and releasing the locks during calls to :c:func:"
@@ -3321,15 +3332,24 @@ msgid ""
33213332"-- they are useful because their behavior is similar to the :term:`GIL`."
33223333msgstr ""
33233334
3324- #: ../../c-api/init.rst:2461
3335+ #: ../../c-api/init.rst:2473
3336+ msgid ""
3337+ "Variants that accept :c:type:`PyMutex` pointers rather than Python objects "
3338+ "are also available. Use these variants to start a critical section in a "
3339+ "situation where there is no :c:type:`PyObject` -- for example, when working "
3340+ "with a C type that does not extend or wrap :c:type:`PyObject` but still "
3341+ "needs to call into the C API in a manner that might lead to deadlocks."
3342+ msgstr ""
3343+
3344+ #: ../../c-api/init.rst:2479
33253345msgid ""
33263346"The functions and structs used by the macros are exposed for cases where C "
33273347"macros are not available. They should only be used as in the given macro "
33283348"expansions. Note that the sizes and contents of the structures may change in "
33293349"future Python versions."
33303350msgstr ""
33313351
3332- #: ../../c-api/init.rst:2468
3352+ #: ../../c-api/init.rst:2486
33333353msgid ""
33343354"Operations that need to lock two objects at once must use :c:macro:"
33353355"`Py_BEGIN_CRITICAL_SECTION2`. You *cannot* use nested critical sections to "
@@ -3338,11 +3358,11 @@ msgid ""
33383358"lock more than two objects at once."
33393359msgstr ""
33403360
3341- #: ../../c-api/init.rst:2474
3361+ #: ../../c-api/init.rst:2492
33423362msgid "Example usage::"
33433363msgstr "Exemplo de uso::"
33443364
3345- #: ../../c-api/init.rst:2476
3365+ #: ../../c-api/init.rst:2494
33463366msgid ""
33473367"static PyObject *\n"
33483368"set_field(MyObject *self, PyObject *value)\n"
@@ -3354,7 +3374,7 @@ msgid ""
33543374"}"
33553375msgstr ""
33563376
3357- #: ../../c-api/init.rst:2485
3377+ #: ../../c-api/init.rst:2503
33583378msgid ""
33593379"In the above example, :c:macro:`Py_SETREF` calls :c:macro:`Py_DECREF`, which "
33603380"can call arbitrary code through an object's deallocation function. The "
@@ -3364,61 +3384,100 @@ msgid ""
33643384"`PyEval_SaveThread`."
33653385msgstr ""
33663386
3367- #: ../../c-api/init.rst:2493
3387+ #: ../../c-api/init.rst:2511
33683388msgid ""
33693389"Acquires the per-object lock for the object *op* and begins a critical "
33703390"section."
33713391msgstr ""
33723392
3373- #: ../../c-api/init.rst:2496 ../../c-api/init.rst:2510
3374- #: ../../c-api/init.rst:2525 ../../c-api/init.rst:2539
3393+ #: ../../c-api/init.rst:2514 ../../c-api/init.rst:2528
3394+ #: ../../c-api/init.rst:2545 ../../c-api/init.rst:2560
3395+ #: ../../c-api/init.rst:2574 ../../c-api/init.rst:2591
33753396msgid "In the free-threaded build, this macro expands to::"
33763397msgstr ""
33773398
3378- #: ../../c-api/init.rst:2498
3399+ #: ../../c-api/init.rst:2516
33793400msgid ""
33803401"{\n"
33813402" PyCriticalSection _py_cs;\n"
33823403" PyCriticalSection_Begin(&_py_cs, (PyObject*)(op))"
33833404msgstr ""
33843405
3385- #: ../../c-api/init.rst:2502 ../../c-api/init.rst:2531
3406+ #: ../../c-api/init.rst:2520 ../../c-api/init.rst:2566
33863407msgid "In the default build, this macro expands to ``{``."
33873408msgstr ""
33883409
3389- #: ../../c-api/init.rst:2508
3410+ #: ../../c-api/init.rst:2526
3411+ msgid "Locks the mutex *m* and begins a critical section."
3412+ msgstr ""
3413+
3414+ #: ../../c-api/init.rst:2530
3415+ msgid ""
3416+ "{\n"
3417+ " PyCriticalSection _py_cs;\n"
3418+ " PyCriticalSection_BeginMutex(&_py_cs, m)"
3419+ msgstr ""
3420+
3421+ #: ../../c-api/init.rst:2534
3422+ msgid ""
3423+ "Note that unlike :c:macro:`Py_BEGIN_CRITICAL_SECTION`, there is no cast for "
3424+ "the argument of the macro - it must be a :c:type:`PyMutex` pointer."
3425+ msgstr ""
3426+
3427+ #: ../../c-api/init.rst:2537 ../../c-api/init.rst:2583
3428+ msgid "On the default build, this macro expands to ``{``."
3429+ msgstr ""
3430+
3431+ #: ../../c-api/init.rst:2543
33903432msgid "Ends the critical section and releases the per-object lock."
33913433msgstr ""
33923434
3393- #: ../../c-api/init.rst:2512
3435+ #: ../../c-api/init.rst:2547
33943436msgid ""
33953437" PyCriticalSection_End(&_py_cs);\n"
33963438"}"
33973439msgstr ""
33983440
3399- #: ../../c-api/init.rst:2515 ../../c-api/init.rst:2544
3441+ #: ../../c-api/init.rst:2550 ../../c-api/init.rst:2596
34003442msgid "In the default build, this macro expands to ``}``."
34013443msgstr ""
34023444
3403- #: ../../c-api/init.rst:2521
3445+ #: ../../c-api/init.rst:2556
34043446msgid ""
34053447"Acquires the per-objects locks for the objects *a* and *b* and begins a "
34063448"critical section. The locks are acquired in a consistent order (lowest "
34073449"address first) to avoid lock ordering deadlocks."
34083450msgstr ""
34093451
3410- #: ../../c-api/init.rst:2527
3452+ #: ../../c-api/init.rst:2562
34113453msgid ""
34123454"{\n"
34133455" PyCriticalSection2 _py_cs2;\n"
34143456" PyCriticalSection2_Begin(&_py_cs2, (PyObject*)(a), (PyObject*)(b))"
34153457msgstr ""
34163458
3417- #: ../../c-api/init.rst:2537
3459+ #: ../../c-api/init.rst:2572
3460+ msgid "Locks the mutexes *m1* and *m2* and begins a critical section."
3461+ msgstr ""
3462+
3463+ #: ../../c-api/init.rst:2576
3464+ msgid ""
3465+ "{\n"
3466+ " PyCriticalSection2 _py_cs2;\n"
3467+ " PyCriticalSection2_BeginMutex(&_py_cs2, m1, m2)"
3468+ msgstr ""
3469+
3470+ #: ../../c-api/init.rst:2580
3471+ msgid ""
3472+ "Note that unlike :c:macro:`Py_BEGIN_CRITICAL_SECTION2`, there is no cast for "
3473+ "the arguments of the macro - they must be :c:type:`PyMutex` pointers."
3474+ msgstr ""
3475+
3476+ #: ../../c-api/init.rst:2589
34183477msgid "Ends the critical section and releases the per-object locks."
34193478msgstr ""
34203479
3421- #: ../../c-api/init.rst:2541
3480+ #: ../../c-api/init.rst:2593
34223481msgid ""
34233482" PyCriticalSection2_End(&_py_cs2);\n"
34243483"}"
0 commit comments