file.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:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2021-06-28 00:48+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 "File objects"
msgstr "اشیاء پرونده"

msgid "These APIs are a minimal emulation of the Python 2 C API for built-in file objects, which used to rely on the buffered I/O (:c:expr:`FILE*`) support from the C standard library.  In Python 3, files and streams use the new :mod:`io` module, which defines several layers over the low-level unbuffered I/O of the operating system.  The functions described below are convenience C wrappers over these new APIs, and meant mostly for internal error reporting in the interpreter; third-party code is advised to access the :mod:`io` APIs instead."
msgstr "این API‌ها شبیه‌سازی حداقلی از C API پایتون 2 برای اشیای پرونده توکار هستند، که پیش‌تر به پشتیبانی ورودی/خروجی بافرشده (:c:expr:`FILE*`) از کتابخانه استاندارد C تکیه داشت. در پایتون 3، پرونده‌ها و جریان‌ها از ماژول جدید :mod:`io` استفاده می‌کنند که چندین لایه را روی ورودی/خروجی سطح پایین و بدون بافر سیستم‌عامل تعریف می‌کند. توابعی که در ادامه توضیح داده شده‌اند، پوشش‌های C راحتی روی این API‌های جدید هستند و عمدتاً برای گزارش خطای داخلی در مفسر در نظر گرفته شده‌اند؛ به کد شخص ثالث توصیه می‌شود که به جای آن‌ها به API‌های :mod:`io` دسترسی داشته باشد."

msgid "Create a Python file object from the file descriptor of an already opened file *fd*.  The arguments *name*, *encoding*, *errors* and *newline* can be ``NULL`` to use the defaults; *buffering* can be *-1* to use the default. *name* is ignored and kept for backward compatibility. Return ``NULL`` on failure. For a more comprehensive description of the arguments, please refer to the :func:`io.open` function documentation."
msgstr "یک شیء پرونده‌ی پایتون از توصیف‌گر پرونده‌ی از پیش باز‌شده‌ی *fd* ایجاد می‌کند.  آرگومان‌های *name*، *encoding*، *errors* و *newline* می‌توانند ``NULL`` باشند تا از مقادیر پیش‌فرض استفاده شود؛ *buffering* می‌تواند *-1* باشد تا از مقدار پیش‌فرض استفاده شود. *name* نادیده گرفته می‌شود و برای سازگاری با نسخه‌های قبلی نگه داشته شده است. در صورت شکست، ``NULL`` برگردانده می‌شود. برای توضیحات جامع‌تر درباره‌ی آرگومان‌ها، لطفاً به مستندات تابع :func:`io.open` مراجعه کنید."

msgid "Since Python streams have their own buffering layer, mixing them with OS-level file descriptors can produce various issues (such as unexpected ordering of data)."
msgstr "از آنجا که جریان‌های پایتون لایه بافرینگ اختصاصی خود را دارند، ترکیب آن‌ها با توصیف‌گرهای پرونده در سطح سیستم‌عامل می‌تواند مشکلات گوناگونی (مانند ترتیب غیرمنتظره داده‌ها) ایجاد کند."

msgid "Ignore *name* attribute."
msgstr "ویژگی *name* را نادیده بگیرید."

msgid "Return the file descriptor associated with *p* as an :c:expr:`int`.  If the object is an integer, its value is returned.  If not, the object's :meth:`~io.IOBase.fileno` method is called if it exists; the method must return an integer, which is returned as the file descriptor value.  Sets an exception and returns ``-1`` on failure."
msgstr "توصیف‌گر پرونده مرتبط با *p* را به‌صورت :c:expr:`int` برمی‌گرداند. اگر شیء یک عدد صحیح باشد، مقدار آن برگردانده می‌شود. در غیر این صورت، متد :meth:`~io.IOBase.fileno` شیء در صورت وجود فراخوانی می‌شود؛ این متد باید یک عدد صحیح برگرداند که به‌عنوان مقدار توصیف‌گر پرونده برگردانده می‌شود. در صورت شکست، یک استثنا تنظیم می‌کند و ``-1`` برمی‌گرداند."

msgid "Equivalent to ``p.readline([n])``, this function reads one line from the object *p*.  *p* may be a file object or any object with a :meth:`~io.IOBase.readline` method.  If *n* is ``0``, exactly one line is read, regardless of the length of the line.  If *n* is greater than ``0``, no more than *n* bytes will be read from the file; a partial line can be returned.  In both cases, an empty string is returned if the end of the file is reached immediately.  If *n* is less than ``0``, however, one line is read regardless of length, but :exc:`EOFError` is raised if the end of the file is reached immediately."
msgstr "این تابع معادل ``p.readline([n])`` است و یک سطر از شیء *p* می‌خواند. *p* می‌تواند یک شیء پرونده یا هر شیء دارای متد :meth:`~io.IOBase.readline` باشد. اگر *n* برابر ``0`` باشد، دقیقاً یک سطر خوانده می‌شود، بدون توجه به طول سطر. اگر *n* بزرگ‌تر از ``0`` باشد، بیش از *n* بایت از پرونده خوانده نمی‌شود؛ ممکن است سطر ناقصی برگردانده شود. در هر دو حالت، اگر بلافاصله به پایان پرونده برسیم، رشته‌ای خالی برگردانده می‌شود. اما اگر *n* کوچک‌تر از ``0`` باشد، یک سطر بدون توجه به طول خوانده می‌شود، ولی اگر بلافاصله به پایان پرونده برسیم، :exc:`EOFError` پرتاب می‌شود."

msgid "Overrides the normal behavior of :func:`io.open_code` to pass its parameter through the provided handler."
msgstr "رفتار عادی :func:`io.open_code` را بازتعریف می‌کند تا پارامتر خود را از هندلر ارائه‌شده عبور دهد."

msgid "The *handler* is a function of type:"
msgstr "*هندلر* تابعی از نوع زیر است:"

msgid "Equivalent of :c:expr:`PyObject *(\\*)(PyObject *path, void *userData)`, where *path* is guaranteed to be :c:type:`PyUnicodeObject`."
msgstr "معادل :c:expr:`PyObject *(\\*)(PyObject *path, void *userData)` است که در آن تضمین می‌شود *path* از نوع :c:type:`PyUnicodeObject` باشد."

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 "As this hook is intentionally used during import, avoid importing new modules during its execution unless they are known to be frozen or available in ``sys.modules``."
msgstr "از آنجا که این قلاب عمداً در زمان ایمپورت استفاده می‌شود، از ایمپورت کردن ماژول‌های جدید در حین اجرای آن خودداری کنید، مگر آنکه مشخص باشد که فریزشده  هستند یا در ``sys.modules`` موجود هستند."

msgid "Once a hook has been set, it cannot be removed or replaced, and later calls to :c:func:`PyFile_SetOpenCodeHook` will fail. On failure, the function returns -1 and sets an exception if the interpreter has been initialized."
msgstr "پس از آنکه یک قلاب تنظیم شده باشد، نمی‌توان آن را حذف یا جایگزین کرد و فراخوانی‌های بعدی :c:func:`PyFile_SetOpenCodeHook` شکست خواهند خورد. در صورت شکست، تابع مقدار -1 را برمی‌گرداند و اگر مفسر مقداردهی اولیه شده باشد، یک استثنا تنظیم می‌کند."

msgid "This function is safe to call before :c:func:`Py_Initialize`."
msgstr "فراخوانی این تابع پیش از :c:func:`Py_Initialize` ایمن است."

msgid "Raises an :ref:`auditing event <auditing>` ``setopencodehook`` with no arguments."
msgstr ":ref:`رویداد حسابرسی <auditing>` ``setopencodehook`` را بدون هیچ آرگومانی ایجاد می‌کند."

msgid "Open *path* with the mode ``'rb'``. *path* must be a Python :class:`str` object. The behavior of this function may be overridden by :c:func:`PyFile_SetOpenCodeHook` to allow for some preprocessing of the text."
msgstr "*path* را با حالت ``'rb'`` باز می‌کند. *path* باید یک شیء :class:`str` پایتون باشد. رفتار این تابع ممکن است توسط :c:func:`PyFile_SetOpenCodeHook` بازنویسی شود تا امکان انجام پیش‌پردازش‌هایی روی متن فراهم شود."

msgid "This is analogous to :func:`io.open_code` in Python."
msgstr "این مشابه :func:`io.open_code` در پایتون است."

msgid "On success, this function returns a :term:`strong reference` to a Python file object. On failure, this function returns ``NULL`` with an exception set."
msgstr "در صورت موفقیت، این تابع یک :term:`strong reference` به یک شیء پرونده‌ی پایتون برمی‌گرداند. در صورت شکست، این تابع ``NULL`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند."

msgid "Similar to :c:func:`PyFile_OpenCodeObject`, but *path* is a UTF-8 encoded :c:expr:`const char*`."
msgstr "مشابه :c:func:`PyFile_OpenCodeObject`، اما *path* یک :c:expr:`const char*` کدگذاری‌شده با UTF-8 است."

msgid "Write object *obj* to file object *p*.  The only supported flag for *flags* is :c:macro:`Py_PRINT_RAW`; if given, the :func:`str` of the object is written instead of the :func:`repr`."
msgstr "شیء *obj* را در شیء پرونده *p* می‌نویسد. تنها پرچم پشتیبانی‌شده برای *flags*، :c:macro:`Py_PRINT_RAW` است؛ در صورت ارائه، :func:`str` شیء به‌جای :func:`repr` آن نوشته می‌شود."

msgid "If *obj* is ``NULL``, write the string ``\"<NULL>\"``."
msgstr "اگر *obj* برابر ``NULL`` باشد، رشته‌ی ``\"<NULL>\"`` نوشته می‌شود."

msgid "Return ``0`` on success or ``-1`` on failure; the appropriate exception will be set."
msgstr "در صورت موفقیت ``0`` و در صورت شکست ``-1`` را برمی‌گرداند؛ استثنای مناسب تنظیم خواهد شد."

msgid "Write string *s* to file object *p*.  Return ``0`` on success or ``-1`` on failure; the appropriate exception will be set."
msgstr "رشته *s* را در شیء پرونده *p* می‌نویسد. در صورت موفقیت ``0`` و در صورت شکست ``-1`` برمی‌گرداند؛ استثنای مناسب تنظیم خواهد شد."

msgid "Soft-deprecated API"
msgstr "API نیمه‌منسوخ (soft-deprecated)"

msgid "These are APIs that were included in Python's C API by mistake. They are documented solely for completeness; use other ``PyFile*`` APIs instead."
msgstr "این‌ها API‌هایی هستند که به اشتباه در C API پایتون گنجانده شده‌اند. آن‌ها صرفاً برای کامل بودن مستند شده‌اند؛ به جای آن‌ها از سایر API‌های ``PyFile*`` استفاده کنید."

msgid "Use :c:func:`PyFile_FromFd` with defaults (``fd, NULL, \"w\", -1, NULL, NULL, NULL, 0``) instead."
msgstr "به جای آن، از :c:func:`PyFile_FromFd` با مقادیر پیش‌فرض (``fd, NULL, \"w\", -1, NULL, NULL, NULL, 0``) استفاده کنید."

msgid "Type of file-like objects used internally at Python startup when :py:mod:`io` is not yet available. Use Python :py:func:`open` or :c:func:`PyFile_FromFd` to create file objects instead."
msgstr "نوع اشیای شبه‌پرونده‌ای که در زمان راه‌اندازی پایتون، هنگامی که :py:mod:`io` هنوز در دسترس نیست، به‌طور داخلی استفاده می‌شوند. به‌جای آن، برای ایجاد اشیای پرونده از :py:func:`open` پایتون یا :c:func:`PyFile_FromFd` استفاده کنید."

msgid "object"
msgstr "شیء"

msgid "file"
msgstr "پرونده"

msgid "EOFError (built-in exception)"
msgstr "EOFError (استثنای توکار)"

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