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

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

"POT-Creation-Date: 2026-09-24 04:09+0000\n"

"PO-Revision-Date: 2026-09-24 07:55+0330\n"

"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"

"Language-Team: none\n"

"Language: fa\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"X-Generator: Poedit 3.6\n"

msgid "Built-in Functions"

msgstr "توابع توکار"

msgid "The Python interpreter has a number of functions and types built into it that are always available. They are listed here in alphabetical order."

msgstr "مفسر پایتون دارای تعدادی تابع و نوع داده است که در آن بصورت توکار (built-in) همیشه در دسترس می‌باشند. آن‌ها در اینجا به ترتیب حروف الفبا فهرست شده‌اند."

msgid "**A**"

msgstr "**A**"

msgid ":func:`abs`"

msgstr ":func:`abs`"

msgid ":func:`aiter`"

msgstr ":func:`aiter`"

msgid ":func:`all`"

msgstr ":func:`all`"

msgid ":func:`anext`"

msgstr ":func:`anext`"

msgid ":func:`any`"

msgstr ":func:`any`"

msgid ":func:`ascii`"

msgstr ":func:`ascii`"

msgid "**B**"

msgstr "**B**"

msgid ":func:`bin`"

msgstr ":func:`bin`"

msgid ":func:`bool`"

msgstr ":func:`bool`"

msgid ":func:`breakpoint`"

msgstr ":func:`breakpoint`"

msgid "|func-bytearray|_"

msgstr "|func-bytearray|_"

msgid "|func-bytes|_"

msgstr "|func-bytes|_"

msgid "**C**"

msgstr "**C**"

msgid ":func:`callable`"

msgstr ":func:`callable`"

msgid ":func:`chr`"

msgstr ":func:`chr`"

msgid ":func:`classmethod`"

msgstr ":func:`classmethod`"

msgid ":func:`compile`"

msgstr ":func:`compile`"

msgid ":func:`complex`"

msgstr ":func:`complex`"

msgid "**D**"

msgstr "**D**"

msgid ":func:`delattr`"

msgstr ":func:`delattr`"

msgid "|func-dict|_"

msgstr "|func-dict|_"

msgid ":func:`dir`"

msgstr ":func:`dir`"

msgid ":func:`divmod`"

msgstr ":func:`divmod`"

msgid "**E**"

msgstr "**E**"

msgid ":func:`enumerate`"

msgstr ":func:`enumerate`"

msgid ":func:`eval`"

msgstr ":func:`eval`"

msgid ":func:`exec`"

msgstr ":func:`exec`"

msgid "**F**"

msgstr "**F**"

msgid ":func:`filter`"

msgstr ":func:`filter`"

msgid ":func:`float`"

msgstr ":func:`float`"

msgid ":func:`format`"

msgstr ":func:`format`"

msgid "|func-frozenset|_"

msgstr "|func-frozenset|_"

msgid "**G**"

msgstr "**G**"

msgid ":func:`getattr`"

msgstr ":func:`getattr`"

msgid ":func:`globals`"

msgstr ":func:`globals`"

msgid "**H**"

msgstr "**H**"

msgid ":func:`hasattr`"

msgstr ":func:`hasattr`"

msgid ":func:`hash`"

msgstr ":func:`hash`"

msgid ":func:`help`"

msgstr ":func:`help`"

msgid ":func:`hex`"

msgstr ":func:`hex`"

msgid "**I**"

msgstr "**I**"

msgid ":func:`id`"

msgstr ":func:`id`"

msgid ":func:`input`"

msgstr ":func:`input`"

msgid ":func:`int`"

msgstr ":func:`int`"

msgid ":func:`isinstance`"

msgstr ":func:`isinstance`"

msgid ":func:`issubclass`"

msgstr ":func:`issubclass`"

msgid ":func:`iter`"

msgstr ":func:`iter`"

msgid "**L**"

msgstr "**L**"

msgid ":func:`len`"

msgstr ":func:`len`"

msgid "|func-list|_"

msgstr "|func-list|_"

msgid ":func:`locals`"

msgstr ":func:`locals`"

msgid "**M**"

msgstr "**M**"

msgid ":func:`map`"

msgstr ":func:`map`"

msgid ":func:`max`"

msgstr ":func:`max`"

msgid "|func-memoryview|_"

msgstr "|func-memoryview|_"

msgid ":func:`min`"

msgstr ":func:`min`"

msgid "**N**"

msgstr "**N**"

msgid ":func:`next`"

msgstr ":func:`next`"

msgid "**O**"

msgstr "**O**"

msgid ":func:`object`"

msgstr ":func:`object`"

msgid ":func:`oct`"

msgstr ":func:`oct`"

msgid ":func:`open`"

msgstr ":func:`open`"

msgid ":func:`ord`"

msgstr ":func:`ord`"

msgid "**P**"

msgstr "**P**"

msgid ":func:`pow`"

msgstr ":func:`pow`"

msgid ":func:`print`"

msgstr ":func:`print`"

msgid ":func:`property`"

msgstr ":func:`property`"

msgid "**R**"

msgstr "**R**"

msgid "|func-range|_"

msgstr "|func-range|_"

msgid ":func:`repr`"

msgstr ":func:`repr`"

msgid ":func:`reversed`"

msgstr ":func:`reversed`"

msgid ":func:`round`"

msgstr ":func:`round`"

msgid "**S**"

msgstr "**S**"

msgid "|func-set|_"

msgstr "|func-set|_"

msgid ":func:`setattr`"

msgstr ":func:`setattr`"

msgid ":func:`slice`"

msgstr ":func:`slice`"

msgid ":func:`sorted`"

msgstr ":func:`sorted`"

msgid ":func:`staticmethod`"

msgstr ":func:`staticmethod`"

msgid "|func-str|_"

msgstr "|func-str|_"

msgid ":func:`sum`"

msgstr ":func:`sum`"

msgid ":func:`super`"

msgstr ":func:`super`"

msgid "**T**"

msgstr "**T**"

msgid "|func-tuple|_"

msgstr "|func-tuple|_"

msgid ":func:`type`"

msgstr ":func:`type`"

msgid "**V**"

msgstr "**V**"

msgid ":func:`vars`"

msgstr ":func:`vars`"

msgid "**Z**"

msgstr "**Z**"

msgid ":func:`zip`"

msgstr ":func:`zip`"

msgid "**_**"

msgstr "**_**"

msgid ":func:`__import__`"

msgstr ":func:`__import__`"

msgid "Return the absolute value of a number. The argument may be an integer, a floating-point number, or an object implementing :meth:`~object.__abs__`. If the argument is a complex number, its magnitude is returned."

msgstr "مقدار قدر مطلق یک عدد را برمی‌گرداند. آرگومان می تواند یک عدد صحیح، یک عدد اعشاری، یا یک شیء که :meth:`~object.__abs__` را پیاده‌سازی می‌کند، باشد. اگر ارگومان یک عدد مختلط باشد، بزرگی آن بازگردانده می‌شود."

msgid "Return an :term:`asynchronous iterator` for an :term:`asynchronous iterable`. Equivalent to calling ``x.__aiter__()``."

msgstr "بازگرداندن یک :term:`asynchronous iterator` برای یک :term:`asynchronous iterable` معادل فراخوانی ``x.__aiter__()`` است."

msgid "Note: Unlike :func:`iter`, :func:`aiter` has no 2-argument variant."

msgstr "توجه: برخلاف :func:`iter`، :func:`aiter` نسخه دو آرگومانی ندارد."

msgid "Return ``True`` if all elements of the *iterable* are true (or if the iterable is empty). Equivalent to::"

msgstr "در صورتی که تمام عناصر *iterable* درست باشند (یا اگر iterable خالی باشد)، ``True`` را برمی گرداند. معادل با::"

msgid ""

msgstr ""

msgid "When awaited, return the next item from the given :term:`asynchronous iterator`, or *default* if given and the iterator is :term:`exhausted`."

msgstr "هنگام انتظار، آیتم بعدی را از :term:`پیمایش‌گر ناهمگام <asynchronous iterator>` داده‌شده برگردانید، یا *default* اگر داده شده باشد و پیمایش‌گر :term:`به پایان رسیده <exhausted>` باشد."

msgid "This is the async variant of the :func:`next` builtin, and behaves similarly."

msgstr "این، نسخه ناهمگامِ تابع توکار :func:`next` است و به طور مشابه عمل می‌کند."

msgid "This calls the :meth:`~object.__anext__` method of *async_iterator*, returning an :term:`awaitable`. Awaiting this returns the next value of the iterator. If *default* is given, it is returned if the iterator is exhausted, otherwise :exc:`StopAsyncIteration` is raised."

msgstr "این متد :meth:`~object.__anext__` از *async_iterator* را فراخوانی می کند و یک :term:`awaitable` را برمی گرداند. در انتظار این مقدار بعدی پیمایش‌گر را برمی گرداند. اگر *default* داده شود، اگر پیمایش‌گر تمام شده باشد، برگردانده می شود، در غیر این صورت :exc:`StopAsyncIteration` پرتاب میشود."

msgid "Return ``True`` if any element of the *iterable* is true. If the iterable is empty, return ``False``. Equivalent to::"

msgstr "اگر هر عنصری از *iterable* درست باشد، ``True`` را برگردانید. اگر iterable خالی باشد، ``False`` را برگردانید. معادل با::"

msgid ""

msgstr ""

msgid "As :func:`repr`, return a string containing a printable representation of an object, but escape the non-ASCII characters in the string returned by :func:`repr` using ``\\x``, ``\\u``, or ``\\U`` escapes. This generates a string similar to that returned by :func:`repr` in Python 2."

msgstr "مانند تابع :func:`repr`، رشته‌ای حاوی نمایش قابل چاپ یک شیء را برمی‌گرداند، اما نویسه‌های غیر اَسکی (non-ASCII) را در رشته‌ی بازگردانده‌شده توسط تابع :func:`repr`، با استفاده از دنباله‌های خنثی‌سازی (escapes) ``\\x``، ``\\u`` یا ``\\U`` اِسکِیپ (escape) می‌کند. این عمل، رشته‌ای مشابه آنچه تابع :func:`repr` در پایتون ۲ بازمی‌گرداند، تولید می‌کند."

msgid "Convert an integer number to a binary string prefixed with \"0b\". The result is a valid Python expression. If *integer* is not a Python :class:`int` object, it has to define an :meth:`~object.__index__` method that returns an integer. Some examples:"

msgstr "تبدیل یک عدد صحیح به یک رشته دودویی که با \"0b\" پیشوند شده است. نتیجه یک عبارت معتبر پایتون خواهد بود. اگر *integer* یک شیء پایتون :class:`int` نباشد، لازم است یک متد :meth:`~object.__index__` تعریف کند که یک عدد صحیح برگرداند. برخی مثال ها:"

msgid "If the prefix \"0b\" is desired or not, you can use either of the following ways."

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

msgid "See also :func:`enum.bin` to represent negative values as twos-complement."

msgstr "همچنین برای نمایش مقادیر منفی به‌صورت مکمل دو، به :func:`enum.bin` مراجعه کنید."

msgid "See also :func:`format` for more information."

msgstr "همچنین برای اطلاعات بیشتر، به تابع :func:`format` مراجعه کنید."

msgid "Return a Boolean value, i.e. one of ``True`` or ``False``. The argument is converted using the standard :ref:`truth testing procedure <truth>`. If the argument is false or omitted, this returns ``False``; otherwise, it returns ``True``. The :class:`bool` class is a subclass of :class:`int` (see :ref:`typesnumeric`). It cannot be subclassed further. Its only instances are ``False`` and ``True`` (see :ref:`typebool`)."

msgstr "یک مقدار بولی، یعنی یکی از ``True`` یا ``False`` را بر می‌گرداند. آرگومان با استفاده از استاندارد :ref:`truth testing procedure <truth>` تبدیل می شود. اگر آرگومان نادرست یا حذف شده باشد، ``False`` را برمی گرداند. در غیر این صورت، ``True`` را برمی گرداند. کلاس :class:`bool` یک زیر کلاس از :class:`int` است (به :ref:`typesnumeric` مراجعه کنید). این کلاس دیگر قابل زیرکلاس‌بندی نیست. تنها نمونه های آن ``False`` و ``True`` هستند (به :ref:`typebool` مراجعه کنید)."

msgid "The parameter is now positional-only."

msgstr "این پارامتر اکنون فقط‌جایگاهی (positional-only) است."

msgid "This function drops you into the debugger at the call site. Specifically, it calls :func:`sys.breakpointhook`, passing ``args`` and ``kws`` straight through. By default, ``sys.breakpointhook()`` calls :func:`pdb.set_trace` expecting no arguments. In this case, it is purely a convenience function so you don't have to explicitly import :mod:`pdb` or type as much code to enter the debugger. However, :func:`sys.breakpointhook` can be set to some other function and :func:`breakpoint` will automatically call that, allowing you to drop into the debugger of choice. If :func:`sys.breakpointhook` is not accessible, this function will raise :exc:`RuntimeError`."

msgstr "این تابع، اجرای برنامه را در محل فراخوانی متوقف کرده و شما را وارد محیط اشکال‌زدا می‌کند. به طور خاص، این تابع، :func:`sys.breakpointhook` را فراخوانی کرده و مقادیر ``args`` و ``kws`` مستقیماً به آن ارسال (pass) می‌کند. به طور پیش‌فرض، تابع ``sys.breakpointhook()`` بدون نیاز به هیچ آرگومانی :func:`pdb.set_trace` را فراخوانی می کند. در این حالت، این صرفاً یک تابع کمکی (convenience function) است تا مجبور نباشید ماژول :mod:`pdb` را به صراحت ایمپورت کنید یا برای ورود به اشکال‌زدا، کد زیادی بنویسید. با این حال، می‌توان :func:`sys.breakpointhook` را روی تابع دیگری تنظیم کرد و در این صورت، :func:`breakpoint` به طور خودکار آن را فراخوانی می کند و به شما این امکان را می دهد که به اشکال‌زدای مورد نظر خود وارد شوید. اگر :func:`sys.breakpointhook` قابل دسترسی نباشد، این تابع، استثنای :exc:`RuntimeError` را پرتاب خواهد کرد."

msgid "By default, the behavior of :func:`breakpoint` can be changed with the :envvar:`PYTHONBREAKPOINT` environment variable. See :func:`sys.breakpointhook` for usage details."

msgstr "به طور پیش‌فرض، رفتار تابع :func:`breakpoint` را می‌توان با متغیر محیطی :envvar:`PYTHONBREAKPOINT` تغییر داد. برای جزئیات استفاده، به تابع :func:`sys.breakpointhook` مراجعه کنید."

msgid "Note that this is not guaranteed if :func:`sys.breakpointhook` has been replaced."

msgstr "توجه داشته باشید که این امر تضمین نمی‌شود اگر تابع :func:`sys.breakpointhook` جایگزین شده باشد."

msgid "Raises an :ref:`auditing event <auditing>` ``builtins.breakpoint`` with argument ``breakpointhook``."

msgstr "یک :ref:`رویداد حسابرسی <auditing>` ``builtins.breakpoint`` با آرگومان ``breakpointhook`` پرتاب می‌کند."

msgid "Return a new array of bytes. The :class:`bytearray` class is a mutable sequence of integers in the range 0 <= x < 256. It has most of the usual methods of mutable sequences, described in :ref:`typesseq-mutable`, as well as most methods that the :class:`bytes` type has, see :ref:`bytes-methods`."

msgstr "یک آرایه‌ی جدید از بایت‌ها را برمی‌گرداند. کلاس :class:`bytearray` دنباله‌ای قابل‌تغییر از اعداد صحیح در بازه‌ی 0 <= x < 256 است. این کلاس بیشتر متدهای معمول دنباله‌های قابل‌تغییر را دارد که در :ref:`typesseq-mutable` شرح داده شده‌اند، و همچنین بیشتر متدهایی را دارد که نوع :class:`bytes` دارد؛ به :ref:`bytes-methods` مراجعه کنید."

msgid "The optional *source* parameter can be used to initialize the array in a few different ways:"

msgstr "از پارامتر اختیاری *source* می‌توان برای مقداردهی اولیه آرایه به چند روش مختلف استفاده کرد:"

msgid "If it is a *string*, you must also give the *encoding* (and optionally, *errors*) parameters; :func:`bytearray` then converts the string to bytes using :meth:`str.encode`."

msgstr "اگر *source* یک *رشته* «*string*» باشد، باید پارامترهای *encoding* و (به‌صورت اختیاری) *errors* را نیز مشخص کنید؛ سپس تابع :func:`bytearray` آن رشته را با استفاده از متد :meth:`str.encode` به بایت‌ها تبدیل می‌کند."

msgid "If it is an *integer*, the array will have that size and will be initialized with null bytes."

msgstr "اگر «*source*» یک *عدد صحیح* «integer» باشد، آرایه به اندازه همان عدد ایجاد شده و با بایت‌های تهی «null byte» مقداردهی اولیه خواهد شد."

msgid "If it is an object conforming to the :ref:`buffer interface <bufferobjects>`, a read-only buffer of the object will be used to initialize the bytes array."

msgstr "اگر آرگومان، شیئی سازگار با :ref:`رابط بافر <bufferobjects>` باشد، از یک بافر فقط‌خواندنیِ آن شیء برای مقداردهی اولیه‌ی آرایه‌ی بایت‌ها استفاده خواهد شد."

msgid "If it is an *iterable*, it must be an iterable of integers in the range ``0 <= x < 256``, which are used as the initial contents of the array."

msgstr "اگر «*source*» یک *پیمایش‌پذیر* «iterable» باشد، باید یک پیمایش‌پذیر از اعداد صحیح در بازه ``0 <= x < 256`` باشد، که این اعداد به‌عنوان محتویات اولیه آرایه استفاده می‌شوند."

msgid "Without an argument, an array of size 0 is created."

msgstr "بدون آرگومان، یک آرایه با اندازه صفر «0» ایجاد می شود."

msgid "See also :ref:`binaryseq` and :ref:`typebytearray`."

msgstr "همچنین به :ref:`binaryseq` و :ref:`typebytearray` مراجعه کنید."

msgid "Return a new \"bytes\" object which is an immutable sequence of integers in the range ``0 <= x < 256``. :class:`bytes` is an immutable version of :class:`bytearray` -- it has the same non-mutating methods and the same indexing and slicing behavior."

msgstr "یک شیء «bytes» جدید را برمی‌گرداند که دنباله‌ای تغییرناپذیر از اعداد صحیح در بازه‌ی ``0 <= x < 256`` است. :class:`bytes` نسخه‌ی تغییرناپذیر :class:`bytearray` است؛ همان متدهای غیرتغییردهنده و همان رفتار اندیس‌گذاری و اسلایس را دارد."

msgid "Accordingly, constructor arguments are interpreted as for :func:`bytearray`."

msgstr "بر این اساس، آرگومان‌های سازنده همانند :func:`bytearray` تفسیر می‌شوند."

msgid "Bytes objects can also be created with literals, see :ref:`strings`."

msgstr "اشیای bytes را می‌توان با استفاده از مقادیر لفظی نیز ایجاد کرد؛ برای اطلاعات بیشتر، :ref:`strings` را ببینید."

msgid "See also :ref:`binaryseq`, :ref:`typebytes`, and :ref:`bytes-methods`."

msgstr "همچنین به :ref:`binaryseq`، :ref:`typebytes` و :ref:`bytes-methods` مراجعه کنید."

msgid "Return :const:`True` if the *object* argument appears callable, :const:`False` if not. If this returns ``True``, it is still possible that a call fails, but if it is ``False``, calling *object* will never succeed. Note that classes are callable (calling a class returns a new instance); instances are callable if their class has a :meth:`~object.__call__` method."

msgstr "اگر آرگومان *object* فراخوانی‌پذیر باشد، مقدار :const:`True` و در غیر این صورت مقدار :const:`False` را برمی‌گرداند. اگر نتیجه ``True`` باشد، همچنان ممکن است فراخوانی با شکست مواجه شود؛ اما اگر ``False`` باشد، فراخوانی *object* هرگز موفق نخواهد شد. توجه داشته باشید که کلاس‌ها فراخوانی‌پذیر هستند (فراخوانی یک کلاس یک نمونه‌ی جدید برمی‌گرداند) و نمونه‌ها نیز در صورتی فراخوانی‌پذیر هستند که کلاس آن‌ها متد :meth:`~object.__call__` را داشته باشد."

msgid "This function was first removed in Python 3.0 and then brought back in Python 3.2."

msgstr "این تابع ابتدا در پایتون ۳٫۰ حذف شد و سپس در پایتون ۳٫۲ دوباره بازگردانده شد."

msgid "Return the string representing a character with the specified Unicode code point. For example, ``chr(97)`` returns the string ``'a'``, while ``chr(8364)`` returns the string ``'€'``. This is the inverse of :func:`ord`."

msgstr "رشته‌ای را که نویسه‌ی متناظر با نقطه‌ی کد یونیکد مشخص‌شده را نمایش می‌دهد، برمی‌گرداند. برای مثال، ``chr(97)`` رشته‌ی ``'a'`` و ``chr(8364)`` رشته‌ی ``'€'`` را برمی‌گرداند. این تابع معکوس :func:`ord` است."

msgid "The valid range for the argument is from 0 through 1,114,111 (0x10FFFF in base 16). :exc:`ValueError` will be raised if it is outside that range."

msgstr "بازه‌ی معتبر برای این آرگومان از ۰ تا ۱٬۱۱۴٬۱۱۱ (برابر با 0x10FFFF در مبنای ۱۶) است. اگر مقدار خارج از این بازه باشد، استثنای :exc:`ValueError` پرتاب خواهد شد."

msgid "Transform a method into a class method."

msgstr "یک متد را به متد کلاسی تبدیل می‌کند."

msgid "A class method receives the class as an implicit first argument, just like an instance method receives the instance. To declare a class method, use this idiom::"

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

msgid ""

msgstr ""

msgid "The ``@classmethod`` form is a function :term:`decorator` -- see :ref:`function` for details."

msgstr "شکل ``@classmethod`` یک :term:`دکوراتور <decorator>` تابع است؛ برای جزئیات به :ref:`تابع <function>` مراجعه کنید."

msgid "A class method can be called either on the class (such as ``C.f()``) or on an instance (such as ``C().f()``). The instance is ignored except for its class. If a class method is called for a derived class, the derived class object is passed as the implied first argument."

msgstr "یک متد کلاس را می‌توان هم روی خود کلاس (مانند ``C.f()``) و هم روی یک نمونه (مانند ``C().f()``) فراخوانی کرد. در حالت دوم، نمونه نادیده گرفته می‌شود و فقط کلاس آن در نظر گرفته می‌شود. اگر متد کلاس برای یک کلاس مشتق‌شده فراخوانی شود، شیء کلاس مشتق‌شده به‌عنوان نخستین آرگومان ضمنی ارسال می‌شود."

msgid "Class methods are different than C++ or Java static methods. If you want those, see :func:`staticmethod` in this section. For more information on class methods, see :ref:`types`."

msgstr "متدهای کلاس با متدهای ایستای زبان‌های ++C یا Java تفاوت دارند. اگر به آن نوع متدها نیاز دارید، به :func:`staticmethod` در همین بخش مراجعه کنید. برای اطلاعات بیشتر درباره‌ی متدهای کلاس، :ref:`types` را ببینید."

msgid "Class methods can now wrap other :term:`descriptors <descriptor>` such as :func:`property`."

msgstr "اکنون متدهای کلاس می‌توانند سایر :term:`توصیف‌گرها <descriptor>`، مانند :func:`property`، را دربر بگیرند."

msgid "Class methods now inherit the method attributes (:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` and :attr:`~function.__annotations__`) and have a new ``__wrapped__`` attribute."

msgstr "اکنون متدهای کلاس ویژگی‌های متد (:attr:`~function.__module__`، :attr:`~function.__name__`، :attr:`~function.__qualname__`، :attr:`~function.__doc__` و :attr:`~function.__annotations__`) را به ارث می‌برند و همچنین دارای ویژگی جدید ``__wrapped__`` هستند."

msgid "Class methods can no longer wrap other :term:`descriptors <descriptor>` such as :func:`property`."

msgstr "دیگر متدهای کلاس نمی‌توانند سایر :term:`توصیف‌گرها <descriptor>`، مانند :func:`property`، را دربر بگیرند."

msgid "Compile the *source* into a code or AST object. Code objects can be executed by :func:`exec` or :func:`eval`. *source* can either be a normal string, a byte string, or an AST object. Refer to the :mod:`ast` module documentation for information on how to work with AST objects."

msgstr "*source* را به یک شیء کد یا AST کامپایل می‌کند. اشیای کد را می‌توان با :func:`exec` یا :func:`eval` اجرا کرد. *source* می‌تواند یک رشته‌ی معمولی، یک رشته‌ی بایتی یا یک شیء AST باشد. برای اطلاعات بیشتر درباره‌ی کار با اشیای AST، به مستندات ماژول :mod:`ast` مراجعه کنید."

msgid "The *filename* argument should give the file from which the code was read; pass some recognizable value if it wasn't read from a file (``'<string>'`` is commonly used)."

msgstr "آرگومان *filename* باید نام پرونده‌ای را مشخص کند که کد از آن خوانده شده است؛ اگر کد از پرونده خوانده نشده، مقدار قابل تشخیصی را ارسال کنید (معمولاً از ``'<string>'`` استفاده می‌شود)."

msgid "The *mode* argument specifies what kind of code must be compiled; it can be ``'exec'`` if *source* consists of a sequence of statements, ``'eval'`` if it consists of a single expression, or ``'single'`` if it consists of a single interactive statement (in the latter case, expression statements that evaluate to something other than ``None`` will be printed)."

msgstr "آرگومان *mode* مشخص می‌کند که چه نوع کدی باید کامپایل شود؛ اگر *source* شامل دنباله‌ای از دستورها باشد، می‌تواند ``'exec'`` باشد؛ اگر شامل تنها یک عبارت باشد، ``'eval'``؛ و اگر شامل تنها یک دستور تعاملی باشد، ``'single'`` (در حالت آخر، اگر عبارت مقداری غیر از ``None`` تولید کند، آن مقدار چاپ خواهد شد)."

msgid "The optional arguments *flags* and *dont_inherit* control which :ref:`compiler options <ast-compiler-flags>` should be activated and which :ref:`future features <future>` should be allowed. If neither is present (or both are zero) the code is compiled with the same flags that affect the code that is calling :func:`compile`. If the *flags* argument is given and *dont_inherit* is not (or is zero) then the compiler options and the future statements specified by the *flags* argument are used in addition to those that would be used anyway. If *dont_inherit* is a non-zero integer then the *flags* argument is it -- the flags (future features and compiler options) in the surrounding code are ignored."

msgstr "آرگومان‌های اختیاری *flags* و *dont_inherit* تعیین می‌کنند که کدام :ref:`گزینه‌های کامپایلر <ast-compiler-flags>` فعال شوند و کدام :ref:`قابلیت‌های آینده <future>` مجاز باشند. اگر هیچ‌یک از آن‌ها ارائه نشوند (یا هر دو صفر باشند)، کد با همان پرچم‌هایی کامپایل می‌شود که بر کدی که :func:`compile` را فراخوانی کرده است اعمال می‌شوند. اگر آرگومان *flags* ارائه شود و *dont_inherit* ارائه نشود (یا صفر باشد)، گزینه‌های کامپایلر و دستورهای future مشخص‌شده توسط *flags* علاوه بر مواردی که به‌طور معمول اعمال می‌شوند، استفاده خواهند شد. اگر *dont_inherit* یک عدد صحیح ناصفر باشد، تنها از *flags* استفاده می‌شود و پرچم‌های (قابلیت‌های future و گزینه‌های کامپایلر) موجود در کد پیرامون نادیده گرفته می‌شوند."

msgid "Compiler options and future statements are specified by bits which can be bitwise ORed together to specify multiple options. The bitfield required to specify a given future feature can be found as the :attr:`~__future__._Feature.compiler_flag` attribute on the :class:`~__future__._Feature` instance in the :mod:`__future__` module. :ref:`Compiler flags <ast-compiler-flags>` can be found in :mod:`ast` module, with ``PyCF_`` prefix."

msgstr "گزینه‌های کامپایلر و دستورهای future با استفاده از بیت‌هایی مشخص می‌شوند که می‌توان آن‌ها را با عملگر OR بیتی با یکدیگر ترکیب کرد تا چندین گزینه به‌طور همزمان مشخص شوند. بیت‌فیلد لازم برای مشخص کردن هر قابلیت future را می‌توان در ویژگی :attr:`~__future__._Feature.compiler_flag` از نمونه‌ی :class:`~__future__._Feature` در ماژول :mod:`__future__` یافت. :ref:`پرچم‌های کامپایلر <ast-compiler-flags>` نیز با پیشوند ``PyCF_`` در ماژول :mod:`ast` موجود هستند."

msgid "The argument *optimize* specifies the optimization level of the compiler; the default value of ``-1`` selects the optimization level of the interpreter as given by :option:`-O` options. Explicit levels are ``0`` (no optimization; ``__debug__`` is true), ``1`` (asserts are removed, ``__debug__`` is false) or ``2`` (docstrings are removed too)."

msgstr "آرگومان *optimize* سطح بهینه‌سازی کامپایلر را مشخص می‌کند؛ مقدار پیش‌فرض ``-1`` سطح بهینه‌سازی مفسر را مطابق گزینه‌های :option:`-O` انتخاب می‌کند. سطوح صریح عبارت‌اند از: ``0`` (بدون بهینه‌سازی؛ ``__debug__`` برابر با true است)، ``1`` (دستورهای assert حذف می‌شوند و ``__debug__`` برابر false است)، و ``2`` (علاوه بر آن، docstringها نیز حذف می‌شوند)."

msgid "This function raises :exc:`SyntaxError` if the compiled source is invalid, including a *source* containing a null character or that cannot be decoded; :exc:`ValueError` if *mode* or *flags* is invalid, or if a string *source* contains surrogate characters; :exc:`MemoryError` or :exc:`RecursionError` if *source* is too complex to parse or compile, for example an expression with many thousands of nested operators; and :exc:`OverflowError` if *source* is too large."

msgstr "این تابع :exc:`SyntaxError` را پرتاب میکند اگر منبعِ کامپایل‌شده نامعتبر باشد، از جمله یک *source* که حاوی نویسه‌ی null است یا که قابل رمزگشایی نیست؛ :exc:`ValueError` اگر *حالت* یا *پرچم‌ها* نامعتبر باشند، یا اگر یک رشته *source* حاوی نویسه‌های جایگزین باشد؛ :exc:`MemoryError` یا :exc:`RecursionError` اگر *source* برای تجزیه یا کامپایل بیش از حد پیچیده باشد، برای مثال یک عبارت با هزاران عملگر تو در تو؛ و :exc:`OverflowError` اگر *source* بیش از حد بزرگ باشد."

msgid "If you want to parse Python code into its AST representation, see :func:`ast.parse`."

msgstr "اگر می‌خواهید کد پایتون را به نمایش AST آن تجزیه کنید، به :func:`ast.parse` مراجعه کنید."

msgid "Raises an :ref:`auditing event <auditing>` ``compile`` with arguments ``source`` and ``filename``. This event may also be raised by implicit compilation."

msgstr "یک :ref:`رویداد حسابرسی <auditing>` با نام ``compile`` و آرگومان‌های ``source`` و ``filename`` پرتاب می‌کند. این رویداد ممکن است در نتیجه‌ی کامپایل ضمنی نیز پرتاب شود."

msgid "When compiling a string with multi-line code in ``'single'`` or ``'eval'`` mode, input must be terminated by at least one newline character. This is to facilitate detection of incomplete and complete statements in the :mod:`code` module."

msgstr "هنگام کامپایل یک رشته شامل کد چندخطی در حالت ``'single'`` یا ``'eval'``، ورودی باید دست‌کم با یک نویسه‌ی پایان خط خاتمه یابد. این کار تشخیص دستورات ناقص و کامل را در ماژول :mod:`code` تسهیل می‌کند."

msgid "It is possible to crash the Python interpreter with a sufficiently large/complex string when compiling to an AST object due to stack depth limitations in Python's AST compiler."

msgstr "به دلیل محدودیت عمق پشته (stack depth) در کامپایلر AST پایتون، کامپایل یک رشته‌ی به‌اندازه‌ی کافی بزرگ یا پیچیده به یک شیء AST ممکن است باعث فروپاشی مفسر پایتون شود."

msgid "Allowed use of Windows and Mac newlines. Also, input in ``'exec'`` mode does not have to end in a newline anymore. Added the *optimize* parameter."

msgstr "استفاده از نویسه‌های پایان خط ویندوز و مک مجاز شد. همچنین، ورودی در حالت ``'exec'`` دیگر لازم نیست با یک نویسه‌ی پایان خط خاتمه یابد. پارامتر *optimize* نیز اضافه شد."

msgid "Previously, :exc:`TypeError` was raised when null bytes were encountered in *source*."

msgstr "پیش از این، هنگام برخورد با بایت‌های تهی در *source*، استثنای :exc:`TypeError` پرتاب می‌شد."

msgid "``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` can now be passed in flags to enable support for top-level ``await``, ``async for``, and ``async with``."

msgstr "اکنون می‌توان ``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` را در پرچم‌ها ارسال کرد تا از ``await``، ``async for`` و ``async with`` در سطح بالای کد (top-level) پشتیبانی شود."

msgid ":exc:`SyntaxError` is raised instead of :exc:`ValueError` when null bytes are encountered in *source*."

msgstr "هنگامی که بایت‌های تهی در *source* یافت شوند، :exc:`SyntaxError` به‌جای :exc:`ValueError` پرتاب می‌شود."

msgid "Convert a single string or number to a complex number, or create a complex number from real and imaginary parts."

msgstr "تبدیل یک رشته یا عدد به یک عدد مختلط، یا ایجاد یک عدد مختلط از بخش‌های حقیقی و موهومی یک عدد."

msgid "Examples:"

msgstr "مثال‌ها:"

msgid ""

msgstr ""

msgid "If the argument is a string, it must contain either a real part (in the same format as for :func:`float`) or an imaginary part (in the same format but with a ``'j'`` or ``'J'`` suffix), or both real and imaginary parts (the sign of the imaginary part is mandatory in this case). The string can optionally be surrounded by whitespaces and the round parentheses ``'('`` and ``')'``, which are ignored. The string must not contain whitespace between ``'+'``, ``'-'``, the ``'j'`` or ``'J'`` suffix, and the decimal number. For example, ``complex('1+2j')`` is fine, but ``complex('1 + 2j')`` raises :exc:`ValueError`. More precisely, the input must conform to the :token:`~float:complexvalue` production rule in the following grammar, after parentheses and leading and trailing whitespace characters are removed:"

msgstr "اگر آرگومان یک رشته باشد، باید شامل بخش حقیقی (با همان قالبی که برای :func:`float` استفاده می‌شود)، یا بخش موهومی (با همان قالب اما همراه با پسوند ``'j'`` یا ``'J'``)، یا هر دو بخش حقیقی و موهومی باشد (در این حالت، وجود علامت بخش موهومی الزامی است). رشته می‌تواند به‌صورت اختیاری با نویسه‌های فاصله‌ی سفید و پرانتزهای گرد ``'('`` و ``')'`` احاطه شده باشد که نادیده گرفته می‌شوند. همچنین، نباید بین ``'+'``، ``'-'``، پسوند ``'j'`` یا ``'J'`` و عدد ده‌دهی فاصله‌ی سفید وجود داشته باشد. برای مثال، ``complex('1+2j')`` معتبر است، اما ``complex('1 + 2j')`` باعث پرتاب استثنای :exc:`ValueError` می‌شود. به‌طور دقیق‌تر، پس از حذف پرانتزها و نویسه‌های فاصله‌ی سفید ابتدا و انتهای رشته، ورودی باید با قاعده‌ی تولید :token:`~float:complexvalue` در دستور زبان زیر مطابقت داشته باشد:"

msgid "If the argument is a number, the constructor serves as a numeric conversion like :class:`int` and :class:`float`. For a general Python object ``x``, ``complex(x)`` delegates to ``x.__complex__()``. If :meth:`~object.__complex__` is not defined then it falls back to :meth:`~object.__float__`. If :meth:`!__float__` is not defined then it falls back to :meth:`~object.__index__`."

msgstr "اگر آرگومان یک عدد باشد، سازنده مانند :class:`int` و :class:`float` به‌عنوان یک تبدیل عددی عمل می‌کند. برای یک شیء عمومی پایتون به نام ``x``، تابع ``complex(x)`` فراخوانی را به ``x.__complex__()`` واگذار می‌کند. اگر :meth:`~object.__complex__` تعریف نشده باشد، به :meth:`~object.__float__` بازمی‌گردد. اگر :meth:`!__float__` نیز تعریف نشده باشد، به :meth:`~object.__index__` بازمی‌گردد."

msgid "If two arguments are provided or keyword arguments are used, each argument may be any numeric type (including complex). If both arguments are real numbers, return a complex number with the real component *real* and the imaginary component *imag*. If both arguments are complex numbers, return a complex number with the real component ``real.real-imag.imag`` and the imaginary component ``real.imag+imag.real``. If one of arguments is a real number, only its real component is used in the above expressions."

msgstr "اگر دو آرگومان ارائه شوند یا از آرگومان‌های کلیدواژه‌ای استفاده شود، هر آرگومان می‌تواند از هر نوع عددی (از جمله اعداد مختلط) باشد. اگر هر دو آرگومان عدد حقیقی باشند، یک عدد مختلط با بخش حقیقی *real* و بخش موهومی *imag* برگردانده می‌شود. اگر هر دو آرگومان عدد مختلط باشند، عدد مختلطی با بخش حقیقی ``real.real-imag.imag`` و بخش موهومی ``real.imag+imag.real`` برگردانده می‌شود. اگر یکی از آرگومان‌ها عدد حقیقی باشد، فقط بخش حقیقی آن در عبارت‌های بالا استفاده می‌شود."

msgid "See also :meth:`complex.from_number` which only accepts a single numeric argument."

msgstr "همچنین به :meth:`complex.from_number` مراجعه کنید که فقط یک آرگومان عددی را می‌پذیرد."

msgid "If all arguments are omitted, returns ``0j``."

msgstr "اگر همه‌ی آرگومان‌ها حذف شوند، مقدار ``0j`` برگردانده می‌شود."

msgid "The complex type is described in :ref:`typesnumeric`."

msgstr "نوع مختلط در :ref:`typesnumeric` توضیح داده شده است."

msgid "Grouping digits with underscores as in code literals is allowed."

msgstr "گروه‌بندی رقم‌ها با استفاده از زیرخط، مانند مقادیر لفظی در کد، مجاز است."

msgid "Falls back to :meth:`~object.__index__` if :meth:`~object.__complex__` and :meth:`~object.__float__` are not defined."

msgstr "اگر :meth:`~object.__complex__` و :meth:`~object.__float__` تعریف نشده باشند، به :meth:`~object.__index__` بازمی‌گردد."

msgid "Passing a complex number as the *real* or *imag* argument is now deprecated; it should only be passed as a single positional argument."

msgstr "ارسال یک عدد مختلط به‌عنوان آرگومان *real* یا *imag* اکنون منسوخ شده است؛ عدد مختلط باید فقط به‌صورت یک آرگومان جایگاهی ارسال شود."

msgid "This is a relative of :func:`setattr`. The arguments are an object and a string. The string must be the name of one of the object's attributes. The function deletes the named attribute, provided the object allows it. For example, ``delattr(x, 'foobar')`` is equivalent to ``del x.foobar``. *name* need not be a Python identifier (see :func:`setattr`)."

msgstr "این تابع همتای :func:`setattr` است. آرگومان‌های آن یک شیء و یک رشته هستند. رشته باید نام یکی از ویژگی‌های شیء باشد. در صورت مجاز بودن، این تابع ویژگی نام‌برده را حذف می‌کند. برای مثال، ``delattr(x, 'foobar')`` معادل ``del x.foobar`` است. *name* الزامی ندارد که یک شناسه‌ی معتبر پایتون باشد (به :func:`setattr` مراجعه کنید)."

msgid "Create a new dictionary. The :class:`dict` object is the dictionary class. See also :ref:`typesmapping` for documentation about this class."

msgstr "ایجاد یک دیکشنری جدید. شیء :class:`dict` کلاس دیکشنری است. برای مستندات این کلاس، به :ref:`typesmapping` مراجعه کنید."

msgid "For other containers see the built-in :class:`list`, :class:`set`, and :class:`tuple` classes, as well as the :mod:`collections` module."

msgstr "برای سایر انواع ظرف‌ها، به کلاس‌های توکار :class:`list`، :class:`set` و :class:`tuple`، و همچنین ماژول :mod:`collections` مراجعه کنید."

msgid "Without arguments, return the list of names in the current local scope. With an argument, attempt to return a list of valid attributes for that object."

msgstr "بدون آرگومان، فهرست نام‌های موجود در دامنه‌ی محلیِ فعلی را بازمی‌گرداند. با ارسال یک آرگومان، تلاش می‌کند فهرستی از ویژگی‌های معتبر آن شیء را بازگرداند."

msgid "If the object has a method named :meth:`~object.__dir__`, this method will be called and must return the list of attributes. This allows objects that implement a custom :func:`~object.__getattr__` or :func:`~object.__getattribute__` function to customize the way :func:`dir` reports their attributes."

msgstr "اگر شیء متدی با نام :meth:`~object.__dir__` داشته باشد، این متد فراخوانی می‌شود و باید فهرستی از ویژگی‌ها را برگرداند. این امکان را فراهم می‌کند که اشیایی که :func:`~object.__getattr__` یا :func:`~object.__getattribute__` سفارشی را پیاده‌سازی کرده‌اند، نحوه‌ی گزارش ویژگی‌های خود توسط :func:`dir` را سفارشی‌سازی کنند."

msgid "If the object does not provide :meth:`~object.__dir__`, the function tries its best to gather information from the object's :attr:`~object.__dict__` attribute, if defined, and from its type object. The resulting list is not necessarily complete and may be inaccurate when the object has a custom :func:`~object.__getattr__`."

msgstr "اگر شیء متد :meth:`~object.__dir__` را ارائه نکند، این تابع در صورت تعریف شدن، تلاش می‌کند تا حد امکان اطلاعات را از ویژگی :attr:`~object.__dict__` شیء و همچنین از شیء نوع (type object) آن جمع‌آوری کند. فهرست حاصل لزوماً کامل نیست و اگر شیء دارای :func:`~object.__getattr__` سفارشی باشد، ممکن است دقیق هم نباشد."

msgid "The default :func:`dir` mechanism behaves differently with different types of objects, as it attempts to produce the most relevant, rather than complete, information:"

msgstr "سازوکار پیش‌فرض :func:`dir` بسته به نوع شیء رفتار متفاوتی دارد، زیرا تلاش می‌کند به‌جای ارائه‌ی اطلاعات کامل، مرتبط‌ترین اطلاعات را ارائه دهد:"

msgid "If the object is a module object, the list contains the names of the module's attributes."

msgstr "اگر شیء یک ماژول باشد، فهرست شامل نام ویژگی‌های آن ماژول خواهد بود."

msgid "If the object is a type or class object, the list contains the names of its attributes, and recursively of the attributes of its bases."

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

msgid "Otherwise, the list contains the object's attributes' names, the names of its class's attributes, and recursively of the attributes of its class's base classes."

msgstr "در غیر این صورت، فهرست شامل نام ویژگی‌های شیء، نام ویژگی‌های کلاس آن، و همچنین به‌صورت بازگشتی، نام ویژگی‌های کلاس‌های پایه‌ی آن خواهد بود."

msgid "The resulting list is sorted alphabetically. For example:"

msgstr "فهرست حاصل به‌ترتیب الفبایی مرتب می‌شود. برای مثال:"

msgid "Because :func:`dir` is supplied primarily as a convenience for use at an interactive prompt, it tries to supply an interesting set of names more than it tries to supply a rigorously or consistently defined set of names, and its detailed behavior may change across releases. For example, metaclass attributes are not in the result list when the argument is a class."

msgstr "از آنجا که :func:`dir` در درجه‌ی اول برای سهولت استفاده در اعلان تعاملی طراحی شده است، بیشتر تلاش می‌کند مجموعه‌ای مفید از نام‌ها را ارائه دهد تا مجموعه‌ای با تعریف دقیق و سازگار. بنابراین، رفتار دقیق آن ممکن است بین نسخه‌های مختلف تغییر کند. برای مثال، اگر آرگومان یک کلاس باشد، ویژگی‌های فراکلاس در فهرست نتایج قرار نمی‌گیرند."

msgid "Take two (non-complex) numbers as arguments and return a pair of numbers consisting of their quotient and remainder when using integer division. With mixed operand types, the rules for binary arithmetic operators apply. For integers, the result is the same as ``(a // b, a % b)``. For floating-point numbers the result is ``(q, a % b)``, where *q* is usually ``math.floor(a / b)`` but may be 1 less than that. In any case ``q * b + a % b`` is very close to *a*, if ``a % b`` is non-zero it has the same sign as *b*, and ``0 <= abs(a % b) < abs(b)``."

msgstr "دو عدد (غیرمختلط) را به‌عنوان آرگومان می‌گیرد و جفتی از اعداد شامل خارج‌قسمت و باقیمانده‌ی تقسیم کف آن‌ها را برمی‌گرداند. در صورت متفاوت بودن نوع عملوندها، قواعد عملگرهای حسابی دودویی اعمال می‌شود. برای اعداد صحیح، نتیجه برابر با ``(a // b, a % b)`` است. برای اعداد ممیز شناور، نتیجه ``(q, a % b)`` است که در آن *q* معمولاً برابر ``math.floor(a / b)`` است، اما ممکن است یک واحد کمتر از آن باشد. در هر صورت، مقدار ``q * b + a % b`` بسیار به *a* نزدیک است، و اگر ``a % b`` صفر نباشد، هم‌علامت با *b* خواهد بود و همچنین ``0 <= abs(a % b) < abs(b)`` برقرار است."

msgid "Return an enumerate object. *iterable* must be a sequence, an :term:`iterator`, or some other object which supports iteration. The :meth:`~iterator.__next__` method of the iterator returned by :func:`enumerate` returns a tuple containing a count (from *start* which defaults to 0) and the values obtained from iterating over *iterable*."

msgstr "یک شیء enumerate را برمی‌گرداند. *iterable* باید یک دنباله، یک :term:`پیمایش‌گر <iterator>` یا هر شیء دیگری باشد که از پیمایش پشتیبانی می‌کند. متد :meth:`~iterator.__next__` پیمایش‌گر بازگردانده‌شده توسط :func:`enumerate`، تاپلی شامل یک شمارنده (که از *start* آغاز می‌شود و مقدار پیش‌فرض آن 0 است) و مقادیر به‌دست‌آمده از پیمایش *iterable* را برمی‌گرداند."

msgid "Equivalent to::"

msgstr "مساوی است با::"

msgid ""

msgstr ""

msgid "Parameters"

msgstr "پارامترها"

msgid "A Python expression."

msgstr "یک عبارت پایتون."

msgid "The global namespace (default: ``None``)."

msgstr "فضای نام سراسری (پیش‌فرض: ``None``)."

msgid "The local namespace (default: ``None``)."

msgstr "فضای نام محلی (پیش‌فرض: ``None``)."

msgid "Returns"

msgstr "بازمیگرداند"

msgid "The result of the evaluated expression."

msgstr "نتیجه‌ی عبارت ارزیابی‌شده."

msgid "raises"

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

msgid "Syntax errors are reported as exceptions."

msgstr "خطاهای نحوی به‌صورت استثنا گزارش می‌شوند."

msgid "This function executes arbitrary code. Calling it with untrusted user-supplied input will lead to security vulnerabilities."

msgstr "این تابع کد دلخواه را اجرا می‌کند. فراخوانی آن با ورودیِ تأمین‌شده از سوی کاربر که قابل اعتماد نیست، منجر به آسیب‌پذیری‌های امنیتی خواهد شد."

msgid "The *source* argument is parsed and evaluated as a Python expression (technically speaking, an :ref:`expression list <exprlists>`) using the *globals* and *locals* mappings as global and local namespace. If the *globals* dictionary is present and does not contain a value for the key ``__builtins__``, a reference to the dictionary of the built-in module :mod:`builtins` is inserted under that key before *source* is parsed. Overriding ``__builtins__`` can be used to restrict or change the available names, but this is **not** a security mechanism: the executed code can still access all builtins. If the *locals* mapping is omitted it defaults to the *globals* dictionary. If both mappings are omitted, the source is executed with the *globals* and *locals* in the environment where :func:`eval` is called. Note, *eval()* will only have access to the :term:`nested scopes <nested scope>` (non-locals) in the enclosing environment if they are already referenced in the scope that is calling :func:`eval` (e.g. via a :keyword:`nonlocal` statement)."

msgstr "آرگومان *source* به‌عنوان یک عبارت پایتون (از نظر فنی، یک :ref:`فهرست عبارات <exprlists>`) با استفاده از نگاشت‌های *globals* و *locals* به‌ترتیب به‌عنوان فضای نام سراسری و محلی، تجزیه و ارزیابی می‌شود. اگر دیکشنری *globals* وجود داشته باشد اما کلید ``__builtins__`` را نداشته باشد، پیش از تجزیه‌ی *source*، ارجاعی به دیکشنری ماژول توکار :mod:`builtins` تحت این کلید درج می‌شود. بازنویسی ``__builtins__`` می‌تواند برای محدود کردن یا تغییر نام‌های در دسترس استفاده شود، اما این **یک سازوکار امنیتی نیست**؛ زیرا کد اجراشده همچنان می‌تواند به تمام توابع و اشیای توکار دسترسی داشته باشد. اگر نگاشت *locals* ارائه نشود، به‌طور پیش‌فرض از دیکشنری *globals* استفاده می‌شود. اگر هر دو نگاشت حذف شوند، *source* با استفاده از *globals* و *locals* محیطی که :func:`eval` در آن فراخوانی شده اجرا می‌شود. توجه داشته باشید که *eval()* تنها در صورتی به :term:`دامنه‌های تودرتو <nested scope>` (متغیرهای nonlocal) محیط پیرامون دسترسی خواهد داشت که آن‌ها از قبل در دامنه‌ای که :func:`eval` را فراخوانی می‌کند ارجاع داده شده باشند (برای مثال، از طریق دستور :keyword:`nonlocal`)."

msgid "Example:"

msgstr "مثال:"

msgid "This function can also be used to execute arbitrary code objects (such as those created by :func:`compile`). In this case, pass a code object instead of a string. If the code object has been compiled with ``'exec'`` as the *mode* argument, :func:`eval`\\'s return value will be ``None``."

msgstr "از این تابع همچنین می‌توان برای اجرای اشیای کد دلخواه (مانند اشیایی که توسط :func:`compile` ایجاد شده‌اند) استفاده کرد. در این حالت، به‌جای رشته، یک شیء کد ارسال کنید. اگر شیء کد با آرگومان *mode* برابر ``'exec'`` کامپایل شده باشد، مقدار بازگشتی :func:`eval` برابر ``None`` خواهد بود."

msgid "Hints: dynamic execution of statements is supported by the :func:`exec` function. The :func:`globals` and :func:`locals` functions return the current global and local dictionary, respectively, which may be useful to pass around for use by :func:`eval` or :func:`exec`."

msgstr "راهنمایی: اجرای پویای دستورها توسط تابع :func:`exec` پشتیبانی می‌شود. توابع :func:`globals` و :func:`locals` به‌ترتیب دیکشنری سراسری و محلی فعلی را برمی‌گردانند که می‌توان آن‌ها را برای استفاده در :func:`eval` یا :func:`exec` به توابع دیگر ارسال کرد."

msgid "If the given source is a string, then leading and trailing spaces and tabs are stripped."

msgstr "اگر کد منبع داده‌شده یک رشته باشد، فاصله‌ها و نویسه‌های تب ابتدا و انتهای آن حذف می‌شوند."

msgid "See :func:`ast.literal_eval` for a function to evaluate strings with expressions containing only literals."

msgstr "برای تابعی که رشته‌های دارای عبارت‌هایی شامل فقط مقادیر لفظی را ارزیابی می‌کند، به :func:`ast.literal_eval` مراجعه کنید."

msgid "Raises an :ref:`auditing event <auditing>` ``exec`` with the code object as the argument. Code compilation events may also be raised."

msgstr "یک :ref:`رویداد حسابرسی <auditing>` با نام ``exec`` و شیء کد به‌عنوان آرگومان پرتاب می‌کند. رویدادهای مربوط به کامپایل کد نیز ممکن است پرتاب شوند."

msgid "The *globals* and *locals* arguments can now be passed as keywords."

msgstr "آرگومان‌های *globals* و *locals* اکنون می‌توانند به‌صورت آرگومان کلیدواژه‌ای نیز ارسال شوند."

msgid "The semantics of the default *locals* namespace have been adjusted as described for the :func:`locals` builtin."

msgstr "معنای فضای نام پیش‌فرض *locals* مطابق توضیحات ارائه‌شده برای تابع توکار :func:`locals` تنظیم شده است."

msgid "This function supports dynamic execution of Python code. *source* must be either a string or a code object. If it is a string, the string is parsed as a suite of Python statements which is then executed (unless a syntax error occurs). [#]_ If it is a code object, it is simply executed. In all cases, the code that's executed is expected to be valid as file input (see the section :ref:`file-input` in the Reference Manual). Be aware that the :keyword:`nonlocal`, :keyword:`yield`, and :keyword:`return` statements may not be used outside of function definitions even within the context of code passed to the :func:`exec` function. The return value is ``None``."

msgstr "این تابع از اجرای پویای کد پایتون پشتیبانی می‌کند. *source* باید یا یک رشته باشد یا یک شیء کد. اگر رشته باشد، به‌عنوان مجموعه‌ای از دستورهای پایتون تجزیه و سپس اجرا می‌شود (مگر اینکه خطای نحوی رخ دهد). [#]_ اگر یک شیء کد باشد، مستقیماً اجرا می‌شود. در همه‌ی موارد، انتظار می‌رود کد اجراشده به‌عنوان ورودی پرونده معتبر باشد (به بخش :ref:`file-input` در راهنمای مرجع مراجعه کنید). توجه داشته باشید که دستورهای :keyword:`nonlocal`، :keyword:`yield` و :keyword:`return` حتی در کدی که از طریق :func:`exec` اجرا می‌شود نیز خارج از تعریف تابع قابل استفاده نیستند. مقدار بازگشتی ``None`` است."

msgid "In all cases, if the optional parts are omitted, the code is executed in the current scope. If only *globals* is provided, it must be a dictionary (and not a subclass of dictionary), which will be used for both the global and the local variables. If *globals* and *locals* are given, they are used for the global and local variables, respectively. If provided, *locals* can be any mapping object. Remember that at the module level, globals and locals are the same dictionary."

msgstr "در همه‌ی حالت‌ها، اگر بخش‌های اختیاری حذف شوند، کد در محدوده فعلی اجرا می‌شود. اگر فقط *globals* ارائه شود، باید یک دیکشنری باشد (و نه یک زیرکلاس از دیکشنری) که هم برای متغیرهای سراسری و هم برای متغیرهای محلی استفاده خواهد شد. اگر هر دو *globals* و *locals* ارائه شوند، به‌ترتیب برای متغیرهای سراسری و محلی استفاده می‌شوند. در صورت ارائه، *locals* می‌تواند هر شیء نگاشتی باشد. به خاطر داشته باشید که در سطح ماژول، globals و locals همان دیکشنری یکسان هستند."

msgid "When ``exec`` gets two separate objects as *globals* and *locals*, the code will be executed as if it were embedded in a class definition. This means functions and classes defined in the executed code will not be able to access variables assigned at the top level (as the \"top level\" variables are treated as class variables in a class definition)."

msgstr "وقتی ``exec`` دو شیء جداگانه را به‌عنوان *globals* و *locals* دریافت می‌کند، کد به‌گونه‌ای اجرا می‌شود که گویی درون یک تعریف کلاس قرار دارد. این بدان معناست که توابع و کلاس‌های تعریف‌شده در کد اجراشده نمی‌توانند به متغیرهای اختصاص‌یافته در سطح بالا دسترسی داشته باشند (زیرا متغیرهای «سطح بالا» در تعریف کلاس به‌عنوان متغیرهای کلاس در نظر گرفته می‌شوند)."

msgid "If the *globals* dictionary does not contain a value for the key ``__builtins__``, a reference to the dictionary of the built-in module :mod:`builtins` is inserted under that key. Overriding ``__builtins__`` can be used to restrict or change the available names, but this is **not** a security mechanism: the executed code can still access all builtins."

msgstr "اگر دیکشنری *globals* مقداری برای کلید ``__builtins__`` نداشته باشد، ارجاعی به دیکشنری ماژول توکار :mod:`builtins` با همان کلید در آن درج می‌شود. بازنویسی ``__builtins__`` می‌تواند برای محدود کردن یا تغییر نام‌های در دسترس استفاده شود، اما این **یک سازوکار امنیتی نیست**؛ زیرا کدی که اجرا می‌شود همچنان می‌تواند به تمام اشیای توکار دسترسی داشته باشد."

msgid "The *closure* argument specifies a closure--a tuple of cellvars. It's only valid when the *object* is a code object containing :term:`free (closure) variables <closure variable>`. The length of the tuple must exactly match the length of the code object's :attr:`~codeobject.co_freevars` attribute."

msgstr "آرگومان *بستار* یک بستار را مشخص می‌کند؛ یعنی یک تاپل از cellvarها. این آرگومان تنها زمانی معتبر است که *object* یک شیء کد باشد که شامل :term:`متغیرهای آزاد (بستار) <closure variable>` باشد. طول این تاپل باید دقیقاً با طول ویژگی :attr:`~codeobject.co_freevars` شیء کد برابر باشد."

msgid "The built-in functions :func:`globals` and :func:`locals` return the current global and local namespace, respectively, which may be useful to pass around for use as the second and third argument to :func:`exec`."

msgstr "توابع توکار :func:`globals` و :func:`locals` به‌ترتیب فضای نام سراسری و محلی فعلی را برمی‌گردانند که می‌توانند برای ارسال به‌عنوان آرگومان دوم و سوم تابع :func:`exec` مفید باشند."

msgid "The default *locals* act as described for function :func:`locals` below. Pass an explicit *locals* dictionary if you need to see effects of the code on *locals* after function :func:`exec` returns."

msgstr "*locals* پیش‌فرض همان‌گونه عمل می‌کند که در ادامه برای تابع :func:`locals` توضیح داده شده است. اگر لازم است پس از بازگشت تابع :func:`exec` تغییرات اعمال‌شده روی *locals* را مشاهده کنید، یک دیکشنری *locals* صریح ارسال کنید."

msgid "Added the *closure* parameter."

msgstr "پارامتر *closure* اضافه شد."

msgid "Construct an iterator from those elements of *iterable* for which *function* is true. *iterable* may be either a sequence, a container which supports iteration, or an iterator. If *function* is ``None``, the identity function is assumed, that is, all elements of *iterable* that are false are removed."

msgstr "از میان عناصر *iterable*، آن‌هایی را که *function* برایشان مقدار True برمی‌گرداند، انتخاب کرده و یک پیمایش‌گر می‌سازد. *iterable* می‌تواند یک دنباله، یک ظرف پیمایش‌پذیر، یا یک پیمایش‌گر باشد. اگر *function* برابر ``None`` باشد، تابع همانی در نظر گرفته می‌شود؛ یعنی تمام عناصری از *iterable* که نادرست (False) هستند، حذف می‌شوند."

msgid "Note that ``filter(function, iterable)`` is equivalent to the generator expression ``(item for item in iterable if function(item))`` if function is not ``None`` and ``(item for item in iterable if item)`` if function is ``None``."

msgstr "توجه داشته باشید که اگر *function* برابر ``None`` نباشد، ``filter(function, iterable)`` معادل عبارت تولیدگر ``(item for item in iterable if function(item))`` است، و اگر *function* برابر ``None`` باشد، معادل ``(item for item in iterable if item)`` خواهد بود."

msgid "See :func:`itertools.filterfalse` for the complementary function that returns elements of *iterable* for which *function* is false."

msgstr "برای تابع مکملی که عناصر *iterable* را که *function* برای آن‌ها مقدار نادرست (false) برمی‌گرداند، بازمی‌گرداند، به :func:`itertools.filterfalse` مراجعه کنید."

msgid "Return a floating-point number constructed from a number or a string."

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

msgid ""

msgstr ""

msgid "If the argument is a string, it should contain a decimal number, optionally preceded by a sign, and optionally embedded in whitespace. The optional sign may be ``'+'`` or ``'-'``; a ``'+'`` sign has no effect on the value produced. The argument may also be a string representing a NaN (not-a-number), or positive or negative infinity. More precisely, the input must conform to the :token:`~float:floatvalue` production rule in the following grammar, after leading and trailing whitespace characters are removed:"

msgstr "اگر آرگومان یک رشته باشد، باید شامل یک عدد ده‌دهی باشد که به‌صورت اختیاری با یک علامت و همچنین با فاصله‌ی سفید احاطه شده باشد. علامت اختیاری می‌تواند ``'+'`` یا ``'-'`` باشد؛ علامت ``'+'`` تأثیری بر مقدار تولیدشده ندارد. آرگومان همچنین می‌تواند رشته‌ای باشد که یک NaN (عدد نیست) یا بی‌نهایت مثبت یا منفی را نمایش می‌دهد. به‌طور دقیق‌تر، پس از حذف نویسه‌های فاصله‌ی سفید ابتدا و انتهای رشته، ورودی باید با قاعده‌ی تولید :token:`~float:floatvalue` در دستور زبان زیر مطابقت داشته باشد:"

msgid "Case is not significant, so, for example, \"inf\", \"Inf\", \"INFINITY\", and \"iNfINity\" are all acceptable spellings for positive infinity."

msgstr "بزرگی و کوچکی حروف (case) اهمیتی ندارد؛ بنابراین، برای مثال، «inf»، «Inf»، «INFINITY» و «iNfINity» همگی برای نمایش بی‌نهایت مثبت معتبر هستند."

msgid "Otherwise, if the argument is an integer or a floating-point number, a floating-point number with the same value (within Python's floating-point precision) is returned. If the argument is outside the range of a Python float, an :exc:`OverflowError` will be raised."

msgstr "در غیر این صورت، اگر آرگومان یک عدد صحیح یا یک عدد ممیز شناور باشد، یک عدد ممیز شناور با همان مقدار (در محدوده‌ی دقت اعداد ممیز شناور پایتون) برگردانده می‌شود. اگر آرگومان خارج از محدوده‌ی یک عدد ممیز شناور در پایتون باشد، استثنای :exc:`OverflowError` پرتاب خواهد شد."

msgid "For a general Python object ``x``, ``float(x)`` delegates to ``x.__float__()``. If :meth:`~object.__float__` is not defined then it falls back to :meth:`~object.__index__`."

msgstr "برای یک شیء عمومی پایتون به نام ``x``، تابع ``float(x)`` فراخوانی را به ``x.__float__()`` واگذار می‌کند. اگر :meth:`~object.__float__` تعریف نشده باشد، به :meth:`~object.__index__` بازمی‌گردد."

msgid "See also :meth:`float.from_number` which only accepts a numeric argument."

msgstr "همچنین به :meth:`float.from_number` مراجعه کنید که فقط یک آرگومان عددی را می‌پذیرد."

msgid "If no argument is given, ``0.0`` is returned."

msgstr "اگر هیچ آرگومانی ارائه نشود، مقدار ``0.0`` برگردانده می‌شود."

msgid "The float type is described in :ref:`typesnumeric`."

msgstr "نوع ممیز شناور در :ref:`typesnumeric` توضیح داده شده است."

msgid "Falls back to :meth:`~object.__index__` if :meth:`~object.__float__` is not defined."

msgstr "اگر :meth:`~object.__float__` تعریف نشده باشد، به :meth:`~object.__index__` بازمی‌گردد."

msgid "Convert a *value* to a \"formatted\" representation, as controlled by *format_spec*. The interpretation of *format_spec* will depend on the type of the *value* argument; however, there is a standard formatting syntax that is used by most built-in types: :ref:`formatspec`."

msgstr "*value* را مطابق با *format_spec* به یک نمایش قالب‌بندی‌شده تبدیل می‌کند. نحوه‌ی تفسیر *format_spec* به نوع آرگومان *value* بستگی دارد؛ با این حال، یک سینتکس استاندارد برای قالب‌بندی وجود دارد که بیشتر انواع توکار از آن استفاده می‌کنند: :ref:`formatspec`."

msgid "The default *format_spec* is an empty string which usually gives the same effect as calling :func:`str(value) <str>`."

msgstr "مقدار پیش‌فرض *format_spec* یک رشته‌ی خالی است که معمولاً همان اثری را دارد که فراخوانی :func:`str(value) <str>` ایجاد می‌کند."

msgid "A call to ``format(value, format_spec)`` is translated to ``type(value).__format__(value, format_spec)`` which bypasses the instance dictionary when searching for the value's :meth:`~object.__format__` method. A :exc:`TypeError` exception is raised if the method search reaches :mod:`object` and the *format_spec* is non-empty, or if either the *format_spec* or the return value are not strings."

msgstr "فراخوانی ``format(value, format_spec)`` به ``type(value).__format__(value, format_spec)`` تبدیل می‌شود که هنگام جست‌وجوی متد :meth:`~object.__format__` مربوط به *value*، دیکشنری نمونه را نادیده می‌گیرد. اگر جست‌وجوی متد به :mod:`object` برسد و *format_spec* خالی نباشد، یا اگر *format_spec* یا مقدار بازگشتی رشته نباشند، استثنای :exc:`TypeError` پرتاب می‌شود."

msgid "``object().__format__(format_spec)`` raises :exc:`TypeError` if *format_spec* is not an empty string."

msgstr "اگر *format_spec* یک رشته‌ی خالی نباشد، ``object().__format__(format_spec)`` استثنای :exc:`TypeError` پرتاب می‌کند."

msgid "Return a new :class:`frozenset` object, optionally with elements taken from *iterable*. :class:`frozenset` is a built-in class. See also :ref:`types-set` for documentation about this class."

msgstr "یک شیء جدید از نوع :class:`frozenset` را برمی‌گرداند که در صورت ارائه، عناصر آن از *iterable* گرفته می‌شوند. :class:`frozenset` یک کلاس توکار است. برای مستندات این کلاس، به :ref:`types-set` مراجعه کنید."

msgid "For other containers see the built-in :class:`set`, :class:`list`, :class:`tuple`, and :class:`dict` classes, as well as the :mod:`collections` module."

msgstr "برای سایر انواع ظرف‌ها، به کلاس‌های توکار :class:`set`، :class:`list`، :class:`tuple` و :class:`dict`، و همچنین ماژول :mod:`collections` مراجعه کنید."

msgid "Return the value of the named attribute of *object*. *name* must be a string. If the string is the name of one of the object's attributes, the result is the value of that attribute. For example, ``getattr(x, 'foobar')`` is equivalent to ``x.foobar``. If the named attribute does not exist, *default* is returned if provided, otherwise :exc:`AttributeError` is raised. *name* need not be a Python identifier (see :func:`setattr`)."

msgstr "مقدار ویژگیِ نام‌گذاری‌شده‌ی *object* را برمی‌گرداند. *name* باید یک رشته باشد. اگر رشته، نام یکی از ویژگی‌های شیء باشد، نتیجه مقدار آن ویژگی خواهد بود. برای مثال، ``getattr(x, 'foobar')`` معادل ``x.foobar`` است. اگر ویژگیِ نام‌گذاری‌شده وجود نداشته باشد، در صورت ارائه، *default* برگردانده می‌شود؛ در غیر این صورت، استثنای :exc:`AttributeError` پرتاب می‌شود. لازم نیست *name* یک شناسه‌ی معتبر پایتون باشد (به :func:`setattr` مراجعه کنید)."

msgid "Since :ref:`private name mangling <private-name-mangling>` happens at compilation time, one must manually mangle a private attribute's (attributes with two leading underscores) name in order to retrieve it with :func:`getattr`."

msgstr "از آنجا که :ref:`تغییر نام خصوصی <private-name-mangling>` در زمان کامپایل انجام می‌شود، برای بازیابی یک ویژگی خصوصی (ویژگی‌هایی که با دو زیرخط آغاز می‌شوند) با استفاده از :func:`getattr`، باید نام آن را به‌صورت دستی تغییر دهید."

msgid "Return the dictionary implementing the current module namespace. For code within functions, this is set when the function is defined and remains the same regardless of where the function is called."

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

msgid "The arguments are an object and a string. The result is ``True`` if the string is the name of one of the object's attributes, ``False`` if not. (This is implemented by calling ``getattr(object, name)`` and seeing whether it raises an :exc:`AttributeError` or not.)"

msgstr "آرگومان‌ها شامل یک شیء و یک رشته هستند. اگر رشته نام یکی از ویژگی‌های آن شیء باشد، نتیجه ``True`` و در غیر این صورت ``False`` خواهد بود. (این کار با فراخوانی ``getattr(object, name)`` و بررسی اینکه آیا استثنای :exc:`AttributeError` پرتاب می‌شود یا نه، پیاده‌سازی شده است.)"

msgid "Return the hash value of the object (if it has one). Hash values are integers. They are used to quickly compare dictionary keys during a dictionary lookup. Numeric values that compare equal have the same hash value (even if they are of different types, as is the case for 1 and 1.0)."

msgstr "مقدار هش شیء را (در صورتی که داشته باشد) برمی‌گرداند. مقادیر هش اعداد صحیح هستند. از آن‌ها برای مقایسه‌ی سریع کلیدهای دیکشنری هنگام جست‌وجو در دیکشنری استفاده می‌شود. مقادیر عددی که با یکدیگر برابر مقایسه می‌شوند، مقدار هش یکسانی دارند (حتی اگر از نوع‌های متفاوتی باشند، مانند 1 و 1.0)."

msgid "For objects with custom :meth:`~object.__hash__` methods, note that :func:`hash` truncates the return value based on the bit width of the host machine."

msgstr "برای اشیایی که متد :meth:`~object.__hash__` سفارشی دارند، توجه داشته باشید که :func:`hash` مقدار بازگشتی را بر اساس پهنای بیت ماشین میزبان کوتاه می‌کند."

msgid "Invoke the built-in help system. (This function is intended for interactive use.) If no argument is given, the interactive help system starts on the interpreter console. If the argument is a string, then the string is looked up as the name of a module, function, class, method, keyword, or documentation topic, and a help page is printed on the console. If the argument is any other kind of object, a help page on the object is generated."

msgstr "سامانه‌ی راهنمای توکار را فراخوانی می‌کند. (این تابع برای استفاده‌ی تعاملی طراحی شده است.) اگر هیچ آرگومانی ارائه نشود، سامانه‌ی راهنمای تعاملی در کنسول مفسر آغاز می‌شود. اگر آرگومان یک رشته باشد، آن رشته به‌عنوان نام یک ماژول، تابع، کلاس، متد، کلیدواژه یا موضوع مستندات جست‌وجو می‌شود و صفحه‌ی راهنمای آن در کنسول نمایش داده می‌شود. اگر آرگومان هر نوع شیء دیگری باشد، صفحه‌ی راهنمای مربوط به آن شیء تولید می‌شود."

msgid "Note that if a slash(/) appears in the parameter list of a function when invoking :func:`help`, it means that the parameters prior to the slash are positional-only. For more info, see :ref:`the FAQ entry on positional-only parameters <faq-positional-only-arguments>`."

msgstr "توجه داشته باشید که اگر هنگام فراخوانی :func:`help` یک اسلش (/) در فهرست پارامترهای یک تابع ظاهر شود، به این معناست که پارامترهای قبل از اسلش فقط به‌صورت جایگاهی قابل ارسال هستند. برای اطلاعات بیشتر، به :ref:`پرسش متداول مربوط به پارامترهای فقط جایگاهی <faq-positional-only-arguments>` مراجعه کنید."

msgid "This function is added to the built-in namespace by the :mod:`site` module."

msgstr "این تابع توسط ماژول :mod:`site` به فضای نام توکار (built-in namespace) اضافه می‌شود."

msgid "Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures for callables are now more comprehensive and consistent."

msgstr "تغییرات اعمال‌شده در :mod:`pydoc` و :mod:`inspect` باعث شده‌اند امضاهای گزارش‌شده برای اشیای فراخوانی‌پذیر اکنون کامل‌تر و سازگارتر باشند."

msgid "Convert an integer number to a lowercase hexadecimal string prefixed with \"0x\". If *integer* is not a Python :class:`int` object, it has to define an :meth:`~object.__index__` method that returns an integer. Some examples:"

msgstr "یک عدد صحیح را به یک رشته‌ی مبنای شانزده کوچک‌حرف با پیشوند «0x» تبدیل می‌کند. اگر *integer* یک شیء از نوع :class:`int` پایتون نباشد، باید متدی به نام :meth:`~object.__index__` تعریف کند که یک عدد صحیح برمی‌گرداند. چند نمونه:"

msgid "If you want to convert an integer number to an uppercase or lower hexadecimal string with prefix or not, you can use either of the following ways:"

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

msgid "See also :func:`int` for converting a hexadecimal string to an integer using a base of 16."

msgstr "همچنین برای تبدیل یک رشته‌ی مبنای شانزده به یک عدد صحیح با استفاده از مبنای 16، به :func:`int` مراجعه کنید."

msgid "To obtain a hexadecimal string representation for a float, use the :meth:`float.hex` method."

msgstr "برای به‌دست‌آوردن نمایش شانزدهی یک عدد ممیز شناور، از متد :meth:`float.hex` استفاده کنید."

msgid "Return the \"identity\" of an object. This is an integer which is guaranteed to be unique and constant for this object during its lifetime. Two objects with non-overlapping lifetimes may have the same :func:`id` value."

msgstr "«شناسه» یک شیء را برمی‌گرداند. این مقدار یک عدد صحیح است که در طول عمر آن شیء، یکتا و ثابت بودنش تضمین شده است. دو شیء که طول عمر آن‌ها با یکدیگر هم‌پوشانی ندارد، ممکن است مقدار یکسانی از :func:`id` داشته باشند."

msgid "This is the address of the object in memory."

msgstr "این، آدرس شیء در حافظه است."

msgid "Raises an :ref:`auditing event <auditing>` ``builtins.id`` with argument ``id``."

msgstr "یک :ref:`رویداد حسابرسی <auditing>` با نام ``builtins.id`` و آرگومان ``id`` پرتاب می‌کند."

msgid "If the *prompt* argument is present, it is written to standard output without a trailing newline. The function then reads a line from input, converts it to a string (stripping a trailing newline), and returns that. When EOF is read, :exc:`EOFError` is raised. Example::"

msgstr "اگر آرگومان *prompt* ارائه شود، بدون افزودن نویسه‌ی پایان خط در خروجی استاندارد نوشته می‌شود. سپس تابع یک خط از ورودی می‌خواند، آن را به یک رشته تبدیل می‌کند (با حذف نویسه‌ی پایان خط انتهایی) و همان را برمی‌گرداند. اگر به پایان پرونده برسد، استثنای :exc:`EOFError` پرتاب می‌شود. مثال::"

msgid ""

msgstr ""

msgid "If the :mod:`readline` module was loaded, then :func:`input` will use it to provide elaborate line editing and history features."

msgstr "اگر ماژول :mod:`readline` بارگذاری شده باشد، :func:`input` از آن برای فراهم کردن امکانات پیشرفته‌ی ویرایش خط و تاریخچه‌ی ورودی استفاده می‌کند."

msgid "Raises an :ref:`auditing event <auditing>` ``builtins.input`` with argument ``prompt`` before reading input"

msgstr "پیش از خواندن ورودی، یک :ref:`رویداد حسابرسی <auditing>` با نام ``builtins.input`` و آرگومان ``prompt`` پرتاب می‌کند"

msgid "Raises an :ref:`auditing event <auditing>` ``builtins.input/result`` with the result after successfully reading input."

msgstr "پس از خواندن موفقیت‌آمیز ورودی، یک :ref:`رویداد حسابرسی <auditing>` با نام ``builtins.input/result`` و نتیجه‌ی خوانده‌شده پرتاب می‌کند."

msgid "Return an integer object constructed from a number or a string, or return ``0`` if no arguments are given."

msgstr "یک شیء عدد صحیح را که از یک عدد یا یک رشته ساخته شده است برمی‌گرداند، یا اگر هیچ آرگومانی داده نشده باشد، مقدار ``0`` را برمی‌گرداند."

msgid ""

msgstr ""

msgid "If the argument defines :meth:`~object.__int__`, ``int(x)`` returns ``x.__int__()``. If the argument defines :meth:`~object.__index__`, it returns ``x.__index__()``. For floating-point numbers, this truncates towards zero."

msgstr "اگر آرگومان متد :meth:`~object.__int__` را تعریف کرده باشد، ``int(x)`` مقدار ``x.__int__()`` را برمی‌گرداند. اگر آرگومان متد :meth:`~object.__index__` را تعریف کرده باشد، مقدار ``x.__index__()`` برگردانده می‌شود. برای اعداد ممیز شناور، این تبدیل بخش اعشاری را در جهت صفر حذف می‌کند."

msgid "If the argument is not a number or if *base* is given, then it must be a string, :class:`bytes`, or :class:`bytearray` instance representing an integer in radix *base*. Optionally, the string can be preceded by ``+`` or ``-`` (with no space in between), have leading zeros, be surrounded by whitespace, and have single underscores interspersed between digits."

msgstr "اگر آرگومان یک عدد نباشد یا *base* داده شده باشد، باید یک نمونه از رشته، :class:`bytes` یا :class:`bytearray` باشد که یک عدد صحیح را در مبنای *base* نشان می‌دهد. رشته می‌تواند به‌طور اختیاری با ``+`` یا ``-`` (بدون فاصله بین آن‌ها و عدد)، با صفرهای ابتدایی، دربرگرفته‌شده با فاصله‌های سفید، و با زیرخط‌های منفرد در میان رقم‌ها باشد."

msgid "A base-n integer string contains digits, each representing a value from 0 to n-1. The values 0--9 can be represented by any Unicode decimal digit. The values 10--35 can be represented by ``a`` to ``z`` (or ``A`` to ``Z``). The default *base* is 10. The allowed bases are 0 and 2--36. Base-2, -8, and -16 strings can be optionally prefixed with ``0b``/``0B``, ``0o``/``0O``, or ``0x``/``0X``, as with integer literals in code. For base 0, the string is interpreted in a similar way to an :ref:`integer literal in code <integers>`, in that the actual base is 2, 8, 10, or 16 as determined by the prefix. Base 0 also disallows leading zeros: ``int('010', 0)`` is not legal, while ``int('010')`` and ``int('010', 8)`` are."

msgstr "یک رشته‌ی عدد صحیح در مبنای n شامل رقم‌هایی است که هر یک مقداری بین 0 تا n-1 را نمایش می‌دهند. مقادیر 0 تا 9 را می‌توان با هر رقم ده‌دهی یونیکد نمایش داد. مقادیر 10 تا 35 را می‌توان با نویسه‌های ``a`` تا ``z`` (یا ``A`` تا ``Z``) نمایش داد. مقدار پیش‌فرض *base* برابر 10 است. مبناهای مجاز عبارت‌اند از 0 و 2 تا 36. رشته‌های مبنای 2، 8 و 16 می‌توانند، همانند ثابت‌های عدد صحیح در کد، به‌ترتیب با پیشوندهای ``0b``/``0B``، ``0o``/``0O`` یا ``0x``/``0X`` آغاز شوند. برای مبنای 0، رشته مشابه یک :ref:`ثابت عدد صحیح در کد <integers>` تفسیر می‌شود؛ یعنی مبنای واقعی بر اساس پیشوند، یکی از 2، 8، 10 یا 16 خواهد بود. همچنین در مبنای 0 استفاده از صفرهای ابتدایی مجاز نیست؛ بنابراین ``int('010', 0)`` معتبر نیست، در حالی که ``int('010')`` و ``int('010', 8)`` معتبر هستند."

msgid "The integer type is described in :ref:`typesnumeric`."

msgstr "نوع عدد صحیح (integer) در :ref:`typesnumeric` توضیح داده شده است."

msgid "If *base* is not an instance of :class:`int` and the *base* object has a :meth:`base.__index__ <object.__index__>` method, that method is called to obtain an integer for the base. Previous versions used :meth:`base.__int__ <object.__int__>` instead of :meth:`base.__index__ <object.__index__>`."

msgstr "اگر *base* نمونه‌ای از :class:`int` نباشد و شیء *base* متد :meth:`base.__index__ <object.__index__>` را تعریف کرده باشد، آن متد برای به‌دست آوردن یک عدد صحیح به‌عنوان مبنا فراخوانی می‌شود. در نسخه‌های پیشین، به‌جای :meth:`base.__index__ <object.__index__>` از :meth:`base.__int__ <object.__int__>` استفاده می‌شد."

msgid "The first parameter is now positional-only."

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

msgid "Falls back to :meth:`~object.__index__` if :meth:`~object.__int__` is not defined."

msgstr "اگر :meth:`~object.__int__` تعریف نشده باشد، به :meth:`~object.__index__` بازمی‌گردد."

msgid ":class:`int` string inputs and string representations can be limited to help avoid denial of service attacks. A :exc:`ValueError` is raised when the limit is exceeded while converting a string to an :class:`int` or when converting an :class:`int` into a string would exceed the limit. See the :ref:`integer string conversion length limitation <int_max_str_digits>` documentation."

msgstr "ورودی‌های رشته‌ای :class:`int` و نمایش‌های رشته‌ای آن را می‌توان برای کمک به جلوگیری از حملات منع سرویس (Denial of Service) محدود کرد. اگر هنگام تبدیل یک رشته به :class:`int` از این محدودیت فراتر رود، یا تبدیل یک :class:`int` به رشته باعث عبور از این محدودیت شود، استثنای :exc:`ValueError` پرتاب می‌شود. برای اطلاعات بیشتر، مستندات :ref:`محدودیت طول تبدیل رشته‌ای اعداد صحیح <int_max_str_digits>` را ببینید."

msgid ":func:`int` no longer delegates to the :meth:`~object.__trunc__` method."

msgstr ":func:`int` دیگر فراخوانی را به متد :meth:`~object.__trunc__` واگذار نمی‌کند."

msgid "Return ``True`` if the *object* argument is an instance of the *classinfo* argument, or of a (direct, indirect, or :term:`virtual <abstract base class>`) subclass thereof. If *object* is not an object of the given type, the function always returns ``False``. If *classinfo* is a tuple of type objects (or recursively, other such tuples) or a :ref:`types-union` of multiple types, return ``True`` if *object* is an instance of any of the types. If *classinfo* is not a type or tuple of types and such tuples, a :exc:`TypeError` exception is raised. :exc:`TypeError` may not be raised for an invalid type if an earlier check succeeds."

msgstr "اگر آرگومان *object* نمونه‌ای از *classinfo* یا از یکی از زیرکلاس‌های آن (مستقیم، غیرمستقیم یا :term:`مجازی <abstract base class>`) باشد، مقدار ``True`` را برمی‌گرداند. اگر *object* از نوع داده‌شده نباشد، این تابع همیشه ``False`` برمی‌گرداند. اگر *classinfo* یک تاپل از نوع‌ها (یا به‌صورت بازگشتی، تاپل‌هایی از این نوع) یا یک :ref:`types-union` از چندین نوع باشد، در صورتی که *object* نمونه‌ای از هر یک از آن نوع‌ها باشد، مقدار ``True`` برگردانده می‌شود. اگر *classinfo* یک نوع، یا تاپلی از نوع‌ها و تاپل‌های مشابه نباشد، استثنای :exc:`TypeError` پرتاب می‌شود. با این حال، اگر یک بررسیِ زودتر با موفقیت انجام شود، ممکن است برای یک نوع نامعتبر استثنای :exc:`TypeError` پرتاب نشود."

msgid "*classinfo* can be a :ref:`types-union`."

msgstr "*classinfo* می‌تواند یک :ref:`types-union` باشد."

msgid "Return ``True`` if *class* is a subclass (direct, indirect, or :term:`virtual <abstract base class>`) of *classinfo*. A class is considered a subclass of itself. *classinfo* may be a tuple of class objects (or recursively, other such tuples) or a :ref:`types-union`, in which case return ``True`` if *class* is a subclass of any entry in *classinfo*. In any other case, a :exc:`TypeError` exception is raised."

msgstr "اگر *class* زیرکلاس (مستقیم، غیرمستقیم یا :term:`مجازی <abstract base class>`) *classinfo* باشد، مقدار ``True`` را برمی‌گرداند. هر کلاس، زیرکلاس خودش نیز در نظر گرفته می‌شود. *classinfo* می‌تواند یک تاپل از اشیای کلاس (یا به‌صورت بازگشتی، تاپل‌هایی از این نوع) یا یک :ref:`types-union` باشد؛ در این صورت، اگر *class* زیرکلاس هر یک از اعضای *classinfo* باشد، مقدار ``True`` برگردانده می‌شود. در هر حالت دیگر، استثنای :exc:`TypeError` پرتاب می‌شود."

msgid "Return an :term:`iterator` object. The first argument is interpreted very differently depending on the presence of the second argument. Without a second argument, the single argument must be a collection object which supports the :term:`iterable` protocol (the :meth:`~object.__iter__` method), or it must support the sequence protocol (the :meth:`~object.__getitem__` method with integer arguments starting at ``0``). If it does not support either of those protocols, :exc:`TypeError` is raised. If the second argument, *sentinel*, is given, then the first argument must be a callable object. The iterator created in this case will call *callable* with no arguments for each call to its :meth:`~iterator.__next__` method; if the value returned is equal to *sentinel*, :exc:`StopIteration` will be raised, otherwise the value will be returned."

msgstr "یک شیء :term:`پیمایش‌گر <iterator>` را برمی‌گرداند. تفسیر آرگومان اول به وجود یا عدم وجود آرگومان دوم بستگی دارد. اگر آرگومان دومی وجود نداشته باشد، آرگومان اول باید یک شیء مجموعه باشد که از پروتکل :term:`پیمایش‌پذیر <iterable>` (متد :meth:`~object.__iter__`) پشتیبانی کند، یا از پروتکل دنباله (متد :meth:`~object.__getitem__` با آرگومان‌های صحیح که از ``0`` شروع می‌شوند) پشتیبانی کند. اگر از هیچ‌یک از این پروتکل‌ها پشتیبانی نکند، استثنای :exc:`TypeError` پرتاب می‌شود. اگر آرگومان دوم، یعنی *sentinel*، ارائه شود، آرگومان اول باید یک شیء فراخوانی‌پذیر باشد. پیمایش‌گر ایجادشده در این حالت، در هر فراخوانی متد :meth:`~iterator.__next__`، *callable* را بدون آرگومان فراخوانی می‌کند؛ اگر مقدار بازگردانده‌شده برابر *sentinel* باشد، استثنای :exc:`StopIteration` پرتاب می‌شود؛ در غیر این صورت، همان مقدار برگردانده می‌شود."

msgid "See also :ref:`typeiter`."

msgstr "همچنین به :ref:`typeiter` مراجعه کنید."

msgid "One useful application of the second form of :func:`iter` is to build a block-reader. For example, reading fixed-width blocks from a binary database file until the end of file is reached::"

msgstr "یکی از کاربردهای مفید شکل دوم :func:`iter`، ساختن یک خواننده‌ی بلوکی (block reader) است. برای مثال، خواندن بلوک‌هایی با اندازه‌ی ثابت از یک پرونده‌ی پایگاه داده‌ی دودویی تا رسیدن به انتهای پرونده::"

msgid ""

msgstr ""

msgid "Return the length (the number of items) of an object. The argument may be a sequence (such as a string, bytes, tuple, list, or range) or a collection (such as a dictionary, set, or frozen set)."

msgstr "طول یک شیء (تعداد عناصر آن) را برمی‌گرداند. آرگومان می‌تواند یک دنباله (مانند رشته، bytes، تاپل، فهرست یا range) یا یک مجموعه (مانند دیکشنری، set یا frozenset) باشد."

msgid "``len`` raises :exc:`OverflowError` on lengths larger than :data:`sys.maxsize`, such as :class:`range(2 ** 100) <range>`."

msgstr "``len`` برای طول‌هایی بزرگ‌تر از :data:`sys.maxsize`، مانند :class:`range(2 ** 100) <range>`، استثنای :exc:`OverflowError` پرتاب می‌کند."

msgid "Rather than being a function, :class:`list` is actually a mutable sequence type, as documented in :ref:`typesseq-list` and :ref:`typesseq`."

msgstr ":class:`list` در واقع یک نوع دنباله‌ی تغییرپذیر است، نه یک تابع؛ همان‌گونه که در :ref:`typesseq-list` و :ref:`typesseq` مستند شده است."

msgid "Return a mapping object representing the current local symbol table, with variable names as the keys, and their currently bound references as the values."

msgstr "یک شیء نگاشتی را برمی‌گرداند که جدول نمادهای محلی فعلی را نمایش می‌دهد؛ در آن، نام متغیرها کلیدها و ارجاع‌های فعلی آن‌ها مقادیر هستند."

msgid "At module scope, as well as when using :func:`exec` or :func:`eval` with a single namespace, this function returns the same namespace as :func:`globals`."

msgstr "در محدوده‌ی ماژول، و همچنین هنگام استفاده از :func:`exec` یا :func:`eval` با یک فضای نام واحد، این تابع همان فضای نامی را برمی‌گرداند که :func:`globals` برمی‌گرداند."

msgid "At class scope, it returns the namespace that will be passed to the metaclass constructor."

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

msgid "When using ``exec()`` or ``eval()`` with separate local and global arguments, it returns the local namespace passed in to the function call."

msgstr "هنگام استفاده از ``exec()`` یا ``eval()`` با آرگومان‌های محلی و سراسریِ جداگانه، این تابع فضای نام محلیِ ارسال‌شده به فراخوانی تابع را بازمی‌گرداند."

msgid "In all of the above cases, each call to ``locals()`` in a given frame of execution will return the *same* mapping object. Changes made through the mapping object returned from ``locals()`` will be visible as assigned, reassigned, or deleted local variables, and assigning, reassigning, or deleting local variables will immediately affect the contents of the returned mapping object."

msgstr "در همه‌ی حالت‌های بالا، هر فراخوانی ``locals()`` در یک فریممشخص از اجرا، *همان* شیء نگاشتی را برمی‌گرداند. تغییراتی که از طریق شیء نگاشتیِ بازگردانده‌شده توسط ``locals()`` اعمال شوند، به‌صورت انتساب، انتساب مجدد یا حذف متغیرهای محلی قابل مشاهده خواهند بود، و انتساب، انتساب مجدد یا حذف متغیرهای محلی نیز بلافاصله محتوای شیء نگاشتیِ بازگردانده‌شده را تغییر می‌دهد."

msgid "In an :term:`optimized scope` (including functions, generators, and coroutines), each call to ``locals()`` instead returns a fresh dictionary containing the current bindings of the function's local variables and any nonlocal cell references. In this case, name binding changes made via the returned dict are *not* written back to the corresponding local variables or nonlocal cell references, and assigning, reassigning, or deleting local variables and nonlocal cell references does *not* affect the contents of previously returned dictionaries."

msgstr "در یک :term:`محدوده‌ی بهینه‌شده <optimized scope>` (از جمله توابع، تولیدگرها و هم‌روال‌ها)، هر فراخوانی ``locals()`` یک دیکشنری جدید برمی‌گرداند که شامل انتساب‌های فعلی متغیرهای محلی تابع و هرگونه ارجاع به سلول‌های غیرمحلی است. در این حالت، تغییرات انتساب نام که از طریق دیکشنری بازگردانده‌شده انجام شوند، به متغیرهای محلی یا ارجاع‌های سلول‌های غیرمحلی متناظر بازنویسی *نمی‌شوند*، و انتساب، انتساب مجدد یا حذف متغیرهای محلی و ارجاع‌های سلول‌های غیرمحلی نیز بر محتوای دیکشنری‌های بازگردانده‌شده‌ی قبلی تأثیری *ندارد*."

msgid "Calling ``locals()`` as part of a comprehension in a function, generator, or coroutine is equivalent to calling it in the containing scope, except that the comprehension's initialised iteration variables will be included. In other scopes, it behaves as if the comprehension were running as a nested function."

msgstr "فراخوانی ``locals()`` درون یک comprehension در یک تابع، تولیدگر یا هم‌روال، معادل فراخوانی آن در محدوده‌ی دربرگیرنده است، با این تفاوت که متغیرهای پیمایشِ مقداردهی‌شده‌ی comprehension نیز در آن گنجانده می‌شوند. در سایر محدوده‌ها رفتار آن به‌گونه‌ای است که گویی comprehension به‌صورت یک تابع تودرتو اجرا می‌شود."

msgid "Calling ``locals()`` as part of a generator expression is equivalent to calling it in a nested generator function."

msgstr "فراخوانی ``locals()`` درون یک عبارت تولیدگر معادل فراخوانی آن در یک تابع تولیدگر تودرتو است."

msgid "The behaviour of ``locals()`` in a comprehension has been updated as described in :pep:`709`."

msgstr "رفتار ``locals()`` در comprehensionها مطابق :pep:`709` به‌روزرسانی شده است."

msgid "As part of :pep:`667`, the semantics of mutating the mapping objects returned from this function are now defined. The behavior in :term:`optimized scopes <optimized scope>` is now as described above. Aside from being defined, the behaviour in other scopes remains unchanged from previous versions."

msgstr "به‌عنوان بخشی از :pep:`667`، اکنون معناشناسی تغییر دادن اشیای نگاشتی که این تابع برمی‌گرداند، تعریف شده است. رفتار این تابع در :term:`محدوده‌های بهینه‌شده <optimized scope>` اکنون همان‌گونه است که در بالا توضیح داده شد. به‌جز تعریف رسمی این رفتار، عملکرد آن در سایر محدوده‌ها نسبت به نسخه‌های پیشین تغییری نکرده است."

msgid "Return an iterator that applies *function* to every item of *iterable*, yielding the results. If additional *iterables* arguments are passed, *function* must take that many arguments and is applied to the items from all iterables in parallel. With multiple iterables, the iterator stops when the shortest iterable is :term:`exhausted`. If *strict* is ``True`` and one of the iterables is exhausted before the others, a :exc:`ValueError` is raised. For cases where the function inputs are already arranged into argument tuples, see :func:`itertools.starmap`."

msgstr "یک پیمایش‌گر برگردانید که *function* را به هر *item* از *iterable* اعمال می‌کند و نتایج را تولید می‌کند. اگر آرگومان‌های *iterables* اضافه‌ای داده شوند، *function* باید آن تعداد آرگومان بپذیرد و به آیتم‌های تمام پیمایش‌پذیرها به صورت موازی اعمال شود. با چند پیمایش‌پذیر، پیمایش‌گر زمانی متوقف می‌شود که کوتاه‌ترین پیمایش‌پذیر :term:`به پایان رسیده <exhausted>` شود. اگر *strict* برابر ``True`` باشد و یکی از پیمایش‌پذیرها قبل از بقیه به پایان برسد، یک :exc:`ValueError` تولید می‌شود. برای مواردی که ورودی‌های تابع قبلاً در تاپل‌های آرگومان دستبند شده‌اند، به :func:`itertools.starmap` مراجعه کنید."

msgid "Added the *strict* parameter."

msgstr "پارامتر *strict* اضافه شد."

msgid "Return the largest item in an iterable or the largest of two or more arguments."

msgstr "بزرگ‌ترین عنصر یک پیمایش‌پذیر، یا بزرگ‌ترین مقدار از میان دو یا چند آرگومان را برمی‌گرداند."

msgid "If one positional argument is provided, it should be an :term:`iterable`. The largest item in the iterable is returned. If two or more positional arguments are provided, the largest of the positional arguments is returned."