sys.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Revisto <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
# arman mohebali <armanmohebali@outlook.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-10-01 14:41+0330\n"
"PO-Revision-Date: 2021-06-28 00:50+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"

msgid "Operating System Utilities"
msgstr "ابزارهای سیستم‌عامل"

msgid "Return the file system representation for *path*. If the object is a :class:`str` or :class:`bytes` object, then a new :term:`strong reference` is returned. If the object implements the :class:`os.PathLike` interface, then :meth:`~os.PathLike.__fspath__` is returned as long as it is a :class:`str` or :class:`bytes` object. Otherwise :exc:`TypeError` is raised and ``NULL`` is returned."
msgstr "نمایش سامانه فایل‌بندی برای *path* را برمی‌گرداند. اگر شیء از نوع :class:`str` یا :class:`bytes` باشد، یک :term:`ارجاع قوی <strong reference>` جدید برگردانده می‌شود. اگر شیء رابط :class:`os.PathLike` را پیاده‌سازی کند، :meth:`~os.PathLike.__fspath__` به شرط آن‌که یک شیء :class:`str` یا :class:`bytes` باشد، برگردانده می‌شود. در غیر این صورت، استثنای :exc:`TypeError` برداشته می‌شود و ``NULL`` برگردانده می‌شود."

msgid "Return true (nonzero) if the standard I/O file *fp* with name *filename* is deemed interactive.  This is the case for files for which ``isatty(fileno(fp))`` is true.  If the :c:member:`PyConfig.interactive` is non-zero, this function also returns true if the *filename* pointer is ``NULL`` or if the name is equal to one of the strings ``'<stdin>'`` or ``'???'``."
msgstr "اگر پرونده‌ی ورودی/خروجی استاندارد *fp* با نام *filename* تعاملی در نظر گرفته شود، مقدار true (غیرصفر) برمی‌گرداند. این حالت برای پرونده‌هایی که ``isatty(fileno(fp))`` در آن‌ها true است، برقرار است. اگر :c:member:`PyConfig.interactive` غیرصفر باشد، این تابع همچنین در صورتی که اشاره‌گر *filename* برابر ``NULL`` باشد یا نام برابر با یکی از رشته‌های ``'<stdin>'`` یا ``'???'`` باشد، مقدار true برمی‌گرداند."

msgid "This function must not be called before Python is initialized."
msgstr "این تابع نباید پیش از مقداردهی اولیه پایتون فراخوانی شود."

msgid "Function to prepare some internal state before a process fork.  This should be called before calling :c:func:`fork` or any similar function that clones the current process. Only available on systems where :c:func:`fork` is defined."
msgstr "تابعی برای آماده‌سازی برخی وضعیت‌های داخلی پیش از انشعاب فرایند. این تابع باید پیش از فراخوانی :c:func:`fork` یا هر تابع مشابه‌ای که از فرایند فعلی رونوشت می‌گیرد، فراخوانی شود. تنها در سیستم‌هایی که :c:func:`fork` در آن‌ها تعریف شده است در دسترس است."

msgid "The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread <fork-and-threads>` (of the :ref:`\"main\" interpreter <sub-interpreter-support>`).  The same is true for ``PyOS_BeforeFork()``."
msgstr "فراخوانی :c:func:`fork` در C باید فقط از :ref:`نخِ «اصلی» <fork-and-threads>` (از :ref:`مفسرِ «اصلی» <sub-interpreter-support>`) انجام شود. همین موضوع برای ``PyOS_BeforeFork()`` نیز صادق است."

msgid "Function to update some internal state after a process fork.  This should be called from the parent process after calling :c:func:`fork` or any similar function that clones the current process, regardless of whether process cloning was successful. Only available on systems where :c:func:`fork` is defined."
msgstr "تابعی برای به‌روزرسانی برخی از وضعیت‌های داخلی پس از انشعاب فرایند. این تابع باید از فرایند والد، پس از فراخوانی :c:func:`fork` یا هر تابع مشابه‌ای که از فرایند فعلی رونوشت می‌گیرد، فراخوانی شود؛ صرف‌نظر از اینکه رونوشت‌گیری فرایند موفق بوده است یا خیر. تنها روی سیستم‌هایی که :c:func:`fork` در آن‌ها تعریف شده است در دسترس است."

msgid "The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread <fork-and-threads>` (of the :ref:`\"main\" interpreter <sub-interpreter-support>`).  The same is true for ``PyOS_AfterFork_Parent()``."
msgstr "فراخوانی :c:func:`fork` در C باید تنها از :ref:`نخ «اصلی» <fork-and-threads>` (از :ref:`مفسر «اصلی» <sub-interpreter-support>`) انجام شود. همین امر برای ``PyOS_AfterFork_Parent()`` نیز صادق است."

msgid "Function to update internal interpreter state after a process fork. This must be called from the child process after calling :c:func:`fork`, or any similar function that clones the current process, if there is any chance the process will call back into the Python interpreter. Only available on systems where :c:func:`fork` is defined."
msgstr "تابعی برای به‌روزرسانی وضعیت داخلی مفسر پس از انشعاب یک فرایند. این تابع باید از فرایند فرزند پس از فراخوانی :c:func:`fork` یا هر تابع مشابه‌ای که فرایند فعلی را رونوشت می‌کند، فراخوانی شود، اگر احتمالی وجود داشته باشد که فرایند دوباره مفسر پایتون را فراخوانی کند. این تابع فقط در سیستم‌هایی که :c:func:`fork` در آن‌ها تعریف شده است دسترس‌پذیر است."

msgid "The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread <fork-and-threads>` (of the :ref:`\"main\" interpreter <sub-interpreter-support>`).  The same is true for ``PyOS_AfterFork_Child()``."
msgstr "فراخوانی :c:func:`fork` در C باید فقط از :ref:`نخ «اصلی» <fork-and-threads>` (از :ref:`مفسر «اصلی» <sub-interpreter-support>`) انجام شود. همین امر برای ``PyOS_AfterFork_Child()`` نیز صادق است."

msgid ":func:`os.register_at_fork` allows registering custom Python functions to be called by :c:func:`PyOS_BeforeFork()`, :c:func:`PyOS_AfterFork_Parent` and  :c:func:`PyOS_AfterFork_Child`."
msgstr ":func:`os.register_at_fork` اجازه می‌دهد توابع سفارشی پایتون را ثبت کنید تا توسط :c:func:`PyOS_BeforeFork()`، :c:func:`PyOS_AfterFork_Parent` و :c:func:`PyOS_AfterFork_Child` فراخوانی شوند."

msgid "Function to update some internal state after a process fork; this should be called in the new process if the Python interpreter will continue to be used. If a new executable is loaded into the new process, this function does not need to be called."
msgstr "تابعی برای به‌روزرسانی برخی از وضعیت‌های داخلی پس از انشعاب فرایند؛ اگر قرار باشد مفسر پایتون همچنان استفاده شود، این تابع باید در فرایند جدید فراخوانی شود. اگر یک پرونده اجرایی جدید در فرایند جدید بارگذاری شود، نیازی به فراخوانی این تابع نیست."

msgid "This function is superseded by :c:func:`PyOS_AfterFork_Child()`."
msgstr "این تابع توسط :c:func:`PyOS_AfterFork_Child()` جایگزین شده است."

msgid "Return true when the interpreter runs out of stack space.  This is a reliable check, but is only available when :c:macro:`!USE_STACKCHECK` is defined (currently on certain versions of Windows using the Microsoft Visual C++ compiler). :c:macro:`!USE_STACKCHECK` will be defined automatically; you should never change the definition in your own code."
msgstr "وقتی فضای پشته‌ی مفسر تمام شود، مقدار true را برمی‌گرداند. این یک بررسی قابل اعتماد است، اما تنها زمانی در دسترس است که :c:macro:`!USE_STACKCHECK` تعریف شده باشد (در حال حاضر در نسخه‌هایی از ویندوز که از کامپایلر Microsoft Visual C++ استفاده می‌کنند). :c:macro:`!USE_STACKCHECK` به‌صورت خودکار تعریف می‌شود؛ شما هرگز نباید این تعریف را در کد خودتان تغییر دهید."

msgid "Return the current signal handler for signal *i*.  This is a thin wrapper around either :c:func:`!sigaction` or :c:func:`!signal`.  Do not call those functions directly!"
msgstr "هندلر فعلی سیگنال *i* را برمی‌گرداند. این تابع پوششی نازک حول :c:func:`!sigaction` یا :c:func:`!signal` است. این توابع را مستقیماً فراخوانی نکنید!"

msgid "Set the signal handler for signal *i* to be *h*; return the old signal handler. This is a thin wrapper around either :c:func:`!sigaction` or :c:func:`!signal`.  Do not call those functions directly!"
msgstr "هندلر سیگنال مربوط به سیگنال *i* را به *h* تنظیم می‌کند؛ هندلر سیگنال قدیمی را برمی‌گرداند. این تابع یک پوشش نازک حول :c:func:`!sigaction` یا :c:func:`!signal` است.  آن توابع را مستقیماً فراخوانی نکنید!"

msgid "Check if a :c:macro:`!SIGINT` signal has been received."
msgstr "بررسی می‌کند که آیا سیگنال :c:macro:`!SIGINT` دریافت شده است یا خیر."

msgid "Returns ``1`` if a :c:macro:`!SIGINT` has occurred and clears the signal flag, or ``0`` otherwise."
msgstr "اگر سیگنال :c:macro:`!SIGINT` رخ داده باشد، ``1`` را برمی‌گرداند و پرچم سیگنال را پاک می‌کند؛ در غیر این صورت ``0``."

msgid "In most cases, you should prefer :c:func:`PyErr_CheckSignals` over this function. :c:func:`!PyErr_CheckSignals` invokes the appropriate signal handlers for all pending signals, allowing Python code to handle the signal properly. This function only detects :c:macro:`!SIGINT` and does not invoke any Python signal handlers."
msgstr "در بیشتر موارد، بهتر است به‌جای این تابع از :c:func:`PyErr_CheckSignals` استفاده کنید. :c:func:`!PyErr_CheckSignals` هندلرهای مناسب سیگنال را برای همه‌ی سیگنال‌های در انتظار فراخوانی می‌کند و به کد پایتون اجازه می‌دهد سیگنال را به‌درستی مدیریت کند. این تابع فقط :c:macro:`!SIGINT` را تشخیص می‌دهد و هیچ‌یک از هندلرهای سیگنال پایتون را فراخوانی نمی‌کند."

msgid "This function is async-signal-safe and this function cannot fail. The caller must hold an :term:`attached thread state`."
msgstr "این تابع نسبت به سیگنال‌های نا‌همگام ایمن (async-signal-safe) است و نمی‌تواند شکست بخورد. فراخوان‌کننده باید یک :term:`attached thread state` را در اختیار داشته باشد."

msgid "This function should not be called directly: use the :c:type:`PyConfig` API with the :c:func:`PyConfig_SetBytesString` function which ensures that :ref:`Python is preinitialized <c-preinit>`."
msgstr "این تابع نباید مستقیماً فراخوانی شود: از API :c:type:`PyConfig` به همراه تابع :c:func:`PyConfig_SetBytesString` استفاده کنید که تضمین می‌کند :ref:`پایتون از پیش مقداردهی اولیه شده است <c-preinit>`."

msgid "This function must not be called before :ref:`Python is preinitialized <c-preinit>` and so that the LC_CTYPE locale is properly configured: see the :c:func:`Py_PreInitialize` function."
msgstr "این تابع نباید پیش از :ref:`پیش‌مقداردهی اولیه پایتون <c-preinit>` و پیش از پیکربندی درست locale مربوط به LC_CTYPE فراخوانی شود: تابع :c:func:`Py_PreInitialize` را ببینید."

msgid "Decode a byte string from the :term:`filesystem encoding and error handler`. If the error handler is :ref:`surrogateescape error handler <surrogateescape>`, undecodable bytes are decoded as characters in range U+DC80..U+DCFF; and if a byte sequence can be decoded as a surrogate character, the bytes are escaped using the surrogateescape error handler instead of decoding them."
msgstr "یک رشته بایتی را از :term:`کدگذاری و هندلر خطای سامانه فایل‌بندی <filesystem encoding and error handler>` کدگشایی می‌کند. اگر هندلر خطا :ref:`هندلر خطای surrogateescape <surrogateescape>` باشد، بایت‌های کدگشایی‌ناپذیر به‌عنوان نویسه‌هایی در بازه U+DC80..U+DCFF کدگشایی می‌شوند؛ و اگر بتوان دنباله‌ای از بایت‌ها را به‌عنوان یک نویسه جانشین کدگشایی کرد، بایت‌ها به‌جای کدگشایی‌شدن، با استفاده از هندلر خطای surrogateescape خنثی می‌شوند."

msgid "Return a pointer to a newly allocated wide character string, use :c:func:`PyMem_RawFree` to free the memory. If size is not ``NULL``, write the number of wide characters excluding the null character into ``*size``"
msgstr "یک اشاره‌گر به رشته نویسه پهنِ تازه تخصیص‌یافته برمی‌گرداند؛ برای آزاد کردن حافظه از :c:func:`PyMem_RawFree` استفاده کنید. اگر size برابر ``NULL`` نباشد، تعداد نویسه‌های پهن را بدون احتساب نویسه تهی در ``*size`` می‌نویسد."

msgid "Return ``NULL`` on decoding error or memory allocation error. If *size* is not ``NULL``, ``*size`` is set to ``(size_t)-1`` on memory error or set to ``(size_t)-2`` on decoding error."
msgstr "در صورت خطای کدگشایی یا خطای تخصیص حافظه، ``NULL`` را برمی‌گرداند. اگر *size* برابر ``NULL`` نباشد، ``*size`` در خطای حافظه به ``(size_t)-1`` و در خطای کدگشایی به ``(size_t)-2`` تنظیم می‌شود."

msgid "The :term:`filesystem encoding and error handler` are selected by :c:func:`PyConfig_Read`: see :c:member:`~PyConfig.filesystem_encoding` and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`."
msgstr ":term:`filesystem encoding and error handler` توسط :c:func:`PyConfig_Read` انتخاب می‌شوند: به اعضای :c:member:`~PyConfig.filesystem_encoding` و :c:member:`~PyConfig.filesystem_errors` از :c:type:`PyConfig` مراجعه کنید."

msgid "Decoding errors should never happen, unless there is a bug in the C library."
msgstr "خطاهای کدگشایی هرگز نباید رخ دهند، مگر اینکه اشکالی در کتابخانه C وجود داشته باشد."

msgid "Use the :c:func:`Py_EncodeLocale` function to encode the character string back to a byte string."
msgstr "برای کدگذاری رشته‌ی نویسه‌ها و بازگرداندن آن به یک رشته بایتی، از تابع :c:func:`Py_EncodeLocale` استفاده کنید."

msgid "The :c:func:`PyUnicode_DecodeFSDefaultAndSize` and :c:func:`PyUnicode_DecodeLocaleAndSize` functions."
msgstr "توابع :c:func:`PyUnicode_DecodeFSDefaultAndSize` و :c:func:`PyUnicode_DecodeLocaleAndSize`."

msgid "The function now uses the UTF-8 encoding in the :ref:`Python UTF-8 Mode <utf8-mode>`."
msgstr "این تابع اکنون در :ref:`حالت UTF-8 پایتون <utf8-mode>` از کدگذاری UTF-8 استفاده می‌کند."

msgid "The function now uses the UTF-8 encoding on Windows if :c:member:`PyPreConfig.legacy_windows_fs_encoding` is zero;"
msgstr "اگر :c:member:`PyPreConfig.legacy_windows_fs_encoding` صفر باشد، این تابع اکنون در ویندوز از کدگذاری UTF-8 استفاده می‌کند؛"

msgid "Encode a wide character string to the :term:`filesystem encoding and error handler`. If the error handler is :ref:`surrogateescape error handler <surrogateescape>`, surrogate characters in the range U+DC80..U+DCFF are converted to bytes 0x80..0xFF."
msgstr "یک رشته‌ی نویسه پهن را با :term:`کدگذاری سامانه فایل‌بندی و هندلر خطا <filesystem encoding and error handler>` کدگذاری می‌کند. اگر هندلر خطا :ref:`هندلر خطای surrogateescape <surrogateescape>` باشد، نویسه‌های جانشین در بازه‌ی U+DC80..U+DCFF به بایت‌های 0x80..0xFF تبدیل می‌شوند."

msgid "Return a pointer to a newly allocated byte string, use :c:func:`PyMem_Free` to free the memory. Return ``NULL`` on encoding error or memory allocation error."
msgstr "یک اشاره‌گر به رشته بایتی تازه تخصیص‌یافته را برمی‌گرداند؛ برای آزاد کردن حافظه از :c:func:`PyMem_Free` استفاده کنید. در صورت خطای کدگذاری یا خطای تخصیص حافظه، ``NULL`` برمی‌گرداند."

msgid "If error_pos is not ``NULL``, ``*error_pos`` is set to ``(size_t)-1`` on success,  or set to the index of the invalid character on encoding error."
msgstr "اگر error_pos برابر ``NULL`` نباشد، ``*error_pos`` در صورت موفقیت به ``(size_t)-1`` و در صورت وقوع خطای کدگذاری به اندیس نویسه نامعتبر تنظیم می‌شود."

msgid "Use the :c:func:`Py_DecodeLocale` function to decode the bytes string back to a wide character string."
msgstr "از تابع :c:func:`Py_DecodeLocale` برای کدگشایی رشته بایتی و بازگرداندن آن به یک رشته نویسه پهن استفاده کنید."

msgid "The :c:func:`PyUnicode_EncodeFSDefault` and :c:func:`PyUnicode_EncodeLocale` functions."
msgstr "توابع :c:func:`PyUnicode_EncodeFSDefault` و :c:func:`PyUnicode_EncodeLocale`."

msgid "The function now uses the UTF-8 encoding on Windows if :c:member:`PyPreConfig.legacy_windows_fs_encoding` is zero."
msgstr "اگر :c:member:`PyPreConfig.legacy_windows_fs_encoding` صفر باشد، این تابع اکنون در ویندوز از کدگذاری UTF-8 استفاده می‌کند."

msgid "Similar to :c:func:`!fopen`, but *path* is a Python object and an exception is set on error."
msgstr "مشابه :c:func:`!fopen` است، اما *path* یک شیء پایتون است و در صورت خطا یک استثنا تنظیم می‌شود."

msgid "*path* must be a :class:`str` object, a :class:`bytes` object, or a :term:`path-like object`."
msgstr "*path* باید یک شیء :class:`str`، یک شیء :class:`bytes` یا یک :term:`شیء شبه‌مسیر <path-like object>` باشد."

msgid "On success, return the new file pointer. On error, set an exception and return ``NULL``."
msgstr "در صورت موفقیت، اشاره‌گر جدید پرونده را برمی‌گرداند. در صورت خطا، یک استثنا تنظیم کرده و ``NULL`` را برمی‌گرداند."

msgid "The file must be closed by :c:func:`Py_fclose` rather than calling directly :c:func:`!fclose`."
msgstr "پرونده باید توسط :c:func:`Py_fclose` بسته شود، نه با فراخوانی مستقیم :c:func:`!fclose`."

msgid "The file descriptor is created non-inheritable (:pep:`446`)."
msgstr "توصیف‌گر پرونده به‌صورت غیرقابل ارث‌بری ایجاد می‌شود (:pep:`446`)."

msgid "The caller must have an :term:`attached thread state`."
msgstr "فراخواننده باید :term:`attached thread state` داشته باشد."

msgid "Close a file that was opened by :c:func:`Py_fopen`."
msgstr "بستن پرونده‌ای که با :c:func:`Py_fopen` باز شده است."

msgid "On success, return ``0``. On error, return ``EOF`` and ``errno`` is set to indicate the error. In either case, any further access (including another call to :c:func:`Py_fclose`) to the stream results in undefined behavior."
msgstr "در صورت موفقیت، ``0`` را برمی‌گرداند. در صورت خطا، ``EOF`` را برمی‌گرداند و ``errno`` برای نشان دادن خطا تنظیم می‌شود. در هر دو حالت، هر دسترسی بعدی (از جمله فراخوانی مجدد :c:func:`Py_fclose`) به جریان، منجر به رفتار تعریف‌نشده می‌شود."

msgid "System Functions"
msgstr "توابع سیستمی"

msgid "These are utility functions that make functionality from the :mod:`sys` module accessible to C code.  They all work with the current interpreter thread's :mod:`sys` module's dict, which is contained in the internal thread state structure."
msgstr "این‌ها توابع کاربردی هستند که کارکردهای ماژول :mod:`sys` را برای کد C در دسترس قرار می‌دهند. همه‌ی آن‌ها با دیکشنری ماژول :mod:`sys` مربوط به نخ فعلی مفسر کار می‌کنند که در ساختار وضعیت داخلی نخ قرار دارد."

msgid "Get the attribute *name* of the :mod:`sys` module. Return a :term:`strong reference`. Raise :exc:`RuntimeError` and return ``NULL`` if it does not exist or if the :mod:`sys` module cannot be found."
msgstr "ویژگی *name* ماژول :mod:`sys` را دریافت کنید. یک :term:`ارجاع قوی <strong reference>` برگردانید. اگر وجود نداشته باشد یا ماژول :mod:`sys` پیدا نشود، استثنای :exc:`RuntimeError` را بالا آورده و ``NULL`` برگردانید."

msgid "If the non-existing object should not be treated as a failure, you can use :c:func:`PySys_GetOptionalAttr` instead."
msgstr "اگر شیء ناموجود نباید به عنوان یک خطا تلقی شود، می‌توانید به جای آن از :c:func:`PySys_GetOptionalAttr` استفاده کنید."

msgid "This is the same as :c:func:`PySys_GetAttr`, but *name* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr "این تابع مشابه :c:func:`PySys_GetAttr` است، اما *name* به جای :c:expr:`PyObject*`، به عنوان یک رشته‌ی بایت رمزگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود."

msgid "If the non-existing object should not be treated as a failure, you can use :c:func:`PySys_GetOptionalAttrString` instead."
msgstr "اگر شیء ناموجود نباید به عنوان یک خطا تلقی شود، می‌توانید به جای آن از :c:func:`PySys_GetOptionalAttrString` استفاده کنید."

msgid "Variant of :c:func:`PySys_GetAttr` which doesn't raise exception if the object does not exist."
msgstr "نوع دیگری از :c:func:`PySys_GetAttr` که اگر شیء وجود نداشته باشد، استثنایی بالا نمی‌آورد."

msgid "Set *\\*result* to a new :term:`strong reference` to the object and return ``1`` if the object exists."
msgstr "اگر شیء وجود داشته باشد، *\\*result* را به یک :term:`ارجاع قوی <strong reference>` جدید به شیء تنظیم کرده و ``1`` برگردانید."

msgid "Set *\\*result* to ``NULL`` and return ``0`` without setting an exception if the object does not exist."
msgstr "اگر شیء وجود نداشته باشد، *\\*result* را روی ``NULL`` تنظیم کرده و بدون تنظیم هیچ استثنایی، ``0`` برگردانید."

msgid "Set an exception, set *\\*result* to ``NULL``, and return ``-1``, if an error occurred."
msgstr "اگر خطایی رخ دهد، یک استثنا تنظیم کنید، *\\*result* را روی ``NULL`` قرار دهید و ``-1`` برگردانید."

msgid "This is the same as :c:func:`PySys_GetOptionalAttr`, but *name* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr "این تابع مشابه :c:func:`PySys_GetOptionalAttr` است، اما *name* به جای :c:expr:`PyObject*`، به عنوان یک رشته‌ی بایت رمزگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود."

msgid "Similar to :c:func:`PySys_GetAttrString`, but return a :term:`borrowed reference` and return ``NULL`` *without* setting exception on failure."
msgstr "مشابه :c:func:`PySys_GetAttrString` است، اما یک :term:`ارجاع امانتی <borrowed reference>` برمی‌گرداند و در صورت بروز خطا، *بدون* تنظیم استثنا، ``NULL`` برمی‌گرداند."

msgid "Preserves exception that was set before the call."
msgstr "استثنایی را که قبل از فراخوانی تنظیم شده بود، حفظ می‌کند."

msgid "Set *name* in the :mod:`sys` module to *v* unless *v* is ``NULL``, in which case *name* is deleted from the sys module. Returns ``0`` on success, ``-1`` on error."
msgstr "*name* را در ماژول :mod:`sys` برابر *v* قرار می‌دهد، مگر اینکه *v* ``NULL`` باشد که در این صورت *name* از ماژول sys حذف می‌شود. در صورت موفقیت ``0`` و در صورت خطا ``-1`` برمی‌گرداند."

msgid "Write the output string described by *format* to :data:`sys.stdout`.  No exceptions are raised, even if truncation occurs (see below)."
msgstr "رشته خروجی توصیف‌شده توسط *format* را در :data:`sys.stdout` می‌نویسد. هیچ استثنایی به‌وجود نمی‌آید، حتی اگر اسلایس رخ دهد (در ادامه ببینید)."

msgid "*format* should limit the total size of the formatted output string to 1000 bytes or less -- after 1000 bytes, the output string is truncated. In particular, this means that no unrestricted \"%s\" formats should occur; these should be limited using \"%.<N>s\" where <N> is a decimal number calculated so that <N> plus the maximum size of other formatted text does not exceed 1000 bytes.  Also watch out for \"%f\", which can print hundreds of digits for very large numbers."
msgstr "*format* باید اندازه‌ی کل رشته‌ی خروجی قالب‌بندی‌شده را به ۱۰۰۰ بایت یا کمتر محدود کند -- پس از ۱۰۰۰ بایت، رشته‌ی خروجی بریده می‌شود. به‌طور خاص، این بدان معناست که نباید هیچ قالب \"%s\" بدون محدودیت وجود داشته باشد؛ این قالب‌ها باید با استفاده از \"%.<N>s\" محدود شوند که در آن <N> عددی دهدهی است که به‌گونه‌ای محاسبه می‌شود که <N> به‌علاوه‌ی حداکثر اندازه‌ی سایر متن‌های قالب‌بندی‌شده از ۱۰۰۰ بایت بیشتر نشود. همچنین مراقب \"%f\" باشید که می‌تواند برای اعداد بسیار بزرگ صدها رقم چاپ کند."

msgid "If a problem occurs, or :data:`sys.stdout` is unset, the formatted message is written to the real (C level) *stdout*."
msgstr "اگر مشکلی رخ دهد یا :data:`sys.stdout` تنظیم نشده باشد، پیام قالب‌بندی‌شده به *stdout* واقعی (در سطح C) نوشته می‌شود."

msgid "As :c:func:`PySys_WriteStdout`, but write to :data:`sys.stderr` or *stderr* instead."
msgstr "مانند :c:func:`PySys_WriteStdout` است، اما به جای آن به :data:`sys.stderr` یا *stderr* می‌نویسد."

msgid "Function similar to PySys_WriteStdout() but format the message using :c:func:`PyUnicode_FromFormatV` and don't truncate the message to an arbitrary length."
msgstr "تابعی مشابه PySys_WriteStdout() است، اما پیام را با استفاده از :c:func:`PyUnicode_FromFormatV` قالب‌بندی می‌کند و پیام را به طولی دلخواه کوتاه نمی‌کند."

msgid "As :c:func:`PySys_FormatStdout`, but write to :data:`sys.stderr` or *stderr* instead."
msgstr "مانند :c:func:`PySys_FormatStdout`، اما به‌جای آن به :data:`sys.stderr` یا *stderr* می‌نویسد."

msgid "Return the current dictionary of :option:`-X` options, similarly to :data:`sys._xoptions`.  On error, ``NULL`` is returned and an exception is set."
msgstr "دیکشنری فعلی گزینه‌های :option:`-X` را برمی‌گرداند، مشابه :data:`sys._xoptions`.  در صورت خطا، ``NULL`` برگردانده می‌شود و یک استثنا تنظیم می‌شود."

msgid "Raise an auditing event with any active hooks. Return zero for success and non-zero with an exception set on failure."
msgstr "یک رویداد حسابرسی را همراه با هر قلاب فعال برپ می‌کند. در صورت موفقیت صفر و در صورت شکست مقدار غیرصفر به همراه استثنای تنظیم‌شده برمی‌گرداند."

msgid "The *event* string argument must not be *NULL*."
msgstr "آرگومان رشته‌ای *event* نباید *NULL* باشد."

msgid "If any hooks have been added, *format* and other arguments will be used to construct a tuple to pass. Apart from ``N``, the same format characters as used in :c:func:`Py_BuildValue` are available. If the built value is not a tuple, it will be added into a single-element tuple."
msgstr "اگر قلابی افزوده شده باشد، از *format* و سایر آرگومان‌ها برای ساخت تاپلی که پاس داده شود استفاده خواهد شد. به جز ``N``، همان نویسه‌های قالب که در :c:func:`Py_BuildValue` استفاده می‌شوند، در دسترس هستند. اگر مقدار ساخته‌شده یک تاپل نباشد، به یک تاپل تک‌عنصری افزوده خواهد شد."

msgid "The ``N`` format option must not be used. It consumes a reference, but since there is no way to know whether arguments to this function will be consumed, using it may cause reference leaks."
msgstr "از گزینه‌ی قالب ``N`` نباید استفاده شود. این گزینه یک ارجاع را مصرف می‌کند، اما از آنجا که هیچ راهی برای دانستن اینکه آیا آرگومان‌های این تابع مصرف خواهند شد یا خیر وجود ندارد، استفاده از آن ممکن است باعث نشت ارجاع شود."

msgid "Note that ``#`` format characters should always be treated as :c:type:`Py_ssize_t`, regardless of whether ``PY_SSIZE_T_CLEAN`` was defined."
msgstr "توجه داشته باشید که نویسه‌های قالب ``#`` همیشه باید به‌عنوان :c:type:`Py_ssize_t` در نظر گرفته شوند، صرف‌نظر از اینکه ``PY_SSIZE_T_CLEAN`` تعریف‌شده باشد یا خیر."

msgid ":func:`sys.audit` performs the same function from Python code."
msgstr ":func:`sys.audit` همین کار را از درون کد پایتون انجام می‌دهد."

msgid "See also :c:func:`PySys_AuditTuple`."
msgstr "همچنین :c:func:`PySys_AuditTuple` را ببینید."

msgid "Require :c:type:`Py_ssize_t` for ``#`` format characters. Previously, an unavoidable deprecation warning was raised."
msgstr "نویسه‌های قالب ``#`` به :c:type:`Py_ssize_t` نیاز دارند. پیش‌تر، یک هشدار منسوخ‌شدگی اجتناب‌ناپذیر اکسپورت می‌شد."

msgid "Similar to :c:func:`PySys_Audit`, but pass arguments as a Python object. *args* must be a :class:`tuple`. To pass no arguments, *args* can be *NULL*."
msgstr "مشابه :c:func:`PySys_Audit` است، اما آرگومان‌ها را به‌صورت یک شیء پایتون می‌گذرد. *args* باید یک :class:`tuple` باشد. برای عدم گذراندن آرگومان، *args* می‌تواند *NULL* باشد."

msgid "Append the callable *hook* to the list of active auditing hooks. Return zero on success and non-zero on failure. If the runtime has been initialized, also set an error on failure. Hooks added through this API are called for all interpreters created by the runtime."
msgstr "فراخوانی‌پذیر *hook* را به فهرست قلاب‌های حسابرسی فعال الحاق می‌کند. در صورت موفقیت صفر و در صورت شکست مقدار غیرصفر برمی‌گرداند. اگر ران‌تایم مقداردهی اولیه شده باشد، در صورت شکست خطایی نیز تنظیم می‌کند. قلاب‌هایی که از طریق این API افزوده می‌شوند، برای تمام مفسرهای ایجادشده توسط ران‌تایم فراخوانی می‌شوند."

msgid "The *userData* pointer is passed into the hook function. Since hook functions may be called from different runtimes, this pointer should not refer directly to Python state."
msgstr "اشاره‌گر *userData* به تابع قلاب پاس داده می‌شود. از آنجا که توابع قلاب ممکن است از ران‌تایم‌های مختلف فراخوانی شوند، این اشاره‌گر نباید مستقیماً به وضعیت پایتون اشاره کند."

msgid "This function is safe to call before :c:func:`Py_Initialize`. When called after runtime initialization, existing audit hooks are notified and may silently abort the operation by raising an error subclassed from :class:`Exception` (other errors will not be silenced)."
msgstr "فراخوانی این تابع پیش از :c:func:`Py_Initialize` ایمن است. هنگامی که پس از مقداردهی اولیه ران‌تایم فراخوانی شود، قلاب‌های حسابرسی موجود مطلع می‌شوند و ممکن است عملیات را با ایجاد خطایی که زیرکلاسی از :class:`Exception` است، به‌صورت بی‌صدا لغو کنند (خطاهای دیگر سرکوب نخواهند شد)."

msgid "The hook function is always called with an :term:`attached thread state` by the Python interpreter that raised the event."
msgstr "تابع قلاب همیشه با یک :term:`وضعیت نخ پیوست‌شده <attached thread state>` توسط مفسر پایتونی که رویداد را ایجاد کرده است، فراخوانی می‌شود."

msgid "See :pep:`578` for a detailed description of auditing.  Functions in the runtime and standard library that raise events are listed in the :ref:`audit events table <audit-events>`. Details are in each function's documentation."
msgstr "برای شرح مفصل حسابرسی به :pep:`578` مراجعه کنید. توابعی در ران‌تایم و کتابخانه استاندارد که رویداد ایجاد می‌کنند در :ref:`جدول رویدادهای حسابرسی <audit-events>` فهرست شده‌اند. جزئیات در مستندات هر تابع آمده است."

msgid "If the interpreter is initialized, this function raises an auditing event ``sys.addaudithook`` with no arguments. If any existing hooks raise an exception derived from :class:`Exception`, the new hook will not be added and the exception is cleared. As a result, callers cannot assume that their hook has been added unless they control all existing hooks."
msgstr "اگر مفسر راه‌اندازی‌شده باشد، این تابع رویداد حسابرسی ``sys.addaudithook`` را بدون هیچ آرگومانی ایجاد می‌کند. اگر هر یک از قلاب‌های موجود استثنایی مشتق‌شده از :class:`Exception` ایجاد کند، قلاب جدید اضافه نخواهد شد و استثنا پاک می‌شود. در نتیجه، فراخوانندگان نمی‌توانند فرض کنند که قلاب‌شان اضافه شده است، مگر آنکه کنترل تمام قلاب‌های موجود را در دست داشته باشند."

msgid "The type of the hook function. *event* is the C string event argument passed to :c:func:`PySys_Audit` or :c:func:`PySys_AuditTuple`. *args* is guaranteed to be a :c:type:`PyTupleObject`. *userData* is the argument passed to PySys_AddAuditHook()."
msgstr "نوع تابع قلاب. *event* آرگومان رویداد از نوع رشته‌ی C است که به :c:func:`PySys_Audit` یا :c:func:`PySys_AuditTuple` ارسال می‌شود. تضمین می‌شود که *args* یک :c:type:`PyTupleObject` باشد. *userData* آرگومانی است که به PySys_AddAuditHook() ارسال می‌شود."

msgid "Process Control"
msgstr "کنترل فرایند"

msgid "Print a fatal error message and kill the process.  No cleanup is performed. This function should only be invoked when a condition is detected that would make it dangerous to continue using the Python interpreter; e.g., when the object administration appears to be corrupted.  On Unix, the standard C library function :c:func:`!abort` is called which will attempt to produce a :file:`core` file."
msgstr "یک پیام خطای مهلک چاپ می‌کند و فرایند را می‌کشد. هیچ پاک‌سازی انجام نمی‌شود. این تابع تنها زمانی باید فراخوانی شود که شرایطی تشخیص داده شود که ادامه استفاده از مفسر پایتون را خطرناک سازد؛ برای مثال، زمانی که به نظر می‌رسد مدیریت شیء دچار خرابی شده باشد. در یونیکس، تابع :c:func:`!abort` از کتابخانه استاندارد C فراخوانی می‌شود که سعی خواهد کرد یک پرونده :file:`core` تولید کند."

msgid "The ``Py_FatalError()`` function is replaced with a macro which logs automatically the name of the current function, unless the ``Py_LIMITED_API`` macro is defined."
msgstr "تابع ``Py_FatalError()`` با ماکرویی جایگزین می‌شود که نام تابع فعلی را به‌طور خودکار ثبت می‌کند، مگر آنکه ماکروی ``Py_LIMITED_API`` تعریف شده باشد."

msgid "Log the function name automatically."
msgstr "نام تابع را به‌طور خودکار ثبت می‌کند."

msgid "Exit the current process.  This calls :c:func:`Py_FinalizeEx` and then calls the standard C library function ``exit(status)``.  If :c:func:`Py_FinalizeEx` indicates an error, the exit status is set to 120."
msgstr "از فرایند فعلی خارج می‌شود. این تابع :c:func:`Py_FinalizeEx` را فراخوانی می‌کند و سپس تابع ``exit(status)`` کتابخانه‌ی استاندارد C را فراخوانی می‌کند. اگر :c:func:`Py_FinalizeEx` خطا را نشان دهد، وضعیت خروج به ۱۲۰ تنظیم می‌شود."

msgid "Errors from finalization no longer ignored."
msgstr "خطاهای ناشی از نهایی‌سازی دیگر نادیده گرفته نمی‌شوند."

msgid "Register a cleanup function to be called by :c:func:`Py_FinalizeEx`.  The cleanup function will be called with no arguments and should return no value.  At most 32 cleanup functions can be registered.  When the registration is successful, :c:func:`Py_AtExit` returns ``0``; on failure, it returns ``-1``.  The cleanup function registered last is called first. Each cleanup function will be called at most once.  Since Python's internal finalization will have completed before the cleanup function, no Python APIs should be called by *func*."
msgstr "یک تابع پاک‌سازی ثبت کنید تا توسط :c:func:`Py_FinalizeEx` فراخوانی شود. تابع پاک‌سازی بدون هیچ آرگومانی فراخوانی می‌شود و نباید مقداری برگرداند. حداکثر ۳۲ تابع پاک‌سازی را می‌توان ثبت کرد. وقتی ثبت با موفقیت انجام شود، :c:func:`Py_AtExit` مقدار ``0`` را برمی‌گرداند؛ در صورت شکست، مقدار ``-1`` را برمی‌گرداند. آخرین تابع پاک‌سازی ثبت‌شده، نخست فراخوانی می‌شود. هر تابع پاک‌سازی حداکثر یک‌بار فراخوانی خواهد شد. از آنجا که نهایی‌سازی داخلی پایتون پیش از تابع پاک‌سازی کامل شده خواهد بود، *func* نباید هیچ‌یک از APIهای پایتون را فراخوانی کند."

msgid ":c:func:`PyUnstable_AtExit` for passing a ``void *data`` argument."
msgstr ":c:func:`PyUnstable_AtExit` برای گذراندن آرگومان ``void *data``."

msgid "USE_STACKCHECK (C macro)"
msgstr "USE_STACKCHECK (ماکروی C)"

msgid "abort (C function)"
msgstr "abort (تابع C)"

msgid "Py_FinalizeEx (C function)"
msgstr "Py_FinalizeEx (تابع C)"

msgid "exit (C function)"
msgstr "exit (تابع C)"

msgid "cleanup functions"
msgstr "توابع پاک‌سازی"

#~ msgid "Return the object *name* from the :mod:`sys` module or ``NULL`` if it does not exist, without setting an exception."
#~ msgstr "شیء *name* را از ماژول :mod:`sys` بازمی‌گرداند، یا اگر وجود نداشته باشد ``NULL`` را برمی‌گرداند، بدون تنظیم استثنا."

#~ msgid "Reset :data:`sys.warnoptions` to an empty list. This function may be called prior to :c:func:`Py_Initialize`."
#~ msgstr "بازنشانی :data:`sys.warnoptions` به یک فهرست خالی. این تابع می‌تواند پیش از :c:func:`Py_Initialize` فراخوانی شود."

#~ msgid "Clear :data:`sys.warnoptions` and :data:`!warnings.filters` instead."
#~ msgstr "به جای آن، :data:`sys.warnoptions` و :data:`!warnings.filters` را پاک کنید."