"Project-Id-Version: Python 3.14\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-09-21 11:59+0000\n"

"PO-Revision-Date: 2026-08-26 08:03+0330\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"

"X-Generator: Poedit 3.6\n"

msgid "Glossary"

msgstr "واژه‌نامه"

msgid "``>>>``"

msgstr "``>>>``"

msgid "The default Python prompt of the :term:`interactive` shell. Often seen for code examples which can be executed interactively in the interpreter."

msgstr "اعلان پیش‌فرض پایتون در پوسته‌ی :term:`تعاملی <interactive>`. اغلب برای نمونه‌های کدی دیده می‌شود که می‌توان آن‌ها را به‌صورت تعاملی در مفسر اجرا کرد."

msgid "``...``"

msgstr "``...``"

msgid "Can refer to:"

msgstr "می‌تواند به موارد زیر اشاره کند:"

msgid "The default Python prompt of the :term:`interactive` shell when entering the code for an indented code block, when within a pair of matching left and right delimiters (parentheses, square brackets, curly braces or triple quotes), or after specifying a decorator."

msgstr "اعلان پیش‌فرض پایتون در پوسته‌ی :term:`تعاملی <interactive>` هنگام وارد کردن کد برای یک بلوک کد تورفته، زمانی که درون یک جفت جداکننده‌ی چپ و راست متناظر (پرانتزها، کروشه‌ها، آکولادها یا علامت‌های نقل‌قول سه‌گانه) قرار دارید، یا پس از مشخص کردن یک دکوراتور."

msgid "The three dots form of the :ref:`Ellipsis <bltin-ellipsis-object>` object."

msgstr "شکل سه‌نقطه‌ای شیء :ref:`Ellipsis <bltin-ellipsis-object>`."

msgid "abstract base class"

msgstr "کلاس پایه‌ی انتزاعی"

msgid "Abstract base classes complement :term:`duck-typing` by providing a way to define interfaces when other techniques like :func:`hasattr` would be clumsy or subtly wrong (for example with :ref:`magic methods <special-lookup>`). ABCs introduce virtual subclasses, which are classes that don't inherit from a class but are still recognized by :func:`isinstance` and :func:`issubclass`; see the :mod:`abc` module documentation. Python comes with many built-in ABCs for data structures (in the :mod:`collections.abc` module), numbers (in the :mod:`numbers` module), streams (in the :mod:`io` module), import finders and loaders (in the :mod:`importlib.abc` module). You can create your own ABCs with the :mod:`abc` module."

msgstr "کلاس‌های پایه‌ی انتزاعی با فراهم کردن روشی برای تعریف رابط‌ها، زمانی که تکنیک‌های دیگری مانند :func:`hasattr` دست‌وپاگیر یا به‌طور ضمنی نادرست هستند (برای مثال با :ref:`متدهای جادویی <special-lookup>`)، :term:`نوع‌دهی اردکی <duck-typing>` را تکمیل می‌کنند. ABCها زیرکلاس‌های مجازی معرفی می‌کنند، که کلاس‌هایی هستند که از یک کلاس دیگر به ارث نمی‌برند اما همچنان توسط :func:`isinstance` و :func:`issubclass` شناخته می‌شوند؛ مستندات ماژول :mod:`abc` را ببینید. پایتون همراه با ABCهای توکار بسیاری برای ساختارهای داده (در ماژول :mod:`collections.abc`)، اعداد (در ماژول :mod:`numbers`)، جریان‌ها (در ماژول :mod:`io`)، یابنده‌ها و بارگذارهای ایمپورت (در ماژول :mod:`importlib.abc`) ارائه می‌شود. شما می‌توانید ABCهای سفارشی خود را با ماژول :mod:`abc` ایجاد کنید."

msgid "annotate function"

msgstr "توابع حاشیه‌گذاری"

msgid "A callable that can be called to retrieve the :term:`annotations <annotation>` of an object. Annotate functions are usually :term:`functions <function>`, automatically generated as the :attr:`~object.__annotate__` attribute of functions, classes, and modules. Annotate functions are a subset of :term:`evaluate functions <evaluate function>`."

msgstr "فراخوانی‌پذیری که می‌توان آن را برای بازیابی :term:`حاشیه‌گذاری <annotation>` یک شیء فراخوانی کرد. توابع حاشیه‌گذاری معمولاً :term:`توابعی <function>` هستند که به‌صورت خودکار به‌عنوان ویژگی :attr:`~object.__annotate__` توابع، کلاس‌ها و ماژول‌ها تولید می‌شوند. توابع حاشیه‌گذاری زیرمجموعه‌ای از :term:`توابع ارزیابی <evaluate function>` هستند."

msgid "annotation"

msgstr "حاشیه‌گذاری"

msgid "A label associated with a variable, a class attribute or a function parameter or return value, used by convention as a :term:`type hint`."

msgstr "برچسبی مرتبط با یک متغیر، یک ویژگی کلاس، یا یک پارامتر تابع یا مقدار بازگشتی، که طبق قرارداد به‌عنوان یک :term:`راهنمای نوع <type hint>` استفاده می‌شود."

msgid "Annotations of local variables cannot be accessed at runtime, but annotations of global variables, class attributes, and functions can be retrieved by calling :func:`annotationlib.get_annotations` on modules, classes, and functions, respectively."

msgstr "حاشیه‌گذاری‌های متغیرهای محلی را نمی‌توان در زمان ران‌تایم دسترسی کرد، اما حاشیه‌گذاری‌های متغیرهای سراسری، ویژگی‌های کلاس و توابع را می‌توان با فراخوانی :func:`annotationlib.get_annotations` به‌ترتیب روی ماژول‌ها، کلاس‌ها و توابع بازیابی کرد."

msgid "See :term:`variable annotation`, :term:`function annotation`, :pep:`484`, :pep:`526`, and :pep:`649`, which describe this functionality. Also see :ref:`annotations-howto` for best practices on working with annotations."

msgstr "همچنین به :term:`حاشیه‌نویسی متغیر <variable annotation>`، :term:`حاشیه‌گذاری تابع <function annotation>`، :pep:`484`، :pep:`526` و :pep:`649` مراجعه کنید که این قابلیت را توضیح می‌دهند. همچنین برای بهترین روش‌ها در کار با حاشیه‌گذاری‌ها، :ref:`annotations-howto` را ببینید."

msgid "argument"

msgstr "آرگومان"

msgid "A value passed to a :term:`function` (or :term:`method`) when calling the function. There are two kinds of argument:"

msgstr "مقداری که هنگام فراخوانی یک :term:`تابع <function>` (یا :term:`متد <method>`) به آن تابع ارسال می‌شود. دو نوع آرگومان وجود دارد:"

msgid ":dfn:`keyword argument`: an argument preceded by an identifier (e.g. ``name=``) in a function call or passed as a value in a dictionary preceded by ``**``. For example, ``3`` and ``5`` are both keyword arguments in the following calls to :func:`complex`::"

msgstr ":dfn:`keyword argument`: آرگومانی که در فراخوانی تابع با یک شناسه (برای مثال ``name=``) پیش از آن قرار گرفته است، یا به‌عنوان مقداری در یک دیکشنری که پیش از آن ``**`` آمده است، ارسال می‌شود. برای مثال، ``3`` و ``5`` هر دو در فراخوانی‌های زیر از :func:`complex` آرگومان کلیدواژه‌ای هستند::"

msgid ""

msgstr ""

msgid ":dfn:`positional argument`: an argument that is not a keyword argument. Positional arguments can appear at the beginning of an argument list and/or be passed as elements of an :term:`iterable` preceded by ``*``. For example, ``3`` and ``5`` are both positional arguments in the following calls::"

msgstr ":dfn:`positional argument`: آرگومانی که آرگومان کلیدواژه‌ای نیست. آرگومان‌های جایگاهی می‌توانند در ابتدای یک فهرست آرگومان ظاهر شوند و/یا به‌عنوان عناصر یک :term:`پیمایش‌پذیر <iterable>` که پیش از آن ``*`` آمده است، ارسال شوند. برای مثال، ``3`` و ``5`` هر دو در فراخوانی‌های زیر آرگومان جایگاهی هستند::"

msgid ""

msgstr ""

msgid "Arguments are assigned to the named local variables in a function body. See the :ref:`calls` section for the rules governing this assignment. Syntactically, any expression can be used to represent an argument; the evaluated value is assigned to the local variable."

msgstr "آرگومان‌ها به متغیرهای محلی نام‌گذاری‌شده در بدنه‌ی یک تابع اختصاص داده می‌شوند. برای قوانین حاکم بر این تخصیص، بخش :ref:`calls` را ببینید. از نظر سینتکس، هر عبارتی می‌تواند برای نمایش یک آرگومان استفاده شود؛ مقدار ارزیابی‌شده به متغیر محلی اختصاص داده می‌شود."

msgid "See also the :term:`parameter` glossary entry, the FAQ question on :ref:`the difference between arguments and parameters <faq-argument-vs-parameter>`, and :pep:`362`."

msgstr "همچنین به ورودی واژه‌نامه‌ای :term:`پارامتر <parameter>`، پرسش متداول درباره‌ی :ref:`تفاوت بین آرگومان‌ها و پارامترها <faq-argument-vs-parameter>` و :pep:`362` مراجعه کنید."

msgid "asynchronous context manager"

msgstr "مدیر زمینه‌ی ناهمگام"

msgid "An object which controls the environment seen in an :keyword:`async with` statement by defining :meth:`~object.__aenter__` and :meth:`~object.__aexit__` methods. Introduced by :pep:`492`."

msgstr "شی‌ءای که با تعریف متدهای :meth:`~object.__aenter__` و :meth:`~object.__aexit__`، محیط مشاهده‌شده در یک دستور :keyword:`async with` را کنترل می‌کند. این قابلیت توسط :pep:`492` معرفی شد."

msgid "asynchronous generator"

msgstr "تولیدگر ناهمگام"

msgid "Informally used to mean either an :term:`asynchronous generator function` or an :term:`asynchronous generator iterator`, depending on context. The formal terms :term:`asynchronous generator function` and :term:`asynchronous generator iterator` are uncommon in practice; \"asynchronous generator\" alone is almost always sufficient."

msgstr "به‌صورت غیررسمی برای اشاره به یک :term:`تابع تولیدگر ناهمگام <asynchronous generator function>` یا یک :term:`پیمایش‌گر تولیدگر ناهمگام <asynchronous generator iterator>`، بسته به زمینه، استفاده می‌شود. اصطلاحات رسمی :term:`تابع تولیدگر ناهمگام <asynchronous generator function>` و :term:`پیمایش‌گر تولیدگر ناهمگام <asynchronous generator iterator>` در عمل کمتر استفاده می‌شوند؛ «تولیدگر ناهمگام» به‌تنهایی تقریباً همیشه کافی است."

msgid "asynchronous generator function"

msgstr "تابع تولیدگر ناهمگام"

msgid "A function which returns an :term:`asynchronous generator iterator`. It looks like a coroutine function defined with :keyword:`async def` except that it contains :keyword:`yield` expressions for producing a series of values usable in an :keyword:`async for` loop. See :pep:`525`."

msgstr "تابعی که یک :term:`پیمایش‌گر تولیدگر ناهمگام <asynchronous generator iterator>` بازمی‌گرداند. این تابع شبیه یک تابع هم‌روال که با :keyword:`async def` تعریف شده است به نظر می‌رسد، با این تفاوت که شامل عبارت‌های :keyword:`yield` برای تولید مجموعه‌ای از مقادیر قابل استفاده در یک حلقه‌ی :keyword:`async for` است. :pep:`525` را ببینید."

msgid "An asynchronous generator function may contain :keyword:`await` expressions as well as :keyword:`async for`, and :keyword:`async with` statements."

msgstr "یک تابع تولیدگر ناهمگام ممکن است علاوه بر عبارت‌های :keyword:`async for` و دستورهای :keyword:`async with`، شامل عبارت‌های :keyword:`await` نیز باشد."

msgid "asynchronous generator iterator"

msgstr "پیمایش‌گر تولیدگر ناهمگام"

msgid "An object created by an :term:`asynchronous generator function`."

msgstr "شی‌ءای که توسط یک :term:`تابع تولیدگر ناهمگام <asynchronous generator function>` ایجاد می‌شود."

msgid "This is an :term:`asynchronous iterator` which when called using the :meth:`~object.__anext__` method returns an awaitable object which will execute the body of the asynchronous generator function until the next :keyword:`yield` expression."

msgstr "این یک :term:`پیمایش‌گر ناهمگام <asynchronous iterator>` است که هنگام فراخوانی با استفاده از متد :meth:`~object.__anext__`، یک شیء awaitable بازمی‌گرداند که بدنه‌ی تابع تولیدگر ناهمگام را تا عبارت :keyword:`yield` بعدی اجرا خواهد کرد."

msgid "Each :keyword:`yield` temporarily suspends processing, remembering the execution state (including local variables and pending try-statements). When the *asynchronous generator iterator* effectively resumes with another awaitable returned by :meth:`~object.__anext__`, it picks up where it left off. See :pep:`492` and :pep:`525`."

msgstr "هر :keyword:`yield` پردازش را به‌طور موقت متوقف می‌کند و وضعیت اجرا (شامل متغیرهای محلی و دستورهای try در انتظار) را به خاطر می‌سپارد. هنگامی که *پیمایش‌گر تولیدگر ناهمگام* عملاً با یک شیء awaitable دیگر که توسط :meth:`~object.__anext__` بازگردانده شده است ادامه می‌یابد، از همان نقطه‌ای که متوقف شده بود ادامه می‌دهد. :pep:`492` و :pep:`525` را ببینید."

msgid "asynchronous iterable"

msgstr "پیمایش‌پذیر ناهمگام"

msgid "An object, that can be used in an :keyword:`async for` statement. Must return an :term:`asynchronous iterator` from its :meth:`~object.__aiter__` method. Introduced by :pep:`492`."

msgstr "شی‌ءای که می‌تواند در یک دستور :keyword:`async for` استفاده شود. باید از متد :meth:`~object.__aiter__` خود یک :term:`پیمایش‌گر ناهمگام <asynchronous iterator>` بازگرداند. این قابلیت توسط :pep:`492` معرفی شد."

msgid "asynchronous iterator"

msgstr "پیمایش‌گر ناهمگام"

msgid "An object that implements the :meth:`~object.__aiter__` and :meth:`~object.__anext__` methods. :meth:`~object.__anext__` must return an :term:`awaitable` object. :keyword:`async for` resolves the awaitables returned by an asynchronous iterator's :meth:`~object.__anext__` method until it raises a :exc:`StopAsyncIteration` exception. Introduced by :pep:`492`."

msgstr "شی‌ءای که متدهای :meth:`~object.__aiter__` و :meth:`~object.__anext__` را پیاده‌سازی می‌کند. :meth:`~object.__anext__` باید یک شیء :term:`awaitable <awaitable>` بازگرداند. :keyword:`async for` اشیای awaitable بازگردانده‌شده توسط متد :meth:`~object.__anext__` یک پیمایش‌گر ناهمگام را تا زمانی که یک استثنای :exc:`StopAsyncIteration` پرتاب شود، حل می‌کند. این قابلیت توسط :pep:`492` معرفی شد."

msgid "atomic operation"

msgstr "عملیات اتمی"

msgid "An operation that appears to execute as a single, indivisible step: no other thread can observe it half-done, and its effects become visible all at once. Python does not guarantee that high-level statements are atomic (for example, ``x += 1`` performs multiple bytecode operations and is not atomic). Atomicity is only guaranteed where explicitly documented. See also :term:`race condition` and :term:`data race`."

msgstr "عملیاتی که به نظر می‌رسد به‌عنوان یک گام واحد و تقسیم‌ناپذیر اجرا می‌شود: هیچ نخ دیگری نمی‌تواند اجرای ناقص آن را مشاهده کند و اثرات آن یکباره قابل مشاهده می‌شوند. پایتون تضمین نمی‌کند که دستورهای سطح بالا اتمی باشند (برای مثال، ``x += 1`` چندین عملیات بایت‌کد انجام می‌دهد و اتمی نیست). اتمی بودن فقط در مواردی تضمین می‌شود که به‌صراحت مستند شده باشند. همچنین :term:`شرط رقابت <race condition>` و :term:`رقابت داده <data race>` را ببینید."

msgid "attached thread state"

msgstr "وضعیت نخ متصل"

msgid "A :term:`thread state` that is active for the current OS thread."

msgstr "یک :term:`وضعیت نخ اجرایی <thread state>` که برای نخ فعلی سیستم‌عامل فعال است."

msgid "When a :term:`thread state` is attached, the OS thread has access to the full Python C API and can safely invoke the bytecode interpreter."

msgstr "هنگامی که یک :term:`وضعیت نخ اجرایی <thread state>` متصل است، نخ سیستم‌عامل به تمام API زبان C پایتون دسترسی دارد و می‌تواند به‌طور ایمن مفسر بایت‌کد را فراخوانی کند."

msgid "Unless a function explicitly notes otherwise, attempting to call the C API without an attached thread state will result in a fatal error or undefined behavior. A thread state can be attached and detached explicitly by the user through the C API, or implicitly by the runtime, including during blocking C calls and by the bytecode interpreter in between calls."

msgstr "مگر این‌که یک تابع به‌طور صریح خلاف آن را ذکر کند، تلاش برای فراخوانی API زبان C بدون یک وضعیت نخ متصل، به یک خطای مهلک یا رفتار تعریف‌نشده منجر خواهد شد. یک وضعیت نخ می‌تواند به‌صورت صریح توسط کاربر از طریق API زبان C متصل و جدا شود، یا به‌صورت ضمنی توسط ران‌تایم، از جمله در طول فراخوانی‌های C مسدودکننده و توسط مفسر بایت‌کد در بین فراخوانی‌ها، مدیریت شود."

msgid "On most builds of Python, having an attached thread state implies that the caller holds the :term:`GIL` for the current interpreter, so only one OS thread can have an attached thread state at a given moment. In :term:`free-threaded builds <free-threaded build>` of Python, threads can concurrently hold an attached thread state, allowing for true parallelism of the bytecode interpreter."

msgstr "در بیشتر ساخت‌های پایتون، داشتن یک وضعیت نخ متصل به این معناست که فراخواننده :term:`GIL <GIL>` را برای مفسر فعلی در اختیار دارد، بنابراین در یک لحظه‌ی مشخص فقط یک نخ سیستم‌عامل می‌تواند یک وضعیت نخ متصل داشته باشد. در :term:`ساخت نخ‌آزاد <free-threaded build>` پایتون، نخ‌ها می‌توانند به‌طور همزمان وضعیت نخ متصل داشته باشند، که امکان موازی‌سازی واقعی مفسر بایت‌کد را فراهم می‌کند."

msgid "attribute"

msgstr "ویژگی"

msgid "A value associated with an object which is usually referenced by name using dotted expressions. For example, if an object *o* has an attribute *a* it would be referenced as *o.a*."

msgstr "مقداری مرتبط با یک شیء که معمولاً با استفاده از عبارت‌های نقطه‌ای و با نام به آن ارجاع داده می‌شود. برای مثال، اگر یک شیء *o* دارای یک ویژگی *a* باشد، با *o.a* به آن ارجاع داده خواهد شد."

msgid "It is possible to give an object an attribute whose name is not an identifier as defined by :ref:`identifiers`, for example using :func:`setattr`, if the object allows it. Such an attribute will not be accessible using a dotted expression, and would instead need to be retrieved with :func:`getattr`."

msgstr "اگر شیء اجازه دهد، می‌توان با استفاده از :func:`setattr`، ویژگی‌ای با نامی که یک شناسه مطابق تعریف :ref:`identifiers` نیست به آن اختصاص داد. چنین ویژگی‌ای با استفاده از یک عبارت نقطه‌ای قابل دسترسی نخواهد بود و باید در عوض با :func:`getattr` بازیابی شود."

msgid "awaitable"

msgstr "awaitable"

msgid "An object that can be used in an :keyword:`await` expression. Can be a :term:`coroutine` or an object with an :meth:`~object.__await__` method. See also :pep:`492`."

msgstr "شیءای که می‌تواند در یک عبارت :keyword:`await` استفاده شود. می‌تواند یک :term:`هم‌روال <coroutine>` یا شی‌ءای با متد :meth:`~object.__await__` باشد. همچنین :pep:`492` را ببینید."

msgid "BDFL"

msgstr "BDFL"

msgid "Benevolent Dictator For Life, a.k.a. `Guido van Rossum <https://gvanrossum.github.io/>`_, Python's creator."

msgstr "Benevolent Dictator For Life،نام دیگر `Guido van Rossum <https://gvanrossum.github.io/>`_، خالق پایتون."

msgid "binary file"

msgstr "پرونده دودویی"

msgid "A :term:`file object` able to read and write :term:`bytes-like objects <bytes-like object>`. Examples of binary files are files opened in binary mode (``'rb'``, ``'wb'`` or ``'rb+'``), :data:`sys.stdin.buffer <sys.stdin>`, :data:`sys.stdout.buffer <sys.stdout>`, and instances of :class:`io.BytesIO` and :class:`gzip.GzipFile`."

msgstr "یک :term:`شیء پرونده <file object>` که می‌تواند :term:`شیء شبه‌بایت <bytes-like object>` را بخواند و بنویسد. نمونه‌هایی از پرونده‌های دودویی، پرونده‌هایی هستند که در حالت دودویی باز شده‌اند (``'rb'``، ``'wb'`` یا ``'rb+'``)، :data:`sys.stdin.buffer <sys.stdin>`، :data:`sys.stdout.buffer <sys.stdout>` و نمونه‌هایی از :class:`io.BytesIO` و :class:`gzip.GzipFile`."

msgid "See also :term:`text file` for a file object able to read and write :class:`str` objects."

msgstr "همچنین :term:`پرونده متنی <text file>` را برای یک شیء پرونده که می‌تواند اشیای :class:`str` را بخواند و بنویسد ببینید."

msgid "borrowed reference"

msgstr "ارجاع قرض‌گرفته‌شده"

msgid "In Python's C API, a borrowed reference is a reference to an object, where the code using the object does not own the reference. It becomes a dangling pointer if the object is destroyed. For example, a garbage collection can remove the last :term:`strong reference` to the object and so destroy it."

msgstr "در API زبان C پایتون، ارجاع قرض‌گرفته‌شده ارجاعی به یک شیء است که در آن کدی که از شیء استفاده می‌کند مالک ارجاع نیست. اگر شیء نابود شود، این ارجاع به یک اشاره‌گر آویزان تبدیل می‌شود. برای مثال، جمع‌آوری زباله می‌تواند آخرین :term:`ارجاع قوی <strong reference>` به شیء را حذف کند و در نتیجه آن را نابود کند."

msgid "Calling :c:func:`Py_INCREF` on the :term:`borrowed reference` is recommended to convert it to a :term:`strong reference` in-place, except when the object cannot be destroyed before the last usage of the borrowed reference. The :c:func:`Py_NewRef` function can be used to create a new :term:`strong reference`."

msgstr "فراخوانی :c:func:`Py_INCREF` روی :term:`ارجاع قرض‌گرفته‌شده <borrowed reference>` توصیه می‌شود تا آن را درجا به یک :term:`ارجاع قوی <strong reference>` تبدیل کند، مگر زمانی که شیء نمی‌تواند پیش از آخرین استفاده از ارجاع قرض‌گرفته‌شده نابود شود. تابع :c:func:`Py_NewRef` می‌تواند برای ایجاد یک :term:`ارجاع قوی <strong reference>` جدید استفاده شود."

msgid "bytes-like object"

msgstr "شیء شبه‌بایت"

msgid "An object that supports the :ref:`bufferobjects` and can export a C-:term:`contiguous` buffer. This includes all :class:`bytes`, :class:`bytearray`, and :class:`array.array` objects, as well as many common :class:`memoryview` objects. Bytes-like objects can be used for various operations that work with binary data; these include compression, saving to a binary file, and sending over a socket."

msgstr "شی‌ءای که از :ref:`bufferobjects` پشتیبانی می‌کند و می‌تواند یک بافر C-:term:`پیوسته <contiguous>` اکسپورت کند. این شامل همه‌ی اشیای :class:`bytes`، :class:`bytearray` و :class:`array.array` و همچنین بسیاری از اشیای رایج :class:`memoryview` می‌شود. اشیای شبه‌بایت می‌توانند برای عملیات مختلفی که با داده‌های دودویی کار می‌کنند استفاده شوند؛ از جمله فشرده‌سازی، ذخیره در یک پرونده دودویی و ارسال از طریق یک سوکت."

msgid "Some operations need the binary data to be mutable. The documentation often refers to these as \"read-write bytes-like objects\". Example mutable buffer objects include :class:`bytearray` and a :class:`memoryview` of a :class:`bytearray`. Other operations require the binary data to be stored in immutable objects (\"read-only bytes-like objects\"); examples of these include :class:`bytes` and a :class:`memoryview` of a :class:`bytes` object."

msgstr "برخی عملیات‌ها نیاز دارند که داده‌های دودویی تغییرپذیر باشند. مستندات اغلب به این موارد با عنوان «اشیای شبه‌بایت خواندن-نوشتن» اشاره می‌کنند. نمونه‌هایی از اشیای بافر تغییرپذیر شامل :class:`bytearray` و یک :class:`memoryview` از یک :class:`bytearray` هستند. عملیات‌های دیگر نیاز دارند که داده‌های دودویی در اشیای تغییرناپذیر ذخیره شوند («اشیای شبه‌بایت فقط‌خواندنی»)؛ نمونه‌هایی از این موارد شامل :class:`bytes` و یک :class:`memoryview` از یک شیء :class:`bytes` هستند."

msgid "bytecode"

msgstr "بایت‌کد"

msgid "Python source code is compiled into bytecode, the internal representation of a Python program in the CPython interpreter. The bytecode is also cached in ``.pyc`` files so that executing the same file is faster the second time (recompilation from source to bytecode can be avoided). This \"intermediate language\" is said to run on a :term:`virtual machine` that executes the machine code corresponding to each bytecode. Do note that bytecodes are not expected to work between different Python virtual machines, nor to be stable between Python releases."

msgstr "کد منبع پایتون به بایت‌کد کامپایل می‌شود؛ بایت‌کد نمایش داخلی یک برنامه‌ی پایتون در مفسر CPython است. بایت‌کد همچنین در پرونده‌های ``.pyc`` ذخیره می‌شود تا اجرای همان پرونده در بار دوم سریع‌تر باشد (می‌توان از کامپایل دوباره از منبع به بایت‌کد جلوگیری کرد). گفته می‌شود این «زبان میانی» روی یک :term:`ماشین مجازی <virtual machine>` اجرا می‌شود که کد ماشین متناظر با هر بایت‌کد را اجرا می‌کند. توجه داشته باشید که انتظار نمی‌رود بایت‌کدها بین ماشین‌های مجازی مختلف پایتون کار کنند یا بین نسخه‌های مختلف پایتون پایدار باشند."

msgid "A list of bytecode instructions can be found in the documentation for :ref:`the dis module <bytecodes>`."

msgstr "فهرستی از دستورهای بایت‌کد را می‌توان در مستندات :ref:`the dis module <bytecodes>` یافت."

msgid "callable"

msgstr "فراخوانی‌پذیر"

msgid "A callable is an object that can be called, possibly with a set of arguments (see :term:`argument`), with the following syntax::"

msgstr "یک فراخوانی‌پذیر شی‌ءای است که می‌توان آن را، احتمالاً با مجموعه‌ای از آرگومان‌ها (به :term:`آرگومان <argument>` مراجعه کنید)، با سینتکس زیر فراخوانی کرد::"

msgid "callable(argument1, argument2, argumentN)"

msgstr "callable(argument1, argument2, argumentN)"

msgid "A :term:`function`, and by extension a :term:`method`, is a callable. An instance of a class that implements the :meth:`~object.__call__` method is also a callable."

msgstr "یک :term:`تابع <function>` و به‌تبع آن یک :term:`متد <method>`، یک فراخوانی‌پذیر است. یک نمونه از یک کلاس که متد :meth:`~object.__call__` را پیاده‌سازی می‌کند نیز یک فراخوانی‌پذیر است."

msgid "callback"

msgstr "کال‌بک"

msgid "A subroutine function which is passed as an argument to be executed at some point in the future."

msgstr "یک تابع زیرروال که به‌عنوان آرگومان ارسال می‌شود تا در نقطه‌ای در آینده اجرا شود."

msgid "class"

msgstr "کلاس"

msgid "A template for creating user-defined objects. Class definitions normally contain method definitions which operate on instances of the class."

msgstr "الگویی برای ایجاد اشیای تعریف‌شده توسط کاربر. تعریف‌های کلاس معمولاً شامل تعریف‌های متد هستند که روی نمونه‌های کلاس عمل می‌کنند."

msgid "class variable"

msgstr "متغیر کلاس"

msgid "A variable defined in a class and intended to be modified only at class level (i.e., not in an instance of the class)."

msgstr "متغیری که در یک کلاس تعریف شده است و قرار است فقط در سطح کلاس تغییر داده شود (یعنی نه در یک نمونه از کلاس)."

msgid "closure variable"

msgstr "متغیر بستار"

msgid "A :term:`free variable` referenced from a :term:`nested scope` that is defined in an outer scope rather than being resolved at runtime from the globals or builtin namespaces. May be explicitly defined with the :keyword:`nonlocal` keyword to allow write access, or implicitly defined if the variable is only being read."

msgstr "یک :term:`متغیر آزاد <free variable>` که از یک :term:`محدوده‌ی تودرتو <nested scope>` ارجاع داده می‌شود و در یک محدوده‌ی بیرونی تعریف شده است، به‌جای این‌که در زمان ران‌تایم از فضای نام های سراسری یا توکار حل شود. ممکن است به‌طور صریح با کلیدواژه‌ی :keyword:`nonlocal` تعریف شود تا امکان دسترسی نوشتن فراهم شود، یا اگر متغیر فقط خوانده می‌شود، به‌طور ضمنی تعریف شود."

msgid "For example, in the ``inner`` function in the following code, both ``x`` and ``print`` are :term:`free variables <free variable>`, but only ``x`` is a *closure variable*::"

msgstr "برای مثال، در تابع ``inner`` در کد زیر، هر دو مورد ``x`` و ``print`` :term:`متغیر آزاد <free variable>` هستند، اما فقط ``x`` یک *متغیر بستار* است::"

msgid ""

msgstr ""

msgid "Due to the :attr:`codeobject.co_freevars` attribute (which, despite its name, only includes the names of closure variables rather than listing all referenced free variables), the more general :term:`free variable` term is sometimes used even when the intended meaning is to refer specifically to closure variables."

msgstr "به‌دلیل ویژگی :attr:`codeobject.co_freevars` (که با وجود نامش، فقط نام‌های متغیرهای بستار را شامل می‌شود و همه‌ی متغیرهای آزاد ارجاع‌داده‌شده را فهرست نمی‌کند)، اصطلاح کلی‌تر :term:`متغیر آزاد <free variable>` گاهی حتی زمانی استفاده می‌شود که معنای مورد نظر به‌طور مشخص اشاره به متغیرهای بستار دارد."

msgid "complex number"

msgstr "عدد مختلط"

msgid "An extension of the familiar real number system in which all numbers are expressed as a sum of a real part and an imaginary part. Imaginary numbers are real multiples of the imaginary unit (the square root of ``-1``), often written ``i`` in mathematics or ``j`` in engineering. Python has built-in support for complex numbers, which are written with this latter notation; the imaginary part is written with a ``j`` suffix, e.g., ``3+1j``. To get access to complex equivalents of the :mod:`math` module, use :mod:`cmath`. Use of complex numbers is a fairly advanced mathematical feature. If you're not aware of a need for them, it's almost certain you can safely ignore them."

msgstr "گسترشی از سیستم آشنای اعداد حقیقی که در آن همه‌ی اعداد به‌صورت مجموع یک بخش حقیقی و یک بخش موهومی بیان می‌شوند. اعداد موهومی مضرب‌های حقیقی واحد موهومی (ریشه‌ی دوم ``-1``) هستند که در ریاضیات اغلب با ``i`` و در مهندسی با ``j`` نوشته می‌شود. پایتون پشتیبانی توکار از اعداد مختلط دارد که با این نمادگذاری اخیر نوشته می‌شوند؛ بخش موهومی با پسوند ``j`` نوشته می‌شود، برای مثال ``3+1j``. برای دسترسی به معادل‌های مختلط ماژول :mod:`math`، از :mod:`cmath` استفاده کنید. استفاده از اعداد مختلط یک ویژگی نسبتاً پیشرفته‌ی ریاضی است. اگر از نیاز به آن‌ها آگاه نیستید، تقریباً قطعی است که می‌توانید با خیال راحت آن‌ها را نادیده بگیرید."

msgid "concurrency"

msgstr "همزمانی"

msgid "The ability of a computer program to perform multiple tasks at the same time. Python provides libraries for writing programs that make use of different forms of concurrency. :mod:`asyncio` is a library for dealing with asynchronous tasks and coroutines. :mod:`threading` provides access to operating system threads and :mod:`multiprocessing` to operating system processes. Multi-core processors can execute threads and processes on different CPU cores at the same time (see :term:`parallelism`)."

msgstr "توانایی یک برنامه‌ی کامپیوتری برای انجام چندین کار در یک زمان. پایتون کتابخانه‌هایی برای نوشتن برنامه‌هایی که از شکل‌های مختلف همزمانی استفاده می‌کنند فراهم می‌کند. :mod:`asyncio` کتابخانه‌ای برای کار با وظایف ناهمگام و coroutineها است. :mod:`threading` دسترسی به نخ‌های سیستم‌عامل و :mod:`multiprocessing` دسترسی به پردازه‌های سیستم‌عامل را فراهم می‌کنند. پردازنده‌های چندهسته‌ای می‌توانند نخ‌ها و پردازه‌ها را روی هسته‌های مختلف CPU به‌طور همزمان اجرا کنند (به :term:`موازی‌سازی <parallelism>` مراجعه کنید)."

msgid "concurrent modification"

msgstr "تغییر همزمان"

msgid "When multiple threads modify shared data at the same time. Concurrent modification without proper synchronization can cause :term:`race conditions <race condition>`, and might also trigger a :term:`data race <data race>`, data corruption, or both."

msgstr "هنگامی که چندین نخ در یک زمان داده‌های اشتراکی را تغییر می‌دهند. تغییر همزمان بدون همگام‌سازی مناسب می‌تواند باعث :term:`شرط رقابت <race condition>` شود و همچنین ممکن است یک :term:`رقابت داده <data race>`، خرابی داده یا هر دو را ایجاد کند."

msgid "context"

msgstr "زمینه"

msgid "This term has different meanings depending on where and how it is used. Some common meanings:"

msgstr "این اصطلاح بسته به محل و نحوه‌ی استفاده، معانی متفاوتی دارد. برخی از معانی رایج:"

msgid "The temporary state or environment established by a :term:`context manager` via a :keyword:`with` statement."

msgstr "وضعیت یا محیط موقتی که توسط یک :term:`مدیر زمینه <context manager>` از طریق یک دستور :keyword:`with` ایجاد می‌شود."

msgid "The collection of key­value bindings associated with a particular :class:`contextvars.Context` object and accessed via :class:`~contextvars.ContextVar` objects. Also see :term:`context variable`."

msgstr "مجموعه‌ی مقیدسازی‌های کلید-مقدار مرتبط با یک شیء :class:`contextvars.Context` خاص و قابل دسترسی از طریق اشیای :class:`~contextvars.ContextVar`. همچنین :term:`متغیر زمینه <context variable>` را ببینید."

msgid "A :class:`contextvars.Context` object. Also see :term:`current context`."

msgstr "یک شیء :class:`contextvars.Context`. همچنین :term:`زمینه فعلی <current context>` را ببینید."

msgid "context management protocol"

msgstr "پروتکل مدیریت زمینه"

msgid "The :meth:`~object.__enter__` and :meth:`~object.__exit__` methods called by the :keyword:`with` statement. See :pep:`343`."

msgstr "متدهای :meth:`~object.__enter__` و :meth:`~object.__exit__` که توسط دستور :keyword:`with` فراخوانی می‌شوند. :pep:`343` را ببینید."

msgid "context manager"

msgstr "مدیر زمینه"

msgid "An object which implements the :term:`context management protocol` and controls the environment seen in a :keyword:`with` statement. See :pep:`343`."

msgstr "شی‌ءای که :term:`پروتکل مدیریت زمینه <context management protocol>` را پیاده‌سازی می‌کند و محیط مشاهده‌شده در یک دستور :keyword:`with` را کنترل می‌کند. :pep:`343` را ببینید."

msgid "context variable"

msgstr "متغیر زمینه"

msgid "A variable whose value depends on which context is the :term:`current context`. Values are accessed via :class:`contextvars.ContextVar` objects. Context variables are primarily used to isolate state between concurrent asynchronous tasks."

msgstr "متغیری که مقدار آن به این بستگی دارد که کدام زمینه :term:`زمینه فعلی <current context>` است. مقادیر از طریق اشیای :class:`contextvars.ContextVar` قابل دسترسی هستند. متغیرهای زمینه عمدتاً برای جداسازی وضعیت بین وظایف ناهمگام همزمان استفاده می‌شوند."

msgid "contiguous"

msgstr "پیوسته"

msgid "A buffer is considered contiguous exactly if it is either *C-contiguous* or *Fortran contiguous*. Zero-dimensional buffers are C and Fortran contiguous. In one-dimensional arrays, the items must be laid out in memory next to each other, in order of increasing indexes starting from zero. In multidimensional C-contiguous arrays, the last index varies the fastest when visiting items in order of memory address. However, in Fortran contiguous arrays, the first index varies the fastest."

msgstr "یک بافر دقیقاً پیوسته در نظر گرفته می‌شود اگر یا *C-contiguous* یا *Fortran contiguous* باشد. بافرهای صفربعدی هم C و هم Fortran پیوسته هستند. در آرایه‌های یک‌بعدی، آیتم‌ها باید در حافظه در کنار یکدیگر و به‌ترتیب اندیس‌های افزایشی که از صفر شروع می‌شوند قرار گرفته باشند. در آرایه‌های چندبعدی C-contiguous، هنگام بازدید از آیتم‌ها به‌ترتیب آدرس حافظه، آخرین اندیس سریع‌ترین تغییر را دارد. با این حال، در آرایه‌های Fortran contiguous، اولین اندیس سریع‌ترین تغییر را دارد."

msgid "coroutine"

msgstr "هم‌روال"

msgid "Coroutines are a more generalized form of subroutines. Subroutines are entered at one point and exited at another point. Coroutines can be entered, exited, and resumed at many different points. They can be implemented with the :keyword:`async def` statement. See also :pep:`492`."

msgstr "هم‌روال‌ها شکل کلی‌تری از زیرروال‌ها هستند. زیرروال‌ها از یک نقطه وارد و از نقطه‌ای دیگر خارج می‌شوند. هم‌روال‌ها می‌توانند از نقاط مختلفی وارد، خارج و از سر گرفته شوند. آن‌ها می‌توانند با دستور :keyword:`async def` پیاده‌سازی شوند. همچنین :pep:`492` را ببینید."

msgid "coroutine function"

msgstr "تابع هم‌روال"

msgid "A function which returns a :term:`coroutine` object. A coroutine function may be defined with the :keyword:`async def` statement, and may contain :keyword:`await`, :keyword:`async for`, and :keyword:`async with` keywords. These were introduced by :pep:`492`."

msgstr "تابعی که یک شیء :term:`هم‌روال <coroutine>` بازمی‌گرداند. یک تابع هم‌روال می‌تواند با دستور :keyword:`async def` تعریف شود و می‌تواند شامل کلیدواژه‌های :keyword:`await`، :keyword:`async for` و :keyword:`async with` باشد. این موارد توسط :pep:`492` معرفی شدند."

msgid "CPython"

msgstr "CPython"

msgid "The canonical implementation of the Python programming language, as distributed on `python.org <https://www.python.org>`_. The term \"CPython\" is used when necessary to distinguish this implementation from others such as Jython or IronPython."

msgstr "پیاده‌سازی کانونیکال زبان برنامه‌نویسی پایتون، همان‌طور که در `python.org <https://www.python.org>`_ توزیع می‌شود. اصطلاح «CPython» در مواقعی استفاده می‌شود که لازم باشد این پیاده‌سازی از موارد دیگری مانند Jython یا IronPython متمایز شود."

msgid "current context"

msgstr "زمینه فعلی"

msgid "The :term:`context` (:class:`contextvars.Context` object) that is currently used by :class:`~contextvars.ContextVar` objects to access (get or set) the values of :term:`context variables <context variable>`. Each thread has its own current context. Frameworks for executing asynchronous tasks (see :mod:`asyncio`) associate each task with a context which becomes the current context whenever the task starts or resumes execution."

msgstr ":term:`زمینه <context>` (:class:`contextvars.Context`) که در حال حاضر توسط اشیای :class:`~contextvars.ContextVar` برای دسترسی (دریافت یا تنظیم) مقادیر :term:`متغیر زمینه <context variable>` استفاده می‌شود. هر نخ، زمینه‌ی فعلی خود را دارد. چارچوب‌های اجرای وظایف ناهمگام (به :mod:`asyncio` مراجعه کنید) هر وظیفه را با یک زمینه مرتبط می‌کنند که هر زمان وظیفه شروع یا ادامه‌ی اجرا می‌دهد، به زمینه‌ی فعلی تبدیل می‌شود."

msgid "cyclic isolate"

msgstr "ایزوله‌ی چرخه‌ای"

msgid "A subgroup of one or more objects that reference each other in a reference cycle, but are not referenced by objects outside the group. The goal of the :term:`cyclic garbage collector <garbage collection>` is to identify these groups and break the reference cycles so that the memory can be reclaimed."

msgstr "زیرگروهی شامل یک یا چند شیء که در یک چرخه‌ی ارجاع به یکدیگر ارجاع می‌دهند، اما توسط اشیای خارج از گروه ارجاع داده نمی‌شوند. هدف :term:`زباله‌روبی <garbage collection>` شناسایی این گروه‌ها و شکستن چرخه‌های ارجاع است تا حافظه بتواند بازیابی شود."

msgid "data race"

msgstr "رقابت داده"

msgid "A situation where multiple threads access the same memory location concurrently, at least one of the accesses is a write, and the threads do not use any synchronization to control their access. Data races lead to :term:`non-deterministic` behavior and can cause data corruption. Proper use of :term:`locks <lock>` and other :term:`synchronization primitives <synchronization primitive>` prevents data races. Note that data races can only happen in native code, but that :term:`native code` might be exposed in a Python API. See also :term:`race condition` and :term:`thread-safe`."

msgstr "وضعیتی که در آن چندین نخ به یک محل حافظه‌ی یکسان به‌طور همزمان دسترسی دارند، دست‌کم یکی از دسترسی‌ها نوشتن است و نخ‌ها برای کنترل دسترسی خود از هیچ همگام‌سازی‌ای استفاده نمی‌کنند. رقابت‌های داده به رفتار :term:`غیرقطعی <non-deterministic>` منجر می‌شوند و می‌توانند باعث خرابی داده شوند. استفاده‌ی درست از :term:`قفل <lock>` و دیگر :term:`اولیه همگام‌سازی <synchronization primitive>` از رقابت‌های داده جلوگیری می‌کند. توجه داشته باشید که رقابت‌های داده فقط در کد بومی رخ می‌دهند، اما آن :term:`کد بومی <native code>` ممکن است در یک API پایتون در معرض استفاده قرار گرفته باشد. همچنین :term:`شرط رقابت <race condition>` و :term:`ایمن برای نخ‌های اجرایی <thread-safe>` را ببینید."

msgid "deadlock"

msgstr "بن‌بست"

msgid "A situation in which two or more tasks (threads, processes, or coroutines) wait indefinitely for each other to release resources or complete actions, preventing any from making progress. For example, if thread A holds lock 1 and waits for lock 2, while thread B holds lock 2 and waits for lock 1, both threads will wait indefinitely. In Python this often arises from acquiring multiple locks in conflicting orders or from circular join/await dependencies. Deadlocks can be avoided by always acquiring multiple :term:`locks <lock>` in a consistent order. See also :term:`lock` and :term:`reentrant`."

msgstr "وضعیتی که در آن دو یا چند وظیفه (نخ‌ها، پردازه‌ها یا هم‌روال‌ها) به‌طور نامحدود منتظر می‌مانند تا یکدیگر منابع را آزاد کنند یا اقداماتی را کامل کنند، و در نتیجه هیچ‌کدام نمی‌توانند پیشرفت کنند. برای مثال، اگر نخ A قفل ۱ را در اختیار داشته باشد و منتظر قفل ۲ باشد، در حالی که نخ B قفل ۲ را در اختیار دارد و منتظر قفل ۱ است، هر دو نخ به‌طور نامحدود منتظر خواهند ماند. در پایتون، این وضعیت اغلب از دریافت چندین قفل با ترتیب‌های ناسازگار یا از وابستگی‌های join/await چرخه‌ای ایجاد می‌شود. می‌توان با همیشه دریافت کردن چندین :term:`قفل <lock>` به یک ترتیب ثابت از بن‌بست‌ها جلوگیری کرد. همچنین :term:`قفل <lock>` و :term:`بازورودپذیر <reentrant>` را ببینید."

msgid "decorator"

msgstr "دکوراتور"

msgid "A function returning another function, usually applied as a function transformation using the ``@wrapper`` syntax. Common examples for decorators are :deco:`classmethod` and :deco:`staticmethod`."

msgstr "تابعی که تابع دیگری را بازمی‌گرداند و معمولاً با استفاده از سینتکس ``@wrapper`` به‌عنوان یک تبدیل تابع اعمال می‌شود. نمونه‌های رایج دکوراتورها :deco:`classmethod` و :deco:`staticmethod` هستند."

msgid "The decorator syntax is merely syntactic sugar, the following two function definitions are semantically equivalent::"

msgstr "سینتکس دکوراتور صرفاً یک قند نحوی (syntactic sugar) است؛ دو تعریف تابع زیر از نظر معنایی معادل هستند::"

msgid ""

msgstr ""

msgid "The same concept exists for classes, but is less commonly used there. See the documentation for :ref:`function definitions <function>` and :ref:`class definitions <class>` for more about decorators."

msgstr "همین مفهوم برای کلاس‌ها نیز وجود دارد، اما استفاده از آن در آنجا کمتر رایج است. برای اطلاعات بیشتر درباره‌ی دکوراتورها، مستندات :ref:`تابع <function>` و :ref:`کلاس <class>` را ببینید."

msgid "descriptor"

msgstr "توصیف‌گر"

msgid "Any object which defines the methods :meth:`~object.__get__`, :meth:`~object.__set__`, or :meth:`~object.__delete__`. When a class attribute is a descriptor, its special binding behavior is triggered upon attribute lookup. Normally, using *a.b* to get, set or delete an attribute looks up the object named *b* in the class dictionary for *a*, but if *b* is a descriptor, the respective descriptor method gets called. Understanding descriptors is a key to a deep understanding of Python because they are the basis for many features including functions, methods, properties, class methods, static methods, and reference to super classes."

msgstr "هر شی‌ءای که متدهای :meth:`~object.__get__`، :meth:`~object.__set__` یا :meth:`~object.__delete__` را تعریف کند. هنگامی که یک ویژگی کلاس یک توصیف‌گر باشد، رفتار اتصال ویژه‌ی آن هنگام جست‌وجوی ویژگی فعال می‌شود. معمولاً استفاده از *a.b* برای دریافت، تنظیم یا حذف یک ویژگی، شیء با نام *b* را در دیکشنری کلاس *a* جست‌وجو می‌کند، اما اگر *b* یک توصیف‌گر باشد، متد مربوط به توصیف‌گر فراخوانی می‌شود. درک توصیف‌گرها کلیدی برای درک عمیق پایتون است، زیرا آن‌ها پایه‌ی بسیاری از قابلیت‌ها از جمله توابع، متدها، ویژگی‌ها، متدهای کلاس، متدهای ایستا و ارجاع به کلاس‌های بالادستی هستند."

msgid "For more information about descriptors' methods, see :ref:`descriptors` or the :ref:`Descriptor How To Guide <descriptorhowto>`."

msgstr "برای اطلاعات بیشتر درباره‌ی متدهای توصیف‌گرها، :ref:`descriptors` یا :ref:`Descriptor How To Guide <descriptorhowto>` را ببینید."

msgid "dictionary"

msgstr "دیکشنری"

msgid "An associative array, where arbitrary keys are mapped to values. The keys can be any object with :meth:`~object.__hash__` and :meth:`~object.__eq__` methods. Called a hash in Perl."

msgstr "یک آرایه‌ی انجمنی که در آن کلیدهای دلخواه به مقادیر نگاشت می‌شوند. کلیدها می‌توانند هر شیءای باشند که متدهای :meth:`~object.__hash__` و :meth:`~object.__eq__` را داشته باشد. در Perl به آن hash گفته می‌شود."

msgid "dictionary comprehension"

msgstr "درک دیکشنری"

msgid "A compact way to process all or part of the elements in an iterable and return a dictionary with the results. ``results = {n: n ** 2 for n in range(10)}`` generates a dictionary containing key ``n`` mapped to value ``n ** 2``. See :ref:`comprehensions`."

msgstr "روشی فشرده برای پردازش همه یا بخشی از عناصر یک پیمایش‌پذیر و بازگرداندن یک دیکشنری با نتایج. ``results = {n: n ** 2 for n in range(10)}`` یک دیکشنری ایجاد می‌کند که شامل کلید ``n`` نگاشت‌شده به مقدار ``n ** 2`` است. :ref:`comprehensions` را ببینید."

msgid "dictionary view"

msgstr "نمای دیکشنری"

msgid "The objects returned from :meth:`dict.keys`, :meth:`dict.values`, and :meth:`dict.items` are called dictionary views. They provide a dynamic view on the dictionary’s entries, which means that when the dictionary changes, the view reflects these changes. To force the dictionary view to become a full list use ``list(dictview)``. See :ref:`dict-views`."

msgstr "اشیایی که توسط :meth:`dict.keys`، :meth:`dict.values` و :meth:`dict.items` بازگردانده می‌شوند، نماهای دیکشنری نامیده می‌شوند. آن‌ها نمایی پویا از ورودی‌های دیکشنری فراهم می‌کنند، به این معنا که هنگام تغییر دیکشنری، نما نیز این تغییرات را منعکس می‌کند. برای تبدیل نمای دیکشنری به یک فهرست کامل از ``list(dictview)`` استفاده کنید. :ref:`dict-views` را ببینید."

msgid "docstring"

msgstr "رشته‌ی مستندات"

msgid "A string literal which appears as the first expression in a class, function or module. While ignored when the suite is executed, it is recognized by the compiler and put into the :attr:`~definition.__doc__` attribute of the enclosing class, function or module. Since it is available via introspection, it is the canonical place for documentation of the object."

msgstr "یک مقدار رشته‌ای که به‌عنوان اولین عبارت در یک کلاس، تابع یا ماژول ظاهر می‌شود. اگرچه هنگام اجرای بدنه نادیده گرفته می‌شود، توسط کامپایلر شناسایی شده و در ویژگی :attr:`~definition.__doc__` کلاس، تابع یا ماژول دربرگیرنده قرار داده می‌شود. از آنجا که از طریق درون‌نگری در دسترس است، مکان کانونیکال برای مستندسازی شیء محسوب می‌شود."

msgid "duck-typing"

msgstr "نوع‌دهی اردکی"

msgid "A programming style which does not look at an object's type to determine if it has the right interface; instead, the method or attribute is simply called or used (\"If it looks like a duck and quacks like a duck, it must be a duck.\") By emphasizing interfaces rather than specific types, well-designed code improves its flexibility by allowing polymorphic substitution. Duck-typing avoids tests using :func:`type` or :func:`isinstance`. (Note, however, that duck-typing can be complemented with :term:`abstract base classes <abstract base class>`.) Instead, it typically employs :func:`hasattr` tests or :term:`EAFP` programming."

msgstr "سبک برنامه‌نویسی‌ای که برای تعیین داشتن رابط مناسب توسط یک شیء، به نوع آن نگاه نمی‌کند؛ در عوض، متد یا ویژگی به‌سادگی فراخوانی یا استفاده می‌شود («اگر شبیه اردک است و مانند اردک صدا می‌دهد، پس باید اردک باشد.»). با تأکید بر رابط‌ها به‌جای نوع‌های خاص، کد با طراحی خوب با امکان جایگزینی چندریخت، انعطاف‌پذیری خود را افزایش می‌دهد. نوع‌دهی اردکی از آزمون‌های مبتنی بر :func:`type` یا :func:`isinstance` اجتناب می‌کند. (با این حال، توجه داشته باشید که نوع‌دهی اردکی می‌تواند با :term:`کلاس پایه‌ی انتزاعی <abstract base class>` تکمیل شود.) در عوض، معمولاً از آزمون‌های :func:`hasattr` یا برنامه‌نویسی :term:`EAFP <EAFP>` استفاده می‌کند."

msgid "dunder"

msgstr "داندر"

msgid "An informal short-hand for \"double underscore\", used when talking about a :term:`special method`. For example, ``__init__`` is often pronounced \"dunder init\"."

msgstr "یک شکل کوتاه و غیررسمی برای «دو زیرخط» که هنگام صحبت درباره‌ی یک :term:`متد ویژه <special method>` استفاده می‌شود. برای مثال، ``__init__`` اغلب «داندر اینیت» تلفظ می‌شود."

msgid "EAFP"

msgstr "EAFP"

msgid "Easier to ask for forgiveness than permission. This common Python coding style assumes the existence of valid keys or attributes and catches exceptions if the assumption proves false. This clean and fast style is characterized by the presence of many :keyword:`try` and :keyword:`except` statements. The technique contrasts with the :term:`LBYL` style common to many other languages such as C."

msgstr "آسان‌تر است که درخواست بخشش کنید تا اجازه. این سبک رایج کدنویسی پایتون وجود کلیدها یا ویژگی‌های معتبر را فرض می‌کند و اگر این فرض نادرست باشد، استثناها را دریافت می‌کند. این سبک پاک و سریع با وجود تعداد زیادی دستورهای :keyword:`try` و :keyword:`except` شناخته می‌شود. این روش در تضاد با سبک :term:`LBYL <LBYL>` است که در بسیاری از زبان‌های دیگر مانند C رایج است."

msgid "evaluate function"

msgstr "تابع ارزیابی"

msgid "A function that can be called to evaluate a lazily evaluated attribute of an object, such as the value of type aliases created with the :keyword:`type` statement."

msgstr "تابعی که می‌توان آن را برای ارزیابی یک ویژگی با ارزیابی تنبل یک شیء فراخوانی کرد، مانند مقدار نام‌های مستعار نوع که با دستور :keyword:`type` ایجاد شده‌اند."

msgid "exhausted"

msgstr "به‌پایان‌رسیده"

msgid "An :term:`iterator` that has produced all of its values is said to be :dfn:`exhausted`. Further attempts to get the next value (for example, calls to :func:`next`) raise :exc:`StopIteration` (or :exc:`StopAsyncIteration` in the case of an :term:`asynchronous iterator`)."

msgstr "یک :term:`پیمایش‌گر <iterator>` که تمام مقادیر خود را تولید کرده است، :dfn:`به پایان‌رسیده (exhausted)` نامیده می‌شود. تلاش‌های بیشتر برای دریافت مقدار بعدی (مثلاً فراخوانی‌های :func:`next`) باعث ایجاد :exc:`StopIteration` می‌شوند (یا :exc:`StopAsyncIteration` در صورت :term:`پیمایش‌گر ناهمگام <asynchronous iterator>`)."

msgid "expression"

msgstr "عبارت"

msgid "A piece of syntax which can be evaluated to some value. In other words, an expression is an accumulation of expression elements like literals, names, attribute access, operators or function calls which all return a value. Not all language constructs are expressions. There are also :term:`statement`\\s which cannot be used as expressions, such as :keyword:`while`. Assignments are also statements, not expressions."

msgstr "یک قطعه سینتکس که می‌تواند به مقداری ارزیابی شود. به عبارت دیگر، عبارت مجموعه‌ای از المان‌های عبارت مانند مقادیر لفظی، نام‌ها، دسترسی به ویژگی، عملگرها یا فراخوانی توابع است که همگی مقداری برمی‌گردانند. هر سازه‌ی زبانی عبارت نیست. همچنین :term:`دستورها <statement>` وجود دارند که نمی‌توان از آن‌ها به عنوان عبارت استفاده کرد، مانند :keyword:`while`. دستورهای انتساب نیز دستور هستند، نه عبارت‌ها."

msgid "extension module"

msgstr "ماژول توسعه‌ای"

msgid "A module written in C or C++, using Python's C API to interact with the core and with user code."

msgstr "ماژول نوشته‌شده به زبان C یا C++ که از API زبان C پایتون برای تعامل با هسته و کد کاربر استفاده می‌کند."

msgid "f-string"

msgstr "اف‌استرینگ"

msgid "f-strings"

msgstr "اف‌استرینگ‌ها"

msgid "String literals prefixed with ``f`` or ``F`` are commonly called \"f-strings\" which is short for :ref:`formatted string literals <f-strings>`. See also :pep:`498`."

msgstr "رشته‌های لفظی که با ``f`` یا ``F`` پیشوندگذاری شده‌اند، معمولاً «اف‌استرینگ» نامیده می‌شوند که کوتاه‌شده‌ی :ref:`اف‌استرینگ‌ها <f-strings>` است. همچنین :pep:`498` را ببینید."

msgid "file object"

msgstr "شیء پرونده"

msgid "An object exposing a file-oriented API (with methods such as :meth:`!read` or :meth:`!write`) to an underlying resource. Depending on the way it was created, a file object can mediate access to a real on-disk file or to another type of storage or communication device (for example standard input/output, in-memory buffers, sockets, pipes, etc.). File objects are also called :dfn:`file-like objects` or :dfn:`streams`."

msgstr "شی‌ءای که یک API فایل‌محور (با متدهایی مانند :meth:`!read` یا :meth:`!write`) برای یک منبع زیربنایی ارائه می‌دهد. بسته به نحوه‌ی ایجاد آن، یک شیء پرونده می‌تواند دسترسی به یک پرونده واقعی روی دیسک یا نوع دیگری از فضای ذخیره‌سازی یا دستگاه ارتباطی را مدیریت کند (برای مثال ورودی/خروجی استاندارد، بافرهای درون‌حافظه‌ای، سوکت‌ها، پایپ‌ها و غیره). اشیای پرونده همچنین با نام‌های :dfn:`file-like objects` یا :dfn:`streams` شناخته می‌شوند."

msgid "There are actually three categories of file objects: raw :term:`binary files <binary file>`, buffered :term:`binary files <binary file>` and :term:`text files <text file>`. Their interfaces are defined in the :mod:`io` module. The canonical way to create a file object is by using the :func:`open` function."

msgstr "در واقع سه دسته از اشیای پرونده وجود دارد: :term:`پرونده دودویی <binary file>` خام، :term:`پرونده دودویی <binary file>` بافرشده و :term:`پرونده متنی <text file>`. رابط‌های آن‌ها در ماژول :mod:`io` تعریف شده‌اند. روش کانونیکال ایجاد یک شیء پرونده، استفاده از تابع :func:`open` است."

msgid "file-like object"

msgstr "شیء شبه‌پرونده"

msgid "A synonym for :term:`file object`."

msgstr "هم‌معنای :term:`شیء پرونده <file object>`."

msgid "filesystem encoding and error handler"

msgstr "کدگذاری سیستم پرونده و هندلر خطا"

msgid "Encoding and error handler used by Python to decode bytes from the operating system and encode Unicode to the operating system."

msgstr "کدگذاری و هندلر خطایی که پایتون برای کدگشایی بایت‌ها از سیستم‌عامل و کدگذاری یونیکد به سیستم‌عامل استفاده می‌کند."

msgid "The filesystem encoding must guarantee to successfully decode all bytes below 128. If the file system encoding fails to provide this guarantee, API functions can raise :exc:`UnicodeError`."

msgstr "کدگذاری سیستم پرونده باید تضمین کند که همه‌ی بایت‌های کمتر از ۱۲۸ را با موفقیت کدگشایی می‌کند. اگر کدگذاری سیستم پرونده نتواند این تضمین را ارائه دهد، توابع API ممکن است استثنای :exc:`UnicodeError` ایجاد کنند."

msgid "The :func:`sys.getfilesystemencoding` and :func:`sys.getfilesystemencodeerrors` functions can be used to get the filesystem encoding and error handler."

msgstr "از توابع :func:`sys.getfilesystemencoding` و :func:`sys.getfilesystemencodeerrors` می‌توان برای دریافت کدگذاری سیستم پرونده و هندلر خطا استفاده کرد."

msgid "The :term:`filesystem encoding and error handler` are configured at Python startup by the :c:func:`PyConfig_Read` function: 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 "See also the :term:`locale encoding`."

msgstr "همچنین :term:`کدگذاری locale <locale encoding>` را ببینید."

msgid "finder"

msgstr "یابنده"

msgid "An object that tries to find the :term:`loader` for a module that is being imported."

msgstr "شیءای که تلاش می‌کند :term:`بارگذار <loader>` مربوط به ماژولی را که در حال ایمپورت شدن است پیدا کند."

msgid "There are two types of finder: :term:`meta path finders <meta path finder>` for use with :data:`sys.meta_path`, and :term:`path entry finders <path entry finder>` for use with :data:`sys.path_hooks`."

msgstr "دو نوع یابنده وجود دارد: :term:`یابنده‌ی مسیر فراداده <meta path finder>` برای استفاده با :data:`sys.meta_path` و :term:`یابنده‌ی ورودی مسیر <path entry finder>` برای استفاده با :data:`sys.path_hooks`."

msgid "See :ref:`finders-and-loaders` and :mod:`importlib` for much more detail."

msgstr "برای جزئیات بسیار بیشتر، :ref:`finders-and-loaders` و :mod:`importlib` را ببینید."

msgid "floor division"

msgstr "تقسیم کف"

msgid "Mathematical division that rounds down to nearest integer. The floor division operator is ``//``. For example, the expression ``11 // 4`` evaluates to ``2`` in contrast to the ``2.75`` returned by float true division. Note that ``(-11) // 4`` is ``-3`` because that is ``-2.75`` rounded *downward*. See :pep:`238`."

msgstr "تقسیم ریاضی که به نزدیک‌ترین عدد صحیح پایین گرد می‌شود. عملگر تقسیم کف ``//`` است. برای مثال، عبارت ``11 // 4`` به ``2`` ارزیابی می‌شود، در حالی که تقسیم حقیقی با عدد اعشاری مقدار ``2.75`` را بازمی‌گرداند. توجه داشته باشید که ``(-11) // 4`` برابر ``-3`` است، زیرا ``-2.75`` به سمت *پایین* گرد می‌شود. :pep:`238` را ببینید."

msgid "free threading"

msgstr "نخ‌گذاری آزاد"

msgid "A threading model where multiple threads can run Python bytecode simultaneously within the same interpreter. This is in contrast to the :term:`global interpreter lock` which allows only one thread to execute Python bytecode at a time. See :pep:`703`."

msgstr "مدل نخ‌ای که در آن چندین نخ می‌توانند بایت‌کد پایتون را به‌طور همزمان درون همان مفسر اجرا کنند. این در تضاد با :term:`قفل مفسر سراسری <global interpreter lock>` است که اجازه می‌دهد فقط یک نخ در هر زمان بایت‌کد پایتون را اجرا کند. :pep:`703` را ببینید."

msgid "free-threaded build"

msgstr "ساخت نخ‌آزاد"

msgid "A build of :term:`CPython` that supports :term:`free threading`, configured using the :option:`--disable-gil` option before compilation."

msgstr "ساختی از :term:`CPython <CPython>` که از :term:`نخ‌گذاری آزاد <free threading>` پشتیبانی می‌کند و با استفاده از گزینه‌ی :option:`--disable-gil` پیش از کامپایل پیکربندی شده است."

msgid "See :ref:`freethreading-python-howto`."

msgstr ":ref:`freethreading-python-howto` را ببینید."

msgid "free variable"

msgstr "متغیر آزاد"

msgid "Formally, as defined in the :ref:`language execution model <bind_names>`, a free variable is any variable used in a namespace which is not a local variable in that namespace. See :term:`closure variable` for an example. Pragmatically, due to the name of the :attr:`codeobject.co_freevars` attribute, the term is also sometimes used as a synonym for :term:`closure variable`."

msgstr "به‌صورت رسمی، همان‌طور که در :ref:`language execution model <bind_names>` تعریف شده است، یک متغیر آزاد هر متغیری است که در یک فضای نام استفاده می‌شود اما در آن فضای نام یک متغیر محلی نیست. برای نمونه، :term:`متغیر بستار <closure variable>` را ببینید. از نظر عملی، به‌دلیل نام ویژگی :attr:`codeobject.co_freevars`، این اصطلاح گاهی به‌عنوان مترادفی برای :term:`متغیر بستار <closure variable>` نیز استفاده می‌شود."

msgid "function"

msgstr "تابع"

msgid "A series of statements which returns some value to a caller. It can also be passed zero or more :term:`arguments <argument>` which may be used in the execution of the body. See also :term:`parameter`, :term:`method`, and the :ref:`function` section."

msgstr "مجموعه‌ای از دستورها که مقداری را به یک فراخواننده بازمی‌گرداند. همچنین می‌تواند صفر یا چند :term:`آرگومان <argument>` دریافت کند که ممکن است در اجرای بدنه استفاده شوند. همچنین :term:`پارامتر <parameter>`، :term:`متد <method>` و بخش :ref:`تابع <function>` را ببینید."

msgid "function annotation"

msgstr "حاشیه‌گذاری تابع"

msgid "An :term:`annotation` of a function parameter or return value."

msgstr "یک :term:`حاشیه‌گذاری <annotation>` برای پارامتر یک تابع یا مقدار بازگشتی."

msgid "Function annotations are usually used for :term:`type hints <type hint>`: for example, this function is expected to take two :class:`int` arguments and is also expected to have an :class:`int` return value::"

msgstr "حاشیه‌گذاری‌های تابع معمولاً برای :term:`راهنمای نوع <type hint>` استفاده می‌شوند: برای مثال، انتظار می‌رود این تابع دو آرگومان :class:`int` دریافت کند و همچنین یک مقدار بازگشتی :class:`int` داشته باشد::"

msgid ""

msgstr ""

msgid "Function annotation syntax is explained in section :ref:`function`."

msgstr "سینتکس حاشیه‌گذاری تابع در بخش :ref:`تابع <function>` توضیح داده شده است."

msgid "See :term:`variable annotation` and :pep:`484`, which describe this functionality. Also see :ref:`annotations-howto` for best practices on working with annotations."

msgstr "به :term:`حاشیه‌نویسی متغیر <variable annotation>` و :pep:`484` مراجعه کنید که این قابلیت را توضیح می‌دهند. همچنین برای بهترین روش‌ها در کار با حاشیه‌گذاری‌ها، :ref:`annotations-howto` را ببینید."

msgid "__future__"

msgstr "__future__"

msgid "A :ref:`future statement <future>`, ``from __future__ import <feature>``, directs the compiler to compile the current module using syntax or semantics that will become standard in a future release of Python. The :mod:`__future__` module documents the possible values of *feature*. By importing this module and evaluating its variables, you can see when a new feature was first added to the language and when it will (or did) become the default::"

msgstr "یک :ref:`future statement <future>`، یعنی ``from __future__ import <feature>``, به کامپایلر دستور می‌دهد ماژول فعلی را با استفاده از سینتکس یا معناشناسی‌ای کامپایل کند که در یک انتشار آینده‌ی پایتون استاندارد خواهد شد. ماژول :mod:`__future__` مقادیر ممکن *feature* را مستند می‌کند. با ایمپورت این ماژول و ارزیابی متغیرهای آن، می‌توانید ببینید چه زمانی یک ویژگی جدید برای اولین بار به زبان اضافه شده است و چه زمانی به حالت پیش‌فرض تبدیل خواهد شد (یا شده است)::"

msgid ""

msgstr ""

msgid "garbage collection"

msgstr "زباله‌روبی"

msgid "The process of freeing memory when it is not used anymore. Python performs garbage collection via reference counting and a cyclic garbage collector that is able to detect and break reference cycles. The garbage collector can be controlled using the :mod:`gc` module."

msgstr "فرایند آزادسازی حافظه هنگامی که دیگر استفاده نمی‌شود. پایتون زباله‌روبی را از طریق شمارش ارجاع‌ها و یک زباله‌روب چرخه‌ای که قادر به شناسایی و شکستن چرخه‌های ارجاع است انجام می‌دهد. زباله‌روب را می‌توان با استفاده از ماژول :mod:`gc` کنترل کرد."

msgid "generator"

msgstr "تولیدگر"

msgid "Informally used to mean either a :term:`generator function` or a :term:`generator iterator`, depending on context. The formal terms :term:`generator function` and :term:`generator iterator` are uncommon in practice; \"generator\" alone is almost always sufficient."

msgstr "به‌صورت غیررسمی برای اشاره به یک :term:`تابع تولیدگر <generator function>` یا یک :term:`پیمایش‌گر تولیدگر <generator iterator>`، بسته به زمینه، استفاده می‌شود. اصطلاحات رسمی :term:`تابع تولیدگر <generator function>` و :term:`پیمایش‌گر تولیدگر <generator iterator>` در عمل کمتر استفاده می‌شوند؛ «تولیدگر» به‌تنهایی تقریباً همیشه کافی است."

msgid "generator function"

msgstr "تابع تولیدگر"

msgid "A function which returns a :term:`generator` object. It looks like a normal function except that it contains :keyword:`yield` expressions for producing a series of values usable in a :keyword:`for`\\-loop or that can be retrieved one at a time with the :func:`next` function. See :ref:`yieldexpr`."

msgstr "تابعی که یک شیء :term:`تولیدگر <generator>` بازمی‌گرداند. این تابع شبیه یک تابع معمولی است، با این تفاوت که شامل عبارت‌های :keyword:`yield` برای تولید مجموعه‌ای از مقادیر قابل استفاده در یک حلقه‌ی :keyword:`for` یا قابل بازیابی یکی‌یکی با تابع :func:`next` است. :ref:`yieldexpr` را ببینید."

msgid "generator iterator"

msgstr "پیمایش‌گر تولیدگر"

msgid "An object created by a :term:`generator function` or a :term:`generator expression`."

msgstr "شیءای که توسط یک :term:`تابع تولیدگر <generator function>` یا یک :term:`عبارت تولیدگر <generator expression>` ایجاد می‌شود."

msgid "Each :keyword:`yield` temporarily suspends processing, remembering the execution state (including local variables and pending try-statements). When the *generator iterator* resumes, it picks up where it left off (in contrast to functions which start fresh on every invocation)."

msgstr "هر :keyword:`yield` پردازش را به‌طور موقت متوقف می‌کند و وضعیت اجرا (شامل متغیرهای محلی و دستورهای try در انتظار) را به خاطر می‌سپارد. هنگامی که *پیمایش‌گر تولیدگر* ادامه‌ی اجرا می‌دهد، از همان نقطه‌ای که متوقف شده بود ادامه می‌دهد (برخلاف توابع که در هر فراخوانی از ابتدا شروع می‌شوند)."

msgid "Generator iterators also implement the :meth:`~generator.send` method to send a value into the suspended generator, and the :meth:`~generator.throw` method to raise an exception at the point where the generator was paused. See :ref:`generator-methods`."

msgstr "پیمایش‌گرهای تولیدگر همچنین متد :meth:`~generator.send` را برای ارسال یک مقدار به تولیدگر متوقف‌شده و متد :meth:`~generator.throw` را برای پرتاب یک استثنا در نقطه‌ای که تولیدگر در آن متوقف شده است، پیاده‌سازی می‌کنند. بخش :ref:`generator-methods` را ببینید."

msgid "generator expression"

msgstr "عبارت تولیدگر"

msgid "An :term:`expression` that returns an :term:`iterator`. It looks like a normal expression followed by a :keyword:`!for` clause defining a loop variable, range, and an optional :keyword:`!if` clause. The combined expression generates values for an enclosing function::"

msgstr "یک :term:`عبارت <expression>` که یک :term:`پیمایش‌گر <iterator>` بازمی‌گرداند. این عبارت شبیه یک عبارت معمولی است که پس از آن یک بند :keyword:`!for` برای تعریف متغیر حلقه، محدوده و یک بند اختیاری :keyword:`!if` قرار گرفته است. عبارت ترکیبی، مقادیری را برای یک تابع دربرگیرنده تولید می‌کند::"

msgid ""

msgstr ""

msgid "generic function"

msgstr "تابع عام"

msgid "A function composed of multiple functions implementing the same operation for different types. Which implementation should be used during a call is determined by the dispatch algorithm."

msgstr "تابعی که از چندین تابع تشکیل شده است که یک عملیات یکسان را برای نوع‌های مختلف پیاده‌سازی می‌کنند. این‌که هنگام یک فراخوانی کدام پیاده‌سازی استفاده شود، توسط الگوریتم ارسال تعیین می‌شود."

msgid "See also the :term:`single dispatch` glossary entry, the :deco:`functools.singledispatch` decorator, and :pep:`443`."

msgstr "همچنین به ورودی واژه‌نامه‌ای :term:`توزیع تک‌گانه <single dispatch>`، دکوراتور :deco:`functools.singledispatch` و :pep:`443` مراجعه کنید."

msgid "generic type"

msgstr "نوع عام"

msgid "A :term:`type` that can be parameterized; typically a :ref:`container class<sequence-types>` such as :class:`list` or :class:`dict`. Used for :term:`type hints <type hint>` and :term:`annotations <annotation>`."

msgstr "یک :term:`نوع <type>` که می‌تواند پارامتری شود؛ معمولاً یک :ref:`container class<sequence-types>` مانند :class:`list` یا :class:`dict`. برای :term:`راهنمای نوع <type hint>` و :term:`حاشیه‌گذاری <annotation>` استفاده می‌شود."

msgid "For more details, see :ref:`generic alias types<types-genericalias>`, :pep:`483`, :pep:`484`, :pep:`585`, and the :mod:`typing` module."

msgstr "برای جزئیات بیشتر، :ref:`generic alias types<types-genericalias>`، :pep:`483`، :pep:`484`، :pep:`585` و ماژول :mod:`typing` را ببینید."

msgid "GIL"

msgstr "GIL"

msgid "See :term:`global interpreter lock`."

msgstr ":term:`قفل مفسر سراسری <global interpreter lock>` را ببینید."

msgid "global interpreter lock"

msgstr "قفل مفسر سراسری"

msgid "The mechanism used by the :term:`CPython` interpreter to assure that only one thread executes Python :term:`bytecode` at a time. This simplifies the CPython implementation by making the object model (including critical built-in types such as :class:`dict`) implicitly safe against concurrent access. Locking the entire interpreter makes it easier for the interpreter to be multi-threaded, at the expense of much of the parallelism afforded by multi-processor machines."

msgstr "سازوکاری که توسط مفسر :term:`CPython <CPython>` استفاده می‌شود تا تضمین کند در هر زمان فقط یک نخ :term:`بایت‌کد <bytecode>` پایتون را اجرا می‌کند. این کار پیاده‌سازی CPython را ساده‌تر می‌کند، زیرا مدل شیء (شامل نوع‌های توکار مهمی مانند :class:`dict`) به‌طور ضمنی در برابر دسترسی همزمان ایمن می‌شود. قفل کردن کل مفسر باعث می‌شود چندنخی کردن مفسر آسان‌تر شود، اما به قیمت از دست دادن بخش زیادی از موازی‌سازی‌ای که ماشین‌های چندپردازنده‌ای فراهم می‌کنند."

msgid "However, some extension modules, either standard or third-party, are designed so as to release the GIL when doing computationally intensive tasks such as compression or hashing. Also, the GIL is always released when doing I/O."

msgstr "با این حال، برخی ماژول‌های توسعه‌ای، چه استاندارد و چه شخص ثالث، به‌گونه‌ای طراحی شده‌اند که هنگام انجام وظایف محاسباتی سنگین مانند فشرده‌سازی یا درهم‌سازی، GIL را آزاد کنند. همچنین، GIL همیشه هنگام انجام عملیات ورودی/خروجی آزاد می‌شود."

msgid "As of Python 3.13, the GIL can be disabled using the :option:`--disable-gil` build configuration. After building Python with this option, code must be run with :option:`-X gil=0 <-X>` or after setting the :envvar:`PYTHON_GIL=0 <PYTHON_GIL>` environment variable. This feature enables improved performance for multi-threaded applications and makes it easier to use multi-core CPUs efficiently. For more details, see :pep:`703`."

msgstr "از پایتون ۳.۱۳، می‌توان GIL را با استفاده از پیکربندی ساخت :option:`--disable-gil` غیرفعال کرد. پس از ساخت پایتون با این گزینه، کد باید با :option:`-X gil=0 <-X>` یا پس از تنظیم متغیر محیطی :envvar:`PYTHON_GIL=0 <PYTHON_GIL>` اجرا شود. این ویژگی عملکرد بهتر برای برنامه‌های چندنخی را فراهم می‌کند و استفاده‌ی مؤثرتر از CPUهای چندهسته‌ای را آسان‌تر می‌سازد. برای جزئیات بیشتر، :pep:`703` را ببینید."

msgid "In prior versions of Python's C API, a function might declare that it requires the GIL to be held in order to use it. This refers to having an :term:`attached thread state`."

msgstr "در نسخه‌های پیشین API زبان C پایتون، یک تابع ممکن بود اعلام کند که برای استفاده از آن، لازم است GIL در اختیار گرفته شده باشد. این موضوع به داشتن یک :term:`وضعیت نخ متصل <attached thread state>` اشاره دارد."

msgid "global state"

msgstr "وضعیت سراسری"

msgid "Data that is accessible throughout a program, such as module-level variables, class variables, or C static variables in :term:`extension modules <extension module>`. In multi-threaded programs, global state shared between threads typically requires synchronization to avoid :term:`race conditions <race condition>` and :term:`data races <data race>`."

msgstr "داده‌ای که در سراسر یک برنامه قابل دسترسی است، مانند متغیرهای سطح ماژول، متغیرهای کلاس یا متغیرهای ایستای C در :term:`ماژول توسعه‌ای <extension module>`. در برنامه‌های چندنخی، وضعیت سراسری اشتراک‌گذاری‌شده بین نخ‌ها معمولاً برای جلوگیری از :term:`شرط رقابت <race condition>` و :term:`رقابت داده <data race>` به همگام‌سازی نیاز دارد."

msgid "hash-based pyc"

msgstr "pyc مبتنی بر هش"

msgid "A bytecode cache file that uses the hash rather than the last-modified time of the corresponding source file to determine its validity. See :ref:`pyc-invalidation`."

msgstr "یک پرونده نهانگاه بایت‌کد که به‌جای زمان آخرین تغییر پرونده منبع متناظر، از هش آن برای تعیین اعتبار خود استفاده می‌کند. :ref:`pyc-invalidation` را ببینید."

msgid "hashable"

msgstr "قابل درهم‌سازی"

msgid "An object is *hashable* if it has a hash value which never changes during its lifetime (it needs a :meth:`~object.__hash__` method), and can be compared to other objects (it needs an :meth:`~object.__eq__` method). Hashable objects which compare equal must have the same hash value."

msgstr "یک شیء *قابل درهم‌سازی* است اگر دارای یک مقدار هش باشد که در طول عمر آن هرگز تغییر نمی‌کند (به یک متد :meth:`~object.__hash__` نیاز دارد) و بتوان آن را با اشیای دیگر مقایسه کرد (به یک متد :meth:`~object.__eq__` نیاز دارد). اشیای قابل درهم‌سازی که برابر مقایسه می‌شوند باید مقدار هش یکسانی داشته باشند."

msgid "Hashability makes an object usable as a dictionary key and a set member, because these data structures use the hash value internally."

msgstr "قابل درهم‌سازی بودن باعث می‌شود یک شیء به‌عنوان کلید دیکشنری و عضو مجموعه قابل استفاده باشد، زیرا این ساختارهای داده مقدار هش را به‌صورت داخلی استفاده می‌کنند."

msgid "Most of Python's immutable built-in objects are hashable; mutable containers (such as lists or dictionaries) are not; immutable containers (such as tuples and frozensets) are only hashable if their elements are hashable. Objects which are instances of user-defined classes are hashable by default. They all compare unequal (except with themselves), and their hash value is derived from their :func:`id`."

msgstr "بیشتر اشیای توکار تغییرناپذیر پایتون قابل درهم‌سازی هستند؛ محفظه‌های تغییرپذیر (مانند فهرست‌ها یا دیکشنری‌ها) قابل درهم‌سازی نیستند؛ محفظه‌های تغییرناپذیر (مانند تاپل‌ها یا frozensetها) فقط در صورتی قابل درهم‌سازی هستند که عناصرشان قابل درهم‌سازی باشند. اشیایی که نمونه‌هایی از کلاس‌های تعریف‌شده توسط کاربر هستند، به‌طور پیش‌فرض قابل درهم‌سازی هستند. همه‌ی آن‌ها نابرابر مقایسه می‌شوند (به‌جز با خودشان) و مقدار هش آن‌ها از :func:`id` آن‌ها مشتق می‌شود."

msgid "IDLE"

msgstr "IDLE"

msgid "An Integrated Development and Learning Environment for Python. :ref:`idle` is a basic editor and interpreter environment which ships with the standard distribution of Python."

msgstr "یک محیط توسعه و یادگیری یکپارچه برای پایتون. :ref:`idle` یک محیط ویرایشگر و مفسر پایه است که همراه با توزیع استاندارد پایتون ارائه می‌شود."

msgid "immortal"

msgstr "نامیرا"

msgid "*Immortal objects* are a CPython implementation detail introduced in :pep:`683`."

msgstr "*اشیای نامیرا* یک جزئیات پیاده‌سازی CPython هستند که در :pep:`683` معرفی شده‌اند."

msgid "If an object is immortal, its :term:`reference count` is never modified, and therefore it is never deallocated while the interpreter is running. For example, :const:`True` and :const:`None` are immortal in CPython."

msgstr "اگر یک شیء نامیرا باشد، :term:`شمارنده‌ی ارجاع <reference count>` آن هرگز تغییر نمی‌کند و بنابراین تا زمانی که مفسر در حال اجرا است، هرگز آزاد نمی‌شود. برای مثال، :const:`True` و :const:`None` در CPython نامیرا هستند."

msgid "Immortal objects can be identified via :func:`sys._is_immortal`, or via :c:func:`PyUnstable_IsImmortal` in the C API."

msgstr "اشیای نامیرا را می‌توان از طریق :func:`sys._is_immortal` یا از طریق :c:func:`PyUnstable_IsImmortal` در API زبان C شناسایی کرد."

msgid "immutable"

msgstr "تغییرناپذیر"

msgid "An object with a fixed value. Immutable objects include numbers, strings and tuples. Such an object cannot be altered. A new object has to be created if a different value has to be stored. They play an important role in places where a constant hash value is needed, for example as a key in a dictionary. Immutable objects are inherently :term:`thread-safe` because their state cannot be modified after creation, eliminating concerns about improperly synchronized :term:`concurrent modification`."

msgstr "شیءای با مقدار ثابت. اشیای تغییرناپذیر شامل اعداد، نخ‌ها و تاپل‌ها هستند. چنین شی‌ءای نمی‌تواند تغییر داده شود. اگر لازم باشد مقدار متفاوتی ذخیره شود، باید شیء جدیدی ایجاد شود. آن‌ها در جاهایی که مقدار هش ثابت لازم است، برای مثال به‌عنوان یک کلید در یک دیکشنری، نقش مهمی دارند. اشیای تغییرناپذیر ذاتاً :term:`ایمن برای نخ‌های اجرایی <thread-safe>` هستند، زیرا وضعیت آن‌ها پس از ایجاد قابل تغییر نیست و نگرانی‌ها درباره‌ی :term:`تغییر همزمان <concurrent modification>` که به‌درستی همگام‌سازی نشده است، از بین می‌رود."

msgid "import path"

msgstr "مسیر ایمپورت"

msgid "A list of locations (or :term:`path entries <path entry>`) that are searched by the :term:`path based finder` for modules to import. During import, this list of locations usually comes from :data:`sys.path`, but for subpackages it may also come from the parent package's ``__path__`` attribute."

msgstr "فهرستی از مکان‌ها (یا :term:`ورودی مسیر <path entry>`) که توسط :term:`یابنده‌ی مبتنی بر مسیر <path based finder>` برای ماژول‌های قابل ایمپورت جست‌وجو می‌شود. هنگام ایمپورت، این فهرست از مکان‌ها معمولاً از :data:`sys.path` می‌آید، اما برای زیربسته‌ها ممکن است از ویژگی ``__path__`` بسته‌ی والد نیز به‌دست آید."

msgid "importing"

msgstr "ایمپورت کردن"

msgid "The process by which Python code in one module is made available to Python code in another module."

msgstr "فرایندی که طی آن کد پایتون در یک ماژول برای کد پایتون در ماژولی دیگر در دسترس قرار می‌گیرد."

msgid "importer"

msgstr "ایمپورت‌کننده"

msgid "An object that both finds and loads a module; both a :term:`finder` and :term:`loader` object."

msgstr "شی‌ءای که هم یک ماژول را پیدا می‌کند و هم آن را بارگذاری می‌کند؛ هم یک شیء :term:`یابنده <finder>` و هم یک شیء :term:`بارگذار <loader>`."

msgid "index"

msgstr "اندیس"

msgid "A numeric value that represents the position of an element in a :term:`sequence`."

msgstr "مقداری عددی که موقعیت یک المان را در یک :term:`دنباله <sequence>` نشان می‌دهد."

msgid "In Python, indexing starts at zero. For example, ``things[0]`` names the *first* element of ``things``; ``things[1]`` names the second one."

msgstr "در پایتون، اندیس‌گذاری از صفر شروع می‌شود. برای مثال، ``things[0]`` نخستین المان ``things`` را نام‌گذاری می‌کند؛ ``things[1]`` دومین مورد را نام‌گذاری می‌کند."

msgid "In some contexts, Python allows negative indexes for counting from the end of a sequence, and indexing using :term:`slices <slice>`."

msgstr "در برخی زمینه‌ها، پایتون اجازه می‌دهد از اندیس‌های منفی برای شمارش از انتهای یک دنباله و از اندیس‌گذاری با استفاده از :term:`برش <slice>` استفاده شود."

msgid "See also :term:`subscript`."

msgstr "همچنین :term:`زیرنویس <subscript>` را ببینید."

msgid "interactive"

msgstr "تعاملی"

msgid "Python has an interactive interpreter which means you can enter statements and expressions at the interpreter prompt, immediately execute them and see their results. Just launch ``python`` with no arguments (possibly by selecting it from your computer's main menu). It is a very powerful way to test out new ideas or inspect modules and packages (remember ``help(x)``). For more on interactive mode, see :ref:`tut-interac`."

msgstr "پایتون یک مفسر تعاملی دارد، یعنی می‌توانید دستورها و عبارت‌ها را در اعلان مفسر وارد کنید، آن‌ها را بلافاصله اجرا کنید و نتایجشان را ببینید. فقط ``python`` را بدون آرگومان اجرا کنید (احتمالاً با انتخاب آن از منوی اصلی رایانه‌ی خود). این روش بسیار قدرتمندی برای آزمایش ایده‌های جدید یا بررسی ماژول‌ها و بسته‌ها است (``help(x)`` را به خاطر داشته باشید). برای اطلاعات بیشتر درباره‌ی حالت تعاملی، :ref:`tut-interac` را ببینید."

msgid "interpreted"

msgstr "تفسیری"

msgid "Python is an interpreted language, as opposed to a compiled one, though the distinction can be blurry because of the presence of the bytecode compiler. This means that source files can be run directly without explicitly creating an executable which is then run. Interpreted languages typically have a shorter development/debug cycle than compiled ones, though their programs generally also run more slowly. See also :term:`interactive`."

msgstr "پایتون زبانی تفسیری است، در مقابل زبان‌های کامپایل‌شده، هرچند به‌دلیل وجود کامپایلر بایت‌کد، این تمایز می‌تواند مبهم باشد. این یعنی پرونده‌های منبع را می‌توان بدون ایجاد صریح یک پرونده اجرایی که سپس اجرا شود، مستقیماً اجرا کرد. زبان‌های تفسیری معمولاً چرخه‌ی توسعه/اشکال‌زدایی کوتاه‌تری نسبت به زبان‌های کامپایل‌شده دارند، هرچند برنامه‌های آن‌ها معمولاً کندتر اجرا می‌شوند. همچنین :term:`تعاملی <interactive>` را ببینید."

msgid "interpreter shutdown"

msgstr "خاموشی مفسر"

msgid "When asked to shut down, the Python interpreter enters a special phase where it gradually releases all allocated resources, such as modules and various critical internal structures. It also makes several calls to the :term:`garbage collector <garbage collection>`. This can trigger the execution of code in user-defined destructors or weakref callbacks. Code executed during the shutdown phase can encounter various exceptions as the resources it relies on may not function anymore (common examples are library modules or the warnings machinery)."

msgstr "هنگامی که از مفسر پایتون خواسته می‌شود خاموش شود، وارد مرحله‌ی ویژه‌ای می‌شود که در آن به‌تدریج همه‌ی منابع تخصیص‌یافته، مانند ماژول‌ها و ساختارهای داخلی مهم مختلف، آزاد می‌شوند. همچنین چندین فراخوانی به :term:`زباله‌روبی <garbage collection>` انجام می‌دهد. این کار می‌تواند اجرای کد در نابودگرهای تعریف‌شده توسط کاربر یا کال‌بک‌های weakref را فعال کند. کدی که در مرحله‌ی خاموشی اجرا می‌شود ممکن است با استثناهای مختلفی روبه‌رو شود، زیرا منابعی که به آن‌ها وابسته است ممکن است دیگر کار نکنند (نمونه‌های رایج شامل ماژول‌های کتابخانه یا سازوکار هشدارها هستند)."

msgid "The main reason for interpreter shutdown is that the ``__main__`` module or the script being run has finished executing."

msgstr "دلیل اصلی خاموشی مفسر این است که ماژول ``__main__`` یا اسکریپتی که در حال اجرا است، اجرای خود را به پایان رسانده است."

msgid "iterable"

msgstr "پیمایش‌پذیر"

msgid "An object capable of returning its members one at a time. Examples of iterables include all sequence types (such as :class:`list`, :class:`str`, and :class:`tuple`) and some non-sequence types like :class:`dict`, :term:`file objects <file object>`, and objects of any classes you define with an :meth:`~object.__iter__` method or with a :meth:`~object.__getitem__` method that implements :term:`sequence` semantics."

msgstr "شیءای که قادر است اعضای خود را یکی‌یکی بازگرداند. نمونه‌هایی از پیمایش‌پذیرها شامل همه‌ی نوع‌های دنباله‌ای (مانند :class:`list`، :class:`str` و :class:`tuple`) و برخی نوع‌های غیرتوالی مانند :class:`dict`، :term:`شیء پرونده <file object>` و اشیای هر کلاسی که شما با متد :meth:`~object.__iter__` یا با متد :meth:`~object.__getitem__` که معناشناسی :term:`دنباله <sequence>` را پیاده‌سازی می‌کند تعریف می‌کنید، هستند."

msgid "Iterables can be used in a :keyword:`for` loop and in many other places where a sequence is needed (:func:`zip`, :func:`map`, ...). When an iterable object is passed as an argument to the built-in function :func:`iter`, it returns an iterator for the object. This iterator is good for one pass over the set of values. When using iterables, it is usually not necessary to call :func:`iter` or deal with iterator objects yourself. The :keyword:`for` statement does that automatically for you, creating a temporary unnamed variable to hold the iterator for the duration of the loop. See also :term:`iterator`, :term:`sequence`, and :term:`generator`."

msgstr "پیمایش‌پذیرها را می‌توان در یک حلقه‌ی :keyword:`for` و در بسیاری از مکان‌های دیگری که یک دنباله لازم است (:func:`zip`، :func:`map` و ...) استفاده کرد. هنگامی که یک شیء پیمایش‌پذیر به‌عنوان آرگومان به تابع توکار :func:`iter` داده می‌شود، یک پیمایش‌گر برای آن شیء بازمی‌گرداند. این پیمایش‌گر برای یک بار پیمایش مجموعه‌ی مقادیر مناسب است. هنگام استفاده از پیمایش‌پذیرها، معمولاً لازم نیست خودتان :func:`iter` را فراخوانی کنید یا با اشیای پیمایش‌گر سروکار داشته باشید. دستور :keyword:`for` این کار را به‌طور خودکار برای شما انجام می‌دهد و یک متغیر موقتِ بدون نام ایجاد می‌کند تا در طول حلقه پیمایش‌گر را نگه دارد. همچنین :term:`پیمایش‌گر <iterator>`، :term:`دنباله <sequence>` و :term:`تولیدگر <generator>` را ببینید."

msgid "iterator"

msgstr "پیمایش‌گر"

msgid "An object representing a stream of data. Repeated calls to the iterator's :meth:`~iterator.__next__` method (or passing it to the built-in function :func:`next`) return successive items in the stream. When no more data are available a :exc:`StopIteration` exception is raised instead. At this point, the iterator object is :term:`exhausted` and any further calls to its :meth:`!__next__` method just raise :exc:`StopIteration` again. Iterators are required to have an :meth:`~iterator.__iter__` method that returns the iterator object itself so every iterator is also iterable and may be used in most places where other iterables are accepted. One notable exception is code which attempts multiple iteration passes. A container object (such as a :class:`list`) produces a fresh new iterator each time you pass it to the :func:`iter` function or use it in a :keyword:`for` loop. Attempting this with an iterator will just return the same exhausted iterator object used in the previous iteration pass, making it appear like an empty container."

msgstr "یک شیء که نمایانگر جریان داده است. فراخوانی‌های مکرر به متد :meth:`~iterator.__next__` پیمایش‌گر (یا پاس دادن آن به تابع توکار :func:`next`) آیتم‌های متوالی در جریان را برمی‌گردانند. وقتی داده بیشتری در دسترس نیست، به جای آن استثنای :exc:`StopIteration` پرتاب می‌شود. در این نقطه، شیء پیمایش‌گر :term:`خالی‌شده <exhausted>` است و هر فراخوانی بیشتر به متد :meth:`!__next__` آن فقط دوباره :exc:`StopIteration` را پرتاب می‌کند. پیمایش‌گرها باید متد :meth:`~iterator.__iter__` داشته باشند که خود شیء پیمایش‌گر را برمی‌گرداند، بنابراین هر پیمایش‌گر همچنین پیمایش‌پذیر است و می‌تواند در اکثر مکان‌هایی که پیمایش‌پذیرهای دیگر پذیرفته می‌شوند، استفاده شود. یک استثنای قابل توجه کدی است که تلاش می‌کند چندین گذر پیمایش انجام دهد. یک شیء ظرف (مانند :class:`list`) هر بار که آن را به تابع :func:`iter` پاس دهید یا در یک حلقه :keyword:`for` از آن استفاده کنید، یک پیمایش‌گر تازه و جدید تولید می‌کند. تلاش برای این کار با یک پیمایش‌گر فقط همان شیء پیمایش‌گر خالی‌شده‌ی استفاده شده در گذر قبلی پیمایش را برمی‌گرداند، که باعث می‌شود مانند یک ظرف خالی به نظر برسد."

msgid "More information can be found in :ref:`typeiter`."

msgstr "اطلاعات بیشتر را می‌توان در :ref:`typeiter` یافت."

msgid "CPython does not consistently apply the requirement that an iterator define :meth:`~iterator.__iter__`. And also please note that :term:`free-threaded <free threading>` CPython does not guarantee :term:`thread-safe` behavior of iterator operations."

msgstr "CPython به‌طور سازگار الزام تعریف متد :meth:`~iterator.__iter__` برای یک پیمایش‌گر را اعمال نمی‌کند. همچنین توجه داشته باشید که CPython :term:`نخ‌گذاری آزاد <free threading>` رفتار :term:`ایمن برای نخ‌های اجرایی <thread-safe>` را برای عملیات پیمایش‌گرها تضمین نمی‌کند."

msgid "key"

msgstr "کلید"

msgid "A value that identifies an entry in a :term:`mapping`. See also :term:`subscript`."

msgstr "مقداری که یک ورودی را در یک :term:`نگاشت <mapping>` شناسایی می‌کند. همچنین :term:`زیرنویس <subscript>` را ببینید."

msgid "key function"

msgstr "تابع کلید"

msgid "A key function or collation function is a callable that returns a value used for sorting or ordering. For example, :func:`locale.strxfrm` is used to produce a sort key that is aware of locale specific sort conventions."

msgstr "یک تابع کلید یا تابع هم‌ترازی، یک شیء فراخوانی‌پذیر است که مقداری را بازمی‌گرداند که برای مرتب‌سازی یا ترتیب‌دهی استفاده می‌شود. برای مثال، :func:`locale.strxfrm` برای تولید یک کلید مرتب‌سازی که از قراردادهای مرتب‌سازی خاص یک locale آگاه است استفاده می‌شود."

msgid "A number of tools in Python accept key functions to control how elements are ordered or grouped. They include :func:`min`, :func:`max`, :func:`sorted`, :meth:`list.sort`, :func:`heapq.merge`, :func:`heapq.nsmallest`, :func:`heapq.nlargest`, and :func:`itertools.groupby`."

msgstr "تعدادی از ابزارهای پایتون، توابع کلید را برای کنترل نحوه‌ی ترتیب‌دهی یا گروه‌بندی المان‌ها می‌پذیرند. این ابزارها شامل :func:`min`، :func:`max`، :func:`sorted`، :meth:`list.sort`، :func:`heapq.merge`، :func:`heapq.nsmallest`، :func:`heapq.nlargest` و :func:`itertools.groupby` هستند."

msgid "There are several ways to create a key function. For example. the :meth:`str.casefold` method can serve as a key function for case insensitive sorts. Alternatively, a key function can be built from a :keyword:`lambda` expression such as ``lambda r: (r[0], r[2])``. Also, :func:`operator.attrgetter`, :func:`operator.itemgetter`, and :func:`operator.methodcaller` are three key function constructors. See the :ref:`Sorting HOW TO <sortinghowto>` for examples of how to create and use key functions."

msgstr "چندین روش برای ایجاد یک تابع کلید وجود دارد. برای مثال، متد :meth:`str.casefold` می‌تواند به‌عنوان یک تابع کلید برای مرتب‌سازی‌های بدون حساسیت به بزرگی و کوچکی حروف استفاده شود. همچنین، یک تابع کلید می‌تواند از یک عبارت :keyword:`lambda` مانند ``lambda r: (r[0], r[2])`` ساخته شود. علاوه بر این، :func:`operator.attrgetter`، :func:`operator.itemgetter` و :func:`operator.methodcaller` سه سازنده‌ی تابع کلید هستند. برای نمونه‌هایی از نحوه‌ی ایجاد و استفاده از توابع کلید، :ref:`Sorting HOW TO <sortinghowto>` را ببینید."

msgid "keyword argument"

msgstr "آرگومان کلیدواژه‌ای"

msgid "See :term:`argument`."

msgstr ":term:`آرگومان <argument>` را ببینید."

msgid "lambda"

msgstr "lambda"

msgid "An anonymous inline function consisting of a single :term:`expression` which is evaluated when the function is called. The syntax to create a lambda function is ``lambda [parameters]: expression``"

msgstr "یک تابع درون‌خطی بی‌نام که از یک :term:`عبارت <expression>` واحد تشکیل شده است و هنگام فراخوانی تابع ارزیابی می‌شود. سینتکس ایجاد یک تابع lambda به‌صورت ``lambda [parameters]: expression`` است"

msgid "LBYL"

msgstr "LBYL"

msgid "Look before you leap. This coding style explicitly tests for pre-conditions before making calls or lookups. This style contrasts with the :term:`EAFP` approach and is characterized by the presence of many :keyword:`if` statements."

msgstr "پیش از جهش نگاه کنید (Look Before You Leap). این سبک کدنویسی پیش‌شرط‌ها را پیش از انجام فراخوانی‌ها یا جست‌وجوها به‌طور صریح آزمایش می‌کند. این سبک در تضاد با رویکرد :term:`EAFP <EAFP>` است و با وجود تعداد زیادی دستور :keyword:`if` شناخته می‌شود."

msgid "In a multi-threaded environment, the LBYL approach can risk introducing a :term:`race condition` between \"the looking\" and \"the leaping\". For example, the code, ``if key in mapping: return mapping[key]`` can fail if another thread removes *key* from *mapping* after the test, but before the lookup. This issue can be solved with :term:`locks <lock>` or by using the :term:`EAFP` approach. See also :term:`thread-safe`."

msgstr "در یک محیط چندنخی، رویکرد LBYL می‌تواند خطر ایجاد یک :term:`شرط رقابت <race condition>` بین «نگاه کردن» و «جهش کردن» را به همراه داشته باشد. برای مثال، کد ``if key in mapping: return mapping[key]`` ممکن است شکست بخورد اگر نخ‌ای دیگر پس از آزمون، اما پیش از جست‌وجو، *key* را از *mapping* حذف کند. این مشکل را می‌توان با :term:`قفل <lock>` یا با استفاده از رویکرد :term:`EAFP <EAFP>` حل کرد. همچنین :term:`ایمن برای نخ‌های اجرایی <thread-safe>` را ببینید."

msgid "lexical analyzer"

msgstr "تحلیلگر واژگانی"

msgid "Formal name for the *tokenizer*; see :term:`token`."

msgstr "نام رسمی برای *tokenizer*؛ :term:`توکن <token>` را ببینید."

msgid "list"

msgstr "فهرست"

msgid "A built-in Python :term:`sequence`. Despite its name it is more akin to an array in other languages than to a linked list since access to elements is *O*\\ (1). See :ref:`time-complexity`."

msgstr "یک :term:`دنباله <sequence>` درون‌ساخته‌ی پایتون است. با وجود نامِ آن، این بیشتر شبیه به یک آرایه در سایر زبان‌هاست تا به یک فهرست پیوندی، چون دسترسی به المان‌ها *O*\\ (1) است. ببینید :ref:`time-complexity`."

msgid "list comprehension"

msgstr "درک فهرستی"

msgid "A compact way to process all or part of the elements in a sequence and return a list with the results. ``result = ['{:#04x}'.format(x) for x in range(256) if x % 2 == 0]`` generates a list of strings containing even hex numbers (0x..) in the range from 0 to 255. The :keyword:`if` clause is optional. If omitted, all elements in ``range(256)`` are processed."

msgstr "روشی فشرده برای پردازش همه یا بخشی از المان‌های یک دنباله و بازگرداندن یک فهرست با نتایج. ``result = ['{:#04x}'.format(x) for x in range(256) if x % 2 == 0]`` فهرستی از نخ‌ها شامل اعداد مبنای شانزده زوج (0x..) در محدوده‌ی ۰ تا ۲۵۵ تولید می‌کند. بند :keyword:`if` اختیاری است. اگر حذف شود، همه‌ی المان‌های ``range(256)`` پردازش می‌شوند."

msgid "lock"

msgstr "قفل"

msgid "A :term:`synchronization primitive` that allows only one thread at a time to access a shared resource. A thread must acquire a lock before accessing the protected resource and release it afterward. If a thread attempts to acquire a lock that is already held by another thread, it will block until the lock becomes available. Python's :mod:`threading` module provides :class:`~threading.Lock` (a basic lock) and :class:`~threading.RLock` (a :term:`reentrant` lock). Locks are used to prevent :term:`race conditions <race condition>` and ensure :term:`thread-safe` access to shared data. Alternative design patterns to locks exist such as queues, producer/consumer patterns, and thread-local state. See also :term:`deadlock`, and :term:`reentrant`."

msgstr "یک :term:`اولیه همگام‌سازی <synchronization primitive>` که در هر زمان فقط به یک نخ اجازه‌ی دسترسی به یک منبع اشتراکی را می‌دهد. یک نخ باید پیش از دسترسی به منبع محافظت‌شده، یک قفل را به‌دست آورد و پس از آن آن را آزاد کند. اگر یک نخ تلاش کند قفلی را به‌دست آورد که پیش‌تر توسط نخ‌ای دیگر در اختیار گرفته شده است، تا زمانی که قفل در دسترس قرار گیرد مسدود می‌شود. ماژول :mod:`threading` پایتون، :class:`~threading.Lock` (یک قفل پایه) و :class:`~threading.RLock` (یک قفل :term:`بازورودپذیر <reentrant>`) را فراهم می‌کند. قفل‌ها برای جلوگیری از :term:`شرط رقابت <race condition>` و تضمین دسترسی :term:`ایمن برای نخ‌های اجرایی <thread-safe>` به داده‌های اشتراکی استفاده می‌شوند. الگوهای طراحی جایگزین برای قفل‌ها وجود دارند، مانند صف‌ها، الگوهای تولیدکننده/مصرف‌کننده و وضعیت محلی نخ. همچنین :term:`بن‌بست <deadlock>` و :term:`بازورودپذیر <reentrant>` را ببینید."

msgid "lock-free"

msgstr "بدون قفل"

msgid "An operation that does not acquire any :term:`lock` and uses atomic CPU instructions to ensure correctness. Lock-free operations can execute concurrently without blocking each other and cannot be blocked by operations that hold locks. In :term:`free-threaded <free threading>` Python, built-in types like :class:`dict` and :class:`list` provide lock-free read operations, which means other threads may observe intermediate states during multi-step modifications even when those modifications hold the :term:`per-object lock`."

msgstr "عملیاتی که هیچ :term:`قفل <lock>`\\ ای به‌دست نمی‌آورد و برای تضمین درستی از دستورهای اتمی CPU استفاده می‌کند. عملیات‌های بدون قفل می‌توانند به‌طور همزمان و بدون مسدود کردن یکدیگر اجرا شوند و نمی‌توانند توسط عملیات‌هایی که قفل‌ها را در اختیار دارند مسدود شوند. در پایتون :term:`نخ‌گذاری آزاد <free threading>`، نوع‌های توکار مانند :class:`dict` و :class:`list` عملیات‌های خواندن بدون قفل ارائه می‌کنند، یعنی نخ‌های دیگر ممکن است در طول تغییرات چندمرحله‌ای، حتی زمانی که آن تغییرات :term:`قفلِ هر شیء <per-object lock>` را نگه داشته‌اند، وضعیت‌های میانی را مشاهده کنند."

msgid "loader"

msgstr "بارگذار"

msgid "An object that loads a module. It must define the :meth:`!exec_module` and :meth:`!create_module` methods to implement the :class:`~importlib.abc.Loader` interface. A loader is typically returned by a :term:`finder`. See also:"

msgstr "شیءای که یک ماژول را بارگذاری می‌کند. برای پیاده‌سازی رابط :class:`~importlib.abc.Loader` باید متدهای :meth:`!exec_module` و :meth:`!create_module` را تعریف کند. یک بارگذار معمولاً توسط یک :term:`یابنده <finder>` بازگردانده می‌شود. همچنین ببینید:"

msgid ":ref:`finders-and-loaders`"

msgstr ":ref:`finders-and-loaders`"

msgid ":class:`importlib.abc.Loader`"

msgstr ":class:`importlib.abc.Loader`"

msgid ":pep:`302`"

msgstr ":pep:`302`"

msgid "locale encoding"

msgstr "کدگذاری locale"

msgid "On Unix, it is the encoding of the LC_CTYPE locale. It can be set with :func:`locale.setlocale(locale.LC_CTYPE, new_locale) <locale.setlocale>`."

msgstr "در یونیکس، این همان کدگذاری locale LC_CTYPE است. می‌توان آن را با :func:`locale.setlocale(locale.LC_CTYPE, new_locale) <locale.setlocale>` تنظیم کرد."

msgid "On Windows, it is the ANSI code page (ex: ``\"cp1252\"``)."

msgstr "در ویندوز، این همان صفحه‌ی کد ANSI است (برای مثال ``\"cp1252\"``)."

msgid "On Android and VxWorks, Python uses ``\"utf-8\"`` as the locale encoding."

msgstr "در Android و VxWorks، پایتون از ``\"utf-8\"`` به‌عنوان کدگذاری locale استفاده می‌کند."

msgid ":func:`locale.getencoding` can be used to get the locale encoding."

msgstr "از :func:`locale.getencoding` می‌توان برای دریافت کدگذاری locale استفاده کرد."

msgid "See also the :term:`filesystem encoding and error handler`."

msgstr "همچنین :term:`کدگذاری سیستم پرونده و هندلر خطا <filesystem encoding and error handler>` را ببینید."

msgid "magic method"

msgstr "متد جادویی"

msgid "An informal synonym for :term:`special method`."

msgstr "یک مترادف غیررسمی برای :term:`متد ویژه <special method>`."

msgid "mapping"

msgstr "نگاشت"

msgid "A container object that supports arbitrary key lookups and implements the methods specified in the :class:`collections.abc.Mapping` or :class:`collections.abc.MutableMapping` :ref:`abstract base classes <collections-abstract-base-classes>`. Examples include :class:`dict`, :class:`collections.defaultdict`, :class:`collections.OrderedDict` and :class:`collections.Counter`."

msgstr "یک شیء ظرفی که از جست‌وجوی کلیدهای دلخواه پشتیبانی می‌کند و متدهای مشخص‌شده در :class:`collections.abc.Mapping` یا :class:`collections.abc.MutableMapping` :ref:`abstract base classes <collections-abstract-base-classes>` را پیاده‌سازی می‌کند. نمونه‌ها شامل :class:`dict`، :class:`collections.defaultdict`، :class:`collections.OrderedDict` و :class:`collections.Counter` هستند."

msgid "meta path finder"

msgstr "یابنده‌ی مسیر فراداده"

msgid "A :term:`finder` returned by a search of :data:`sys.meta_path`. Meta path finders are related to, but different from :term:`path entry finders <path entry finder>`."

msgstr "یک :term:`یابنده <finder>` که از جست‌وجوی :data:`sys.meta_path` بازگردانده می‌شود. یابنده‌های مسیر فراداده با :term:`یابنده‌ی ورودی مسیر <path entry finder>` مرتبط هستند، اما با آن‌ها تفاوت دارند."

msgid "See :class:`importlib.abc.MetaPathFinder` for the methods that meta path finders implement."

msgstr "برای متدهایی که یابنده‌های مسیر فراداده پیاده‌سازی می‌کنند، :class:`importlib.abc.MetaPathFinder` را ببینید."

msgid "metaclass"

msgstr "فراکلاس"

msgid "The class of a class. Class definitions create a class name, a class dictionary, and a list of base classes. The metaclass is responsible for taking those three arguments and creating the class. Most object oriented programming languages provide a default implementation. What makes Python special is that it is possible to create custom metaclasses. Most users never need this tool, but when the need arises, metaclasses can provide powerful, elegant solutions. They have been used for logging attribute access, adding thread-safety, tracking object creation, implementing singletons, and many other tasks."

msgstr "کلاس یک کلاس. تعریف‌های کلاس یک نام کلاس، یک دیکشنری کلاس و یک فهرست از کلاس‌های پایه ایجاد می‌کنند. فراکلاس مسئول دریافت این سه آرگومان و ایجاد کلاس است. بیشتر زبان‌های برنامه‌نویسی شیءگرا یک پیاده‌سازی پیش‌فرض ارائه می‌کنند. چیزی که پایتون را ویژه می‌کند این است که امکان ایجاد فراکلاس‌های سفارشی وجود دارد. بیشتر کاربران هرگز به این ابزار نیاز پیدا نمی‌کنند، اما هنگامی که نیاز به آن پیش بیاید، فراکلاس‌ها می‌توانند راه‌حل‌های قدرتمند و ظریفی ارائه دهند. از آن‌ها برای ثبت دسترسی به ویژگی‌ها، افزودن ایمنی نخ‌ای، پیگیری ایجاد شیء، پیاده‌سازی تک‌نمونه‌ها و بسیاری کارهای دیگر استفاده شده است."

msgid "More information can be found in :ref:`metaclasses`."

msgstr "اطلاعات بیشتر را می‌توان در :ref:`metaclasses` یافت."

msgid "method"

msgstr "متد"

msgid "A function which is defined inside a class body. If called as an attribute of an instance of that class, the method will get the instance object as its first :term:`argument` (which is usually called ``self``). See :term:`function` and :term:`nested scope`."

msgstr "تابعی که درون بدنه‌ی یک کلاس تعریف شده است. اگر به‌عنوان یک ویژگی از یک نمونه‌ی آن کلاس فراخوانی شود، متد شیء نمونه را به‌عنوان نخستین :term:`آرگومان <argument>` خود دریافت می‌کند (که معمولاً ``self`` نامیده می‌شود). :term:`تابع <function>` و :term:`محدوده‌ی تودرتو <nested scope>` را ببینید."

msgid "method resolution order"

msgstr "ترتیب حل متد"

msgid "Method Resolution Order is the order in which base classes are searched for a member during lookup. See :ref:`python_2.3_mro` for details of the algorithm used by the Python interpreter since the 2.3 release."

msgstr "ترتیب حل متد، ترتیبی است که در آن کلاس‌های پایه هنگام جست‌وجوی یک عضو بررسی می‌شوند. برای جزئیات الگوریتمی که مفسر پایتون از انتشار ۲.۳ به بعد استفاده می‌کند، :ref:`python_2.3_mro` را ببینید."

msgid "module"

msgstr "ماژول"

msgid "An object that serves as an organizational unit of Python code. Modules have a namespace containing arbitrary Python objects. Modules are loaded into Python by the process of :term:`importing`."

msgstr "شیءای که به‌عنوان واحد سازمان‌دهی کد پایتون عمل می‌کند. ماژول‌ها یک فضای نام دارند که شامل اشیای دلخواه پایتون است. ماژول‌ها از طریق فرایند :term:`ایمپورت کردن <importing>` در پایتون بارگذاری می‌شوند."

msgid "See also :term:`package`."

msgstr "همچنین :term:`بسته <package>` را ببینید."

msgid "module spec"

msgstr "مشخصات ماژول"

msgid "A namespace containing the import-related information used to load a module. An instance of :class:`importlib.machinery.ModuleSpec`."

msgstr "فضای نامی که شامل اطلاعات مرتبط با ایمپورت است و برای بارگذاری یک ماژول استفاده می‌شود. یک نمونه از :class:`importlib.machinery.ModuleSpec`."

msgid "See also :ref:`module-specs`."

msgstr "همچنین :ref:`module-specs` را ببینید."

msgid "MRO"

msgstr "MRO"

msgid "See :term:`method resolution order`."

msgstr ":term:`ترتیب حل متد <method resolution order>` را ببینید."

msgid "mutable"

msgstr "تغییرپذیر"

msgid "An :term:`object` with state that is allowed to change during the course of the program. In multi-threaded programs, mutable objects that are shared between threads require careful synchronization to avoid :term:`race conditions <race condition>`. See also :term:`immutable`, :term:`thread-safe`, and :term:`concurrent modification`."

msgstr "یک :term:`شیء <object>` که وضعیت آن در طول اجرای برنامه اجازه‌ی تغییر دارد. در برنامه‌های چندنخی، اشیای تغییرپذیری که بین نخ‌ها اشتراک‌گذاری می‌شوند، برای جلوگیری از :term:`شرط رقابت <race condition>` به همگام‌سازی دقیق نیاز دارند. همچنین :term:`تغییرناپذیر <immutable>`، :term:`ایمن برای نخ‌های اجرایی <thread-safe>` و :term:`تغییر همزمان <concurrent modification>` را ببینید."

msgid "named tuple"

msgstr "تاپل نام‌دار"

msgid "The term \"named tuple\" applies to any type or class that inherits from tuple and whose indexable elements are also accessible using named attributes. The type or class may have other features as well."

msgstr "اصطلاح «تاپل نام‌دار» برای هر نوع یا کلاسی به‌کار می‌رود که از tuple ارث‌بری می‌کند و المان‌های قابل دسترسی با اندیس آن، با استفاده از ویژگی‌های نام‌دار نیز قابل دسترسی هستند. این نوع یا کلاس ممکن است ویژگی‌های دیگری نیز داشته باشد."

msgid "Several built-in types are named tuples, including the values returned by :func:`time.localtime` and :func:`os.stat`. Another example is :data:`sys.float_info`::"