# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR , YEAR.
#
# Translators:
# python-doc bot, 2025
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-08-21 14:26+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: pl\n"
"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10=0 && n%10=5 && "
"n%10=12 && n%100key`` member, but it can only be ``NULL`` or "
"a Python string and therefore cannot be part of a reference cycle."
msgstr ""
msgid ""
"On the other hand, even if you know a member can never be part of a cycle, "
"as a debugging aid you may want to visit it anyway just so the :mod:`gc` "
"module's :func:`~gc.get_referents` function will include it."
msgstr ""
msgid ""
"The :c:member:`~PyTypeObject.tp_traverse` function can be called from any "
"thread."
msgstr ""
msgid ""
"Garbage collection is a \"stop-the-world\" operation: even in :term:`free "
"threading` builds, only one thread state is :term:`attached ` when :c:member:`!tp_traverse` handlers run."
msgstr ""
msgid ""
"Heap-allocated types are expected to visit ``Py_TYPE(self)`` in "
"``tp_traverse``. In earlier versions of Python, due to `bug 40217 `_, doing this may lead to crashes in subclasses."
msgstr ""
msgid ""
"To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, a :c:"
"func:`Py_VISIT` macro is provided. In order to use this macro, the :c:member:"
"`~PyTypeObject.tp_traverse` implementation must name its arguments exactly "
"*visit* and *arg*:"
msgstr ""
msgid ""
"If the :c:expr:`PyObject *` *o* is not ``NULL``, call the *visit* callback, "
"with arguments *o* and *arg*. If *visit* returns a non-zero value, then "
"return it."
msgstr ""
msgid "This corresponds roughly to::"
msgstr ""
msgid ""
"#define Py_VISIT(o) \\\n"
" if (op) { \\\n"
" int visit_result = visit(o, arg); \\\n"
" if (visit_result != 0) { \\\n"
" return visit_result; \\\n"
" } \\\n"
" }"
msgstr ""
msgid "Traversal-safe functions"
msgstr ""
msgid ""
"The following functions and macros are safe to use in a :c:member:"
"`~PyTypeObject.tp_traverse` handler:"
msgstr ""
msgid "the *visit* function passed to ``tp_traverse``"
msgstr ""
msgid ":c:func:`Py_VISIT`"
msgstr ""
msgid ":c:func:`Py_SIZE`"
msgstr ""
msgid ""
":c:func:`Py_TYPE`: if called from a :c:member:`!tp_traverse` handler, :c:"
"func:`!Py_TYPE`'s result will be valid for the duration of the handler call"
msgstr ""
msgid ":c:func:`PyObject_VisitManagedDict`"
msgstr ""
msgid ""
":c:func:`PyObject_TypeCheck`, :c:func:`PyType_IsSubtype`, :c:func:"
"`PyType_HasFeature`"
msgstr ""
msgid ""
":samp:`Py{}_Check` and :samp:`Py{}_CheckExact` -- for example, :"
"c:func:`PyTuple_Check`"
msgstr ""
msgid ":ref:`duringgc-functions`"
msgstr ""
msgid "\"DuringGC\" functions"
msgstr ""
msgid ""
"The following functions should *only* be used in a :c:member:`~PyTypeObject."
"tp_traverse` handler; calling them in other contexts may have unintended "
"consequences."
msgstr ""
msgid ""
"These functions act like their counterparts without the ``_DuringGC`` "
"suffix, but they are guaranteed to not have side effects, they do not set an "
"exception on failure, and they return/set :term:`borrowed references "
"` as detailed in the individual documentation."
msgstr ""
msgid ""
"Note that these functions may fail (return ``NULL`` or ``-1``), but as they "
"do not set an exception, no error information is available. In some cases, "
"failure is not distinguishable from a successful ``NULL`` result."
msgstr ""
msgid "See :ref:`duringgc-functions` for common information."
msgstr ""
msgid ""
":c:func:`PyObject_GetTypeData`, :c:func:`PyObject_GetItemData`, :c:func:"
"`PyType_GetModuleState`, :c:func:`PyModule_GetState`, :c:func:"
"`PyModule_GetToken`, :c:func:`PyType_GetBaseByToken`"
msgstr ""
msgid ""
"Sets *\\*result* to a :term:`borrowed reference` rather than a strong one. "
"The reference is valid for the duration of the :c:member:`!tp_traverse` "
"handler call."
msgstr ""
msgid ":c:func:`PyType_GetBaseByToken`"
msgstr ""
msgid ""
"These functions return a :term:`borrowed reference`, which is valid for the "
"duration of the :c:member:`!tp_traverse` handler call."
msgstr ""
msgid ":c:func:`PyType_GetModule`, :c:func:`PyType_GetModuleByToken`"
msgstr ""
msgid "Controlling the Garbage Collector State"
msgstr ""
msgid ""
"The C-API provides the following functions for controlling garbage "
"collection runs."
msgstr ""
msgid ""
"Perform a full garbage collection, if the garbage collector is enabled. "
"(Note that :func:`gc.collect` runs it unconditionally.)"
msgstr ""
msgid ""
"Returns the number of collected + unreachable objects which cannot be "
"collected. If the garbage collector is disabled or already collecting, "
"returns ``0`` immediately. Errors during garbage collection are passed to :"
"data:`sys.unraisablehook`. This function does not raise exceptions."
msgstr ""
msgid ""
"Enable the garbage collector: similar to :func:`gc.enable`. Returns the "
"previous state, 0 for disabled and 1 for enabled."
msgstr ""
msgid ""
"Disable the garbage collector: similar to :func:`gc.disable`. Returns the "
"previous state, 0 for disabled and 1 for enabled."
msgstr ""
msgid ""
"Query the state of the garbage collector: similar to :func:`gc.isenabled`. "
"Returns the current state, 0 for disabled and 1 for enabled."
msgstr ""
msgid "Querying Garbage Collector State"
msgstr ""
msgid ""
"The C-API provides the following interface for querying information about "
"the garbage collector."
msgstr ""
msgid ""
"Run supplied *callback* on all live GC-capable objects. *arg* is passed "
"through to all invocations of *callback*."
msgstr ""
msgid ""
"If new objects are (de)allocated by the callback it is undefined if they "
"will be visited."
msgstr ""
msgid ""
"Garbage collection is disabled during operation. Explicitly running a "
"collection in the callback may lead to undefined behaviour e.g. visiting the "
"same objects multiple times or not at all."
msgstr ""
msgid ""
"Type of the visitor function to be passed to :c:func:"
"`PyUnstable_GC_VisitObjects`. *arg* is the same as the *arg* passed to "
"``PyUnstable_GC_VisitObjects``. Return ``1`` to continue iteration, return "
"``0`` to stop iteration. Other return values are reserved for now so "
"behavior on returning anything else is undefined."
msgstr ""