string.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# Danial Behzadi <dani.behzi@ubuntu.com>, 2025
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2026-09-14 09:49+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 ":mod:`!string` --- Common string operations"
msgstr ":mod:`!string` --- عملیات رایج رشته‌ها"

msgid "**Source code:** :source:`Lib/string/__init__.py`"
msgstr "**کد منبع:** :source:`Lib/string/__init__.py`"

msgid ":ref:`textseq`"
msgstr ":ref:`textseq`"

msgid ":ref:`string-methods`"
msgstr ":ref:`string-methods`"

msgid "String constants"
msgstr "ثابت‌های رشته‌ای"

msgid "The constants defined in this module are:"
msgstr "ثابت‌های تعریف‌شده در این ماژول عبارتند از:"

msgid "The concatenation of the :const:`ascii_lowercase` and :const:`ascii_uppercase` constants described below.  This value is not locale-dependent."
msgstr "الحاق ثابت‌های :const:`ascii_lowercase` و :const:`ascii_uppercase` که در ادامه شرح داده شده‌اند. این مقدار به locale وابسته نیست."

msgid "The lowercase letters ``'abcdefghijklmnopqrstuvwxyz'``.  This value is not locale-dependent and will not change."
msgstr "حروف کوچک ``'abcdefghijklmnopqrstuvwxyz'``. این مقدار وابسته به locale نیست و تغییر نخواهد کرد."

msgid "The uppercase letters ``'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``.  This value is not locale-dependent and will not change."
msgstr "حروف بزرگ ``'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``. این مقدار به locale وابسته نیست و تغییر نخواهد کرد."

msgid "The string ``'0123456789'``."
msgstr "رشته ``'0123456789'``."

msgid "The string ``'0123456789abcdefABCDEF'``."
msgstr "رشته ``'0123456789abcdefABCDEF'``."

msgid "The string ``'01234567'``."
msgstr "رشته ``'01234567'``."

msgid "String of ASCII characters which are considered punctuation characters in the ``C`` locale: ``!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~``."
msgstr "رشته‌ای از نویسه‌های ASCII که در منطقه‌ی ``C`` نویسه‌های علائم نگارشی محسوب می‌شوند: ``!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~``."

msgid "String of ASCII characters which are considered printable by Python. This is a combination of :const:`digits`, :const:`ascii_letters`, :const:`punctuation`, and :const:`whitespace`."
msgstr "رشته‌ای از نویسه‌های ASCII که از نظر پایتون قابل‌چاپ محسوب می‌شوند. این، ترکیبی از :const:`digits`، :const:`ascii_letters`، :const:`punctuation` و :const:`whitespace` است."

msgid "By design, :meth:`string.printable.isprintable() <str.isprintable>` returns :const:`False`. In particular, ``string.printable`` is not printable in the POSIX sense (see :manpage:`LC_CTYPE <locale(5)>`)."
msgstr "بر اساس طراحی، :meth:`string.printable.isprintable() <str.isprintable>` :const:`False` را برمی‌گرداند. به‌ویژه، ``string.printable`` در معنای POSIX قابل چاپ نیست (به :manpage:`LC_CTYPE <locale(5)>` مراجعه کنید)."

msgid "A string containing all ASCII characters that are considered whitespace. This includes the characters space, tab, linefeed, return, formfeed, and vertical tab."
msgstr "رشته‌ای شامل تمام نویسه‌های ASCII که فضای خالی محسوب می‌شوند. این شامل نویسه‌های فاصله، تب، تغذیه‌ی سطر، بازگشت، تغذیه‌ی صفحه و تب عمودی است."

msgid "Custom string formatting"
msgstr "قالب‌بندی سفارشی رشته"

msgid "The built-in string class provides the ability to do complex variable substitutions and value formatting via the :meth:`~str.format` method described in :pep:`3101`.  The :class:`Formatter` class in the :mod:`!string` module allows you to create and customize your own string formatting behaviors using the same implementation as the built-in :meth:`~str.format` method."
msgstr "کلاس رشته‌ی توکار امکان انجام جایگزینی‌های پیچیده‌ی متغیرها و قالب‌بندی مقدار را از طریق متد :meth:`~str.format` که در :pep:`3101` توضیح داده شده است، فراهم می‌کند. کلاس :class:`Formatter` در ماژول :mod:`!string` به شما امکان می‌دهد رفتارهای قالب‌بندی رشته‌ی خودتان را با استفاده از همان پیاده‌سازی متد توکار :meth:`~str.format` ایجاد و سفارشی‌سازی کنید."

msgid "The :class:`Formatter` class has the following public methods:"
msgstr "کلاس :class:`Formatter` دارای متدهای عمومی زیر است:"

msgid "The primary API method.  It takes a format string and an arbitrary set of positional and keyword arguments. It is just a wrapper that calls :meth:`vformat`."
msgstr "متد اصلی API. این متد یک رشته‌ی قالب و مجموعه‌ای دلخواه از آرگومان‌های جایگاهی و کلیدواژه‌ای را دریافت می‌کند. این متد صرفاً یک دربرگیرنده است که :meth:`vformat` را فراخوانی می‌کند."

msgid "A format string argument is now :ref:`positional-only <positional-only_parameter>`."
msgstr "آرگومان رشته‌ی قالب اکنون :ref:`فقط جایگاهی <positional-only_parameter>` است."

msgid "This function does the actual work of formatting.  It is exposed as a separate function for cases where you want to pass in a predefined dictionary of arguments, rather than unpacking and repacking the dictionary as individual arguments using the ``*args`` and ``**kwargs`` syntax.  :meth:`vformat` does the work of breaking up the format string into character data and replacement fields.  It calls the various methods described below."
msgstr "این تابع کار اصلی قالب‌بندی را انجام می‌دهد. این تابع به‌عنوان یک تابع جداگانه در دسترس قرار داده شده است برای حالت‌هایی که می‌خواهید یک دیکشنری از پیش تعریف‌شده از آرگومان‌ها را ارسال کنید، به‌جای آنکه دیکشنری را با استفاده از سینتکس ``*args`` و ``**kwargs`` به آرگومان‌های جداگانه واگشایی و بسته‌بندی مجدد کنید. :meth:`vformat` کار شکستن رشته قالب به داده‌های نویسه‌ای و فیلدهای جایگزینی را انجام می‌دهد. این تابع متدهای مختلفی را که در ادامه توضیح داده شده‌اند فراخوانی می‌کند."

msgid "In addition, the :class:`Formatter` defines a number of methods that are intended to be replaced by subclasses:"
msgstr "علاوه بر این، :class:`Formatter` تعدادی متد را تعریف می‌کند که در نظر گرفته شده‌اند تا توسط زیرکلاس‌ها جایگزین شوند:"

msgid "Loop over the format_string and return an iterable of tuples (*literal_text*, *field_name*, *format_spec*, *conversion*).  This is used by :meth:`vformat` to break the string into either literal text, or replacement fields."
msgstr "format_string را با حلقه پیمایش می‌کند و یک پیمایش‌پذیر از تاپل‌های (*literal_text*، *field_name*، *format_spec*، *conversion*) برمی‌گرداند. این مورد توسط :meth:`vformat` برای تفکیک رشته به متن ثابت یا فیلدهای جایگزینی استفاده می‌شود."

msgid "The values in the tuple conceptually represent a span of literal text followed by a single replacement field.  If there is no literal text (which can happen if two replacement fields occur consecutively), then *literal_text* will be a zero-length string.  If there is no replacement field, then the values of *field_name*, *format_spec* and *conversion* will be ``None``. The value of *field_name* is unmodified and auto-numbering of non-numbered positional fields is done by :meth:`vformat`."
msgstr "مقادیر موجود در تاپل از نظر مفهومی یک قطعه متن لفظی و به دنبال آن یک فیلد جایگزینی را نشان می‌دهند. اگر متن لفظی وجود نداشته باشد (که ممکن است در صورتی رخ دهد که دو فیلد جایگزینی به‌صورت متوالی ظاهر شوند)، *literal_text* رشته‌ای با طول صفر خواهد بود. اگر فیلد جایگزینی وجود نداشته باشد، مقادیر *field_name*، *format_spec* و *conversion* برابر ``None`` خواهند بود. مقدار *field_name* بدون تغییر باقی می‌ماند و شماره‌گذاری خودکار فیلدهای جایگاهی بدون شماره توسط :meth:`vformat` انجام می‌شود."

msgid "Given *field_name*, convert it to an object to be formatted. Auto-numbering of *field_name* returned from :meth:`parse` is done by :meth:`vformat` before calling this method.  Returns a tuple (obj, used_key). The default version takes strings of the form defined in :pep:`3101`, such as \"0[name]\" or \"label.title\". *args* and *kwargs* are as passed in to :meth:`vformat`. The return value *used_key* has the same meaning as the *key* parameter to :meth:`get_value`."
msgstr "با داشتن *field_name*، آن را به شیءای برای قالب‌بندی تبدیل می‌کند. شماره‌گذاری خودکار *field_name* بازگشتی از :meth:`parse` توسط :meth:`vformat` پیش از فراخوانی این متد انجام می‌شود. یک تاپل (obj, used_key) برمی‌گرداند. نسخه پیش‌فرض رشته‌هایی با قالب تعریف‌شده در :pep:`3101` را می‌پذیرد، مانند \"0[name]\" یا \"label.title\". *args* و *kwargs* همان مقادیری هستند که به :meth:`vformat` داده شده‌اند. مقدار بازگشتی *used_key* همان معنای پارامتر *key* در :meth:`get_value` را دارد."

msgid "Retrieve a given field value.  The *key* argument will be either an integer or a string.  If it is an integer, it represents the index of the positional argument in *args*; if it is a string, then it represents a named argument in *kwargs*."
msgstr "مقدار یک فیلد مشخص را بازیابی می‌کند. آرگومان *key* یا یک عدد صحیح است یا یک رشته. اگر عدد صحیح باشد، بیانگر اندیس آرگومان جایگاهی در *args* است؛ اگر رشته باشد، بیانگر یک آرگومان نام‌دار در *kwargs* است."

msgid "The *args* parameter is set to the list of positional arguments to :meth:`vformat`, and the *kwargs* parameter is set to the dictionary of keyword arguments."
msgstr "پارامتر *args* به فهرست آرگومان‌های جایگاهی :meth:`vformat` تنظیم می‌شود، و پارامتر *kwargs* به دیکشنری آرگومان‌های کلیدواژه‌ای تنظیم می‌شود."

msgid "For compound field names, these functions are only called for the first component of the field name; subsequent components are handled through normal attribute and indexing operations."
msgstr "برای نام‌های فیلد ترکیبی، این توابع فقط برای اولین کامپوننت نام فیلد فراخوانی می‌شوند؛ کامپوننت‌های بعدی از طریق عملیات عادی ویژگی و اندیس‌گذاری مدیریت می‌شوند."

msgid "So for example, the field expression '0.name' would cause :meth:`get_value` to be called with a *key* argument of 0.  The ``name`` attribute will be looked up after :meth:`get_value` returns by calling the built-in :func:`getattr` function."
msgstr "بنابراین برای مثال، عبارت فیلد '0.name' باعث می‌شود :meth:`get_value` با آرگومان *key* برابر ۰ فراخوانی شود. ویژگی ``name`` پس از بازگشت :meth:`get_value` با فراخوانی تابع توکار :func:`getattr` جستجو می‌شود."

msgid "If the index or keyword refers to an item that does not exist, then an :exc:`IndexError` or :exc:`KeyError` should be raised."
msgstr "اگر اندیس یا کلیدواژه به آیتمی که وجود ندارد اشاره کند، باید یک :exc:`IndexError` یا :exc:`KeyError` پرتاب شود."

msgid "Implement checking for unused arguments if desired.  The arguments to this function is the set of all argument keys that were actually referred to in the format string (integers for positional arguments, and strings for named arguments), and a reference to the *args* and *kwargs* that was passed to vformat.  The set of unused args can be calculated from these parameters.  :meth:`check_unused_args` is assumed to raise an exception if the check fails."
msgstr "در صورت تمایل، بررسی آرگومان‌های استفاده‌نشده را پیاده‌سازی کنید. آرگومان‌های این تابع مجموعه‌ای از همه کلیدهای آرگومان است که واقعاً در رشته قالب به آن‌ها ارجاع شده است (اعداد صحیح برای آرگومان‌های جایگاهی، و رشته‌ها برای آرگومان‌های نام‌دار)، به‌همراه ارجاعی به *args* و *kwargs* که به vformat ارسال شده است. مجموعه آرگومان‌های استفاده‌نشده را می‌توان از این پارامترها محاسبه کرد. فرض می‌شود :meth:`check_unused_args` در صورت ناموفق بودن بررسی، یک استثنا پرتاب می‌کند."

msgid ":meth:`format_field` simply calls the global :func:`format` built-in.  The method is provided so that subclasses can override it."
msgstr ":meth:`format_field` به‌سادگی تابع توکار سراسری :func:`format` را فراخوانی می‌کند. این متد ارائه شده است تا زیرکلاس‌ها بتوانند آن را بازنویسی کنند."

msgid "Converts the value (returned by :meth:`get_field`) given a conversion type (as in the tuple returned by the :meth:`parse` method).  The default version understands 's' (str), 'r' (repr) and 'a' (ascii) conversion types."
msgstr "مقدار (بازگشت‌داده‌شده توسط :meth:`get_field`) را با توجه به نوع تبدیل (مانند تاپل بازگشت‌داده‌شده توسط متد :meth:`parse`) تبدیل می‌کند. نسخه پیش‌فرض انواع تبدیل 's' (str)، 'r' (repr) و 'a' (ascii) را می‌شناسد."

msgid "Format string syntax"
msgstr "سینتکس رشته قالب"

msgid "The :meth:`str.format` method and the :class:`Formatter` class share the same syntax for format strings (although in the case of :class:`Formatter`, subclasses can define their own format string syntax).  The syntax is related to that of :ref:`formatted string literals <f-strings>` and :ref:`template string literals <t-strings>`, but it is less sophisticated and, in particular, does not support arbitrary expressions in interpolations."
msgstr "متد :meth:`str.format` و کلاس :class:`Formatter` سینتکس یکسانی برای رشته‌های قالب دارند (اگرچه در مورد :class:`Formatter`، زیرکلاس‌ها می‌توانند سینتکس رشته‌های قالب خود را تعریف کنند). این سینتکس با سینتکس :ref:`مقادیر لفظی رشته‌ای قالب‌بندی‌شده <f-strings>` و :ref:`مقادیر لفظی رشته‌ای الگویی <t-strings>` مرتبط است، اما کمتر پیشرفته است و به‌ویژه از عبارت‌های دلخواه در درون‌یابی‌ها پشتیبانی نمی‌کند."

msgid "Format strings contain \"replacement fields\" surrounded by curly braces ``{}``. Anything that is not contained in braces is considered literal text, which is copied unchanged to the output.  If you need to include a brace character in the literal text, it can be escaped by doubling: ``{{`` and ``}}``."
msgstr "رشته‌های قالب حاوی «فیلدهای جایگزینی» هستند که با آکولادها ``{}`` احاطه شده‌اند. هر چیزی که داخل آکولادها نباشد، متن لفظی در نظر گرفته می‌شود و بدون تغییر به خروجی رونوشت می‌شود. اگر نیاز دارید یک نویسه آکولاد را در متن لفظی بگنجانید، می‌توانید آن را با دو بار نوشتن خنثی کنید: ``{{`` و ``}}``."

msgid "The grammar for a replacement field is as follows:"
msgstr "دستور زبان یک فیلد جایگزینی به‌صورت زیر است:"

msgid "In less formal terms, the replacement field can start with a *field_name* that specifies the object whose value is to be formatted and inserted into the output instead of the replacement field. The *field_name* is optionally followed by a  *conversion* field, which is preceded by an exclamation point ``'!'``, and a *format_spec*, which is preceded by a colon ``':'``.  These specify a non-default format for the replacement value."
msgstr "به بیان غیررسمی‌تر، فیلد جایگزینی می‌تواند با یک *field_name* آغاز شود که شیءای را مشخص می‌کند که مقدار آن باید قالب‌بندی شود و به جای فیلد جایگزینی، در خروجی درج شود. پس از *field_name*، به‌اختیار یک فیلد *conversion* می‌آید که پیش از آن علامت تعجب ``'!'`` قرار دارد، و یک *format_spec* که پیش از آن دونقطه ``':'`` قرار دارد. این موارد قالبی غیرپیش‌فرض برای مقدار جایگزینی مشخص می‌کنند."

msgid "See also the :ref:`formatspec` section."
msgstr "همچنین بخش :ref:`formatspec` را ببینید."

msgid "The *field_name* itself begins with an *arg_name* that is either a number or a keyword.  If it's a number, it refers to a positional argument, and if it's a keyword, it refers to a named keyword argument. An *arg_name* is treated as a number if a call to :meth:`str.isdecimal` on the string would return true. If the numerical arg_names in a format string are 0, 1, 2, ... in sequence, they can all be omitted (not just some) and the numbers 0, 1, 2, ... will be automatically inserted in that order. Because *arg_name* is not quote-delimited, it is not possible to specify arbitrary dictionary keys (e.g., the strings ``'10'`` or ``':-]'``) within a format string. The *arg_name* can be followed by any number of index or attribute expressions. An expression of the form ``'.name'`` selects the named attribute using :func:`getattr`, while an expression of the form ``'[index]'`` does an index lookup using :meth:`~object.__getitem__`."
msgstr "خود *field_name* با یک *arg_name* آغاز می‌شود که یا یک عدد است یا یک کلیدواژه. اگر عدد باشد، به یک آرگومان جایگاهی اشاره می‌کند، و اگر کلیدواژه باشد، به یک آرگومان کلیدواژه‌ای نام‌دار اشاره می‌کند. اگر فراخوانی :meth:`str.isdecimal` روی رشته مقدار true را برگرداند، *arg_name* یک عدد در نظر گرفته می‌شود. اگر arg_nameهای عددی در یک رشته‌ی قالب به‌ترتیب ۰، ۱، ۲، ... باشند، می‌توان همه‌ی آن‌ها را حذف کرد (نه فقط برخی) و اعداد ۰، ۱، ۲، ... به‌همین ترتیب به‌صورت خودکار درج می‌شوند. از آن‌جا که *arg_name* با علامت نقل‌قول محدود نمی‌شود، نمی‌توان کلیدهای دلخواه دیکشنری (برای مثال، رشته‌های ``'10'`` یا ``':-]'``) را در یک رشته‌ی قالب مشخص کرد. پس از *arg_name* می‌تواند هر تعداد عبارت اندیس یا ویژگی بیاید. عبارتی به‌شکل ``'.name'`` ویژگی نام‌برده را با استفاده از :func:`getattr` انتخاب می‌کند، در حالی که عبارتی به‌شکل ``'[index]'`` جست‌وجوی اندیس را با استفاده از :meth:`~object.__getitem__` انجام می‌دهد."

msgid "The positional argument specifiers can be omitted for :meth:`str.format`, so ``'{} {}'.format(a, b)`` is equivalent to ``'{0} {1}'.format(a, b)``."
msgstr "مشخص‌کننده‌های آرگومان جایگاهی را می‌توان برای :meth:`str.format` حذف کرد، بنابراین ``'{} {}'.format(a, b)`` معادل ``'{0} {1}'.format(a, b)`` است."

msgid "The positional argument specifiers can be omitted for :class:`Formatter`."
msgstr "می‌توان مشخص‌کننده‌های آرگومان جایگاهی را برای :class:`Formatter` حذف کرد."

msgid "Some simple format string examples::"
msgstr "چند نمونه‌ی ساده از رشته‌های قالب::"

msgid ""
"\"First, thou shalt count to {0}\"  # References first positional argument\n"
"\"Bring me a {}\"                   # Implicitly references the first positional argument\n"
"\"From {} to {}\"                   # Same as \"From {0} to {1}\"\n"
"\"My quest is {name}\"              # References keyword argument 'name'\n"
"\"Weight in tons {0.weight}\"       # 'weight' attribute of first positional arg\n"
"\"Units destroyed: {players[0]}\"   # First element of keyword argument 'players'."
msgstr ""
"\"First, thou shalt count to {0}\"  # References first positional argument\n"
"\"Bring me a {}\"                   # Implicitly references the first positional argument\n"
"\"From {} to {}\"                   # Same as \"From {0} to {1}\"\n"
"\"My quest is {name}\"              # References keyword argument 'name'\n"
"\"Weight in tons {0.weight}\"       # 'weight' attribute of first positional arg\n"
"\"Units destroyed: {players[0]}\"   # First element of keyword argument 'players'."

msgid "The *conversion* field causes a type coercion before formatting.  Normally, the job of formatting a value is done by the :meth:`~object.__format__` method of the value itself.  However, in some cases it is desirable to force a type to be formatted as a string, overriding its own definition of formatting.  By converting the value to a string before calling :meth:`~object.__format__`, the normal formatting logic is bypassed."
msgstr "فیلد *conversion* باعث تبدیل نوع اجباری پیش از قالب‌بندی می‌شود. به‌طور معمول، کار قالب‌بندی یک مقدار توسط متد :meth:`~object.__format__` خود مقدار انجام می‌شود. با این حال، در برخی موارد مطلوب است که یک نوع وادار به قالب‌بندی به‌صورت رشته شود، به‌طوری که تعریف قالب‌بندی خود آن نادیده گرفته شود. با تبدیل مقدار به رشته پیش از فراخوانی :meth:`~object.__format__`، منطق قالب‌بندی معمولی دور زده می‌شود."

msgid "Three conversion flags are currently supported: ``'!s'`` which calls :func:`str` on the value, ``'!r'`` which calls :func:`repr` and ``'!a'`` which calls :func:`ascii`."
msgstr "در حال حاضر از ۳ پرچم تبدیل پشتیبانی می‌شود: ``'!s'`` که :func:`str` را بر روی مقدار فراخوانی می‌کند، ``'!r'`` که :func:`repr` را فراخوانی می‌کند و ``'!a'`` که :func:`ascii` را فراخوانی می‌کند."

msgid "Some examples::"
msgstr "برخی مثال‌ها::"

msgid ""
"\"Harold's a clever {0!s}\"        # Calls str() on the argument first\n"
"\"Bring out the holy {name!r}\"    # Calls repr() on the argument first\n"
"\"More {!a}\"                      # Calls ascii() on the argument first"
msgstr ""
"\"Harold's a clever {0!s}\"        # Calls str() on the argument first\n"
"\"Bring out the holy {name!r}\"    # Calls repr() on the argument first\n"
"\"More {!a}\"                      # Calls ascii() on the argument first"

msgid "The *format_spec* field contains a specification of how the value should be presented, including such details as field width, alignment, padding, decimal precision and so on.  Each value type can define its own \"formatting mini-language\" or interpretation of the *format_spec*."
msgstr "فیلد *format_spec* شامل مشخصاتی است که چگونگی نمایش مقدار را تعیین می‌کند، از جمله جزئیاتی مانند عرض فیلد، تراز، پرکننده، دقت اعشاری و غیره. هر نوع مقدار می‌تواند «زبان کوچک قالب‌بندی» یا تفسیر خاص خود از *format_spec* را تعریف کند."

msgid "Most built-in types support a common formatting mini-language, which is described in the next section."
msgstr "بیشتر انواع توکار از یک زبان کوچک قالب‌بندی مشترک پشتیبانی می‌کنند، که در بخش بعدی شرح داده شده است."

msgid "A *format_spec* field can also include nested replacement fields within it. These nested replacement fields may contain a field name, conversion flag and format specification, but deeper nesting is not allowed.  The replacement fields within the format_spec are substituted before the *format_spec* string is interpreted. This allows the formatting of a value to be dynamically specified."
msgstr "یک فیلد *format_spec* همچنین می‌تواند شامل فیلدهای جایگزینی تودرتو درون خود باشد. این فیلدهای جایگزینی تودرتو ممکن است شامل نام فیلد، پرچم تبدیل و مشخصات قالب باشند، اما تودرتوسازی عمیق‌تر مجاز نیست. فیلدهای جایگزینی درون format_spec پیش از تفسیر رشته‌ی *format_spec* جایگزین می‌شوند. این امکان باعث می‌شود قالب‌بندی یک مقدار به‌صورت پویا مشخص شود."

msgid "See the :ref:`formatexamples` section for some examples."
msgstr "برای چند مثال، بخش :ref:`formatexamples` را ببینید."

msgid "Format specification mini-language"
msgstr "زبان کوچک مشخصات قالب‌بندی"

msgid "\"Format specifications\" are used within replacement fields contained within a format string to define how individual values are presented (see :ref:`formatstrings`, :ref:`f-strings`, and :ref:`t-strings`). They can also be passed directly to the built-in :func:`format` function.  Each formattable type may define how the format specification is to be interpreted."
msgstr "«مشخصات قالب‌بندی» درون فیلدهای جایگزینی که در یک رشته قالب قرار دارند، استفاده می‌شوند تا چگونگی ارائه مقادیر منفرد را تعریف کنند (به :ref:`formatstrings`، :ref:`f-strings` و :ref:`t-strings` مراجعه کنید). همچنین می‌توان آن‌ها را مستقیماً به تابع توکار :func:`format` ارسال کرد. هر نوع قابل قالب‌بندی ممکن است تعریف کند که مشخصات قالب‌بندی چگونه تفسیر می‌شود."

msgid "Most built-in types implement the following options for format specifications, although some of the formatting options are only supported by the numeric types."
msgstr "بیشتر انواع توکار گزینه‌های زیر را برای مشخصات قالب‌بندی پیاده‌سازی می‌کنند، اگرچه برخی از گزینه‌های قالب‌بندی تنها توسط انواع عددی پشتیبانی می‌شوند."

msgid "A general convention is that an empty format specification produces the same result as if you had called :func:`str` on the value. A non-empty format specification typically modifies the result."
msgstr "قرارداد عمومی این است که مشخصات قالب‌بندی خالی، همان نتیجه‌ای را تولید می‌کند که گویی :func:`str` را روی مقدار فراخوانی کرده‌اید. مشخصات قالب‌بندی غیرخالی معمولاً نتیجه را تغییر می‌دهد."

msgid "The general form of a *standard format specifier* is:"
msgstr "شکل کلی یک *مشخص‌کننده قالب استاندارد* به این صورت است:"

msgid "If a valid *align* value is specified, it can be preceded by a *fill* character that can be any character and defaults to a space if omitted. It is not possible to use a literal curly brace (\"``{``\" or \"``}``\") as the *fill* character in a :ref:`formatted string literal <f-strings>` or when using the :meth:`str.format` method.  However, it is possible to insert a curly brace with a nested replacement field.  This limitation doesn't affect the :func:`format` function."
msgstr "اگر یک مقدار معتبر برای *align* مشخص شود، می‌توان پیش از آن یک نویسه *fill* قرار داد که می‌تواند هر نویسه‌ای باشد و در صورت حذف، پیش‌فرض آن نویسه فاصله است. استفاده از یک آکولاد به‌صورت لفظی (\"``{``\" یا \"``}``\") به‌عنوان نویسه *fill* در یک :ref:`اف‌استرینگ <f-strings>` یا هنگام استفاده از متد :meth:`str.format` ممکن نیست. با این حال، می‌توان یک آکولاد را با یک فیلد جایگزینی تودرتو درج کرد. این محدودیت بر تابع :func:`format` تأثیری ندارد."

msgid "The meaning of the various alignment options is as follows:"
msgstr "معنای گزینه‌های مختلف ترازبندی به شرح زیر است:"

msgid "Option"
msgstr "گزینه"

msgid "Meaning"
msgstr "معنی"

msgid "``'<'``"
msgstr "``'<'``"

msgid "Forces the field to be left-aligned within the available space (this is the default for most objects)."
msgstr "فیلد را وادار می‌کند که در فضای موجود چپ‌تراز باشد (این حالت برای بیشتر اشیاء پیش‌فرض است)."

msgid "``'>'``"
msgstr "``'>'``"

msgid "Forces the field to be right-aligned within the available space (this is the default for numbers)."
msgstr "فیلد را مجبور می‌کند که در فضای موجود راست‌چین باشد (این حالت برای اعداد پیش‌فرض است)."

msgid "``'='``"
msgstr "``'='``"

msgid "Forces the padding to be placed after the sign (if any) but before the digits.  This is used for printing fields in the form '+000000120'. This alignment option is only valid for numeric types, excluding :class:`complex`. It becomes the default for numbers when '0' immediately precedes the field width."
msgstr "قرار گرفتن پرکننده (padding) پس از علامت (در صورت وجود) و پیش از ارقام را اجباری می‌کند. این گزینه برای چاپ فیلدها در قالب '+000000120' به کار می‌رود. این گزینه‌ی تراز فقط برای انواع عددی معتبر است، به‌جز :class:`complex`. برای اعداد، هرگاه '0' بلافاصله پیش از عرض فیلد بیاید، این گزینه به‌صورت پیش‌فرض اعمال می‌شود."

msgid "``'^'``"
msgstr "``'^'``"

msgid "Forces the field to be centered within the available space."
msgstr "فیلد را وادار می‌کند که در فضای موجود وسط‌چین شود."

msgid "Note that unless a minimum field width is defined, the field width will always be the same size as the data to fill it, so that the alignment option has no meaning in this case."
msgstr "توجه داشته باشید که اگر حداقل عرض فیلد تعریف نشده باشد، عرض فیلد همیشه هم‌اندازه‌ی داده‌ای خواهد بود که آن را پر می‌کند؛ بنابراین گزینه‌ی تراز در این حالت معنایی ندارد."

msgid "The *sign* option is only valid for number types, and can be one of the following:"
msgstr "گزینه‌ی *sign* فقط برای انواع عددی معتبر است و می‌تواند یکی از موارد زیر باشد:"

msgid "``'+'``"
msgstr "``'+'``"

msgid "Indicates that a sign should be used for both positive as well as negative numbers."
msgstr "نشان می‌دهد که باید برای اعداد مثبت و همچنین منفی از علامت استفاده شود."

msgid "``'-'``"
msgstr "``'-'``"

msgid "Indicates that a sign should be used only for negative numbers (this is the default behavior)."
msgstr "نشان می‌دهد که علامت باید فقط برای اعداد منفی استفاده شود (این رفتار پیش‌فرض است)."

msgid "space"
msgstr "فاصله"

msgid "Indicates that a leading space should be used on positive numbers, and a minus sign on negative numbers."
msgstr "نشان می‌دهد که برای اعداد مثبت باید از یک فاصله در ابتدا و برای اعداد منفی از علامت منفی استفاده شود."

msgid "The ``'z'`` option coerces negative zero floating-point values to positive zero after rounding to the format precision.  This option is only valid for floating-point presentation types."
msgstr "گزینه ``'z'`` مقادیر صفر منفی ممیز شناور را پس از گرد شدن به دقت قالب، به صفر مثبت تبدیل می‌کند. این گزینه فقط برای انواع نمایش ممیز شناور معتبر است."

msgid "Added the ``'z'`` option (see also :pep:`682`)."
msgstr "گزینه ``'z'`` افزوده شد (همچنین :pep:`682` را ببینید)."

msgid "The ``'#'`` option causes the \"alternate form\" to be used for the conversion.  The alternate form is defined differently for different types.  This option is only valid for integer, float and complex types. For integers, when binary, octal, or hexadecimal output is used, this option adds the respective prefix ``'0b'``, ``'0o'``, ``'0x'``, or ``'0X'`` to the output value. For float and complex the alternate form causes the result of the conversion to always contain a decimal-point character, even if no digits follow it. Normally, a decimal-point character appears in the result of these conversions only if a digit follows it. In addition, for ``'g'`` and ``'G'`` conversions, trailing zeros are not removed from the result."
msgstr "گزینه‌ی ``'#'`` باعث می‌شود که «شکل جایگزین» برای تبدیل استفاده شود. شکل جایگزین برای انواع مختلف به‌طور متفاوتی تعریف می‌شود. این گزینه تنها برای انواع عدد صحیح، شناور و مختلط معتبر است. برای اعداد صحیح، هنگامی که خروجی به‌صورت مبنای دو، مبنای هشت یا مبنای شانزده باشد، این گزینه پیشوند مربوطه یعنی ``'0b'``، ``'0o'``، ``'0x'`` یا ``'0X'`` را به مقدار خروجی اضافه می‌کند. برای شناور و مختلط، شکل جایگزین باعث می‌شود که نتیجه‌ی تبدیل همیشه شامل یک نویسه‌ی نقطه‌ی اعشار باشد، حتی اگر هیچ رقمی پس از آن نیاید. به‌طور معمول، یک نویسه‌ی نقطه‌ی اعشار در نتیجه‌ی این تبدیل‌ها فقط در صورتی ظاهر می‌شود که رقمی پس از آن بیاید. علاوه بر این، برای تبدیل‌های ``'g'`` و ``'G'``، صفرهای پایانی از نتیجه حذف نمی‌شوند."

msgid "The *width* is a decimal integer defining the minimum total field width, including any prefixes, separators, and other formatting characters. If not specified, then the field width will be determined by the content."
msgstr "*width* یک عدد صحیح دهدهی است که حداقل عرض کل فیلد را تعریف می‌کند، شامل هرگونه پیشوند، جداکننده و سایر نویسه‌های قالب‌بندی. اگر مشخص نشده باشد، عرض فیلد توسط محتوا تعیین می‌شود."

msgid "When no explicit alignment is given, preceding the *width* field by a zero (``'0'``) character enables sign-aware zero-padding for numeric types, excluding :class:`complex`.  This is equivalent to a *fill* character of ``'0'`` with an *alignment* type of ``'='``."
msgstr "هنگامی که تراز صریحی داده نشده باشد، قرار دادن نویسه‌ی صفر (``'0'``) پیش از فیلد *width*، پدینگ صفر با در نظر گرفتن علامت را برای انواع عددی، به‌جز :class:`complex`، فعال می‌کند. این معادل نویسه‌ی *fill* برابر ``'0'`` و نوع *alignment* برابر ``'='`` است."

msgid "Preceding the *width* field by ``'0'`` no longer affects the default alignment for strings."
msgstr "قرار دادن ``'0'`` پیش از فیلد *width* دیگر بر هم‌ترازی پیش‌فرض رشته‌ها تأثیری نمی‌گذارد."

msgid "The *precision* is a decimal integer indicating how many digits should be displayed after the decimal point for presentation types ``'f'`` and ``'F'``, or before and after the decimal point for presentation types ``'g'`` or ``'G'``.  For string presentation types the field indicates the maximum field size - in other words, how many characters will be used from the field content.  The *precision* is not allowed for integer presentation types."
msgstr "*precision* یک عدد صحیح مبنای ده است که نشان می‌دهد برای انواع نمایش ``'f'`` و ``'F'`` چند رقم باید بعد از نقطه اعشار نمایش داده شوند، یا برای انواع نمایش ``'g'`` یا ``'G'`` چند رقم باید پیش و پس از نقطه اعشار نمایش داده شوند. برای انواع نمایش رشته، این فیلد حداکثر اندازه فیلد را نشان می‌دهد — به عبارت دیگر، نشان می‌دهد که چند نویسه از محتوای فیلد استفاده خواهد شد. استفاده از *precision* برای انواع نمایش عدد صحیح مجاز نیست."

msgid "The *grouping* option after *width* and *precision* fields specifies a digit group separator for the integral and fractional parts of a number respectively. It can be one of the following:"
msgstr "گزینه‌ی *grouping* پس از فیلدهای *width* و *precision*، جداکننده‌ی گروه ارقام را برای بخش‌های صحیح و کسری یک عدد به‌ترتیب مشخص می‌کند. این گزینه می‌تواند یکی از موارد زیر باشد:"

msgid "``','``"
msgstr "``','``"

msgid "Inserts a comma every 3 digits for integer presentation type ``'d'`` and floating-point presentation types, excluding ``'n'``. For other presentation types, this option is not supported."
msgstr "برای نوع نمایش عدد صحیح ``'d'`` و انواع نمایش ممیز شناور، به‌جز ``'n'``، هر ۳ رقم یک ویرگول درج می‌کند. برای سایر انواع نمایش، این گزینه پشتیبانی نمی‌شود."

msgid "``'_'``"
msgstr "``'_'``"

msgid "Inserts an underscore every 3 digits for integer presentation type ``'d'`` and floating-point presentation types, excluding ``'n'``. For integer presentation types ``'b'``, ``'o'``, ``'x'``, and ``'X'``, underscores are inserted every 4 digits. For other presentation types, this option is not supported."
msgstr "برای نوع نمایش عدد صحیح ``'d'`` و انواع نمایش ممیز شناور، به‌جز ``'n'``، به‌ازای هر ۳ رقم یک زیرخط درج می‌کند. برای انواع نمایش عدد صحیح ``'b'``، ``'o'``، ``'x'`` و ``'X'``، به‌ازای هر ۴ رقم یک زیرخط درج می‌شود. برای سایر انواع نمایش، این گزینه پشتیبانی نمی‌شود."

msgid "For a locale-aware separator, use the ``'n'`` :ref:`float presentation type <n-format-float>` or :ref:`integer presentation type <n-format-integer>` instead."
msgstr "برای جداکننده‌ی آگاه از locale، به‌جای آن از ``'n'`` :ref:`نوع نمایش عدد شناور <n-format-float>` یا :ref:`نوع نمایش عدد صحیح <n-format-integer>` استفاده کنید."

msgid "Added the ``','`` option (see also :pep:`378`)."
msgstr "گزینه ``','`` افزوده شد (همچنین :pep:`378` را ببینید)."

msgid "Added the ``'_'`` option (see also :pep:`515`)."
msgstr "گزینه‌ی ``'_'`` اضافه شد (همچنین :pep:`515` را ببینید)."

msgid "Support the *grouping* option for the fractional part."
msgstr "پشتیبانی از گزینه‌ی *grouping* برای بخش کسری."

msgid "Finally, the *type* determines how the data should be presented."
msgstr "در نهایت، *نوع* تعیین می‌کند که داده‌ها چگونه باید ارائه شوند."

msgid "The available string presentation types are:"
msgstr "انواع ارائه‌ی در دسترس برای رشته عبارتند از:"

msgid "Type"
msgstr "نوع"

msgid "``'s'``"
msgstr "``'s'``"

msgid "String format. This is the default type for strings and may be omitted."
msgstr "قالب رشته. این نوع پیش‌فرض برای رشته‌ها است و می‌توان آن را حذف کرد."

msgid "None"
msgstr "None"

msgid "The same as ``'s'``."
msgstr "همان ``'s'``."

msgid "The available integer presentation types are:"
msgstr "انواع ارائه‌ی عدد صحیح موجود عبارتند از:"

msgid "``'b'``"
msgstr "``'b'``"

msgid "Binary format. Outputs the number in base 2."
msgstr "قالب دودویی. عدد را در مبنای ۲ خروجی می‌دهد."

msgid "``'c'``"
msgstr "``'c'``"

msgid "Character. Converts the integer to the corresponding unicode character before printing."
msgstr "نویسه. عدد صحیح را پیش از چاپ به نویسه‌ی یونیکد متناظر تبدیل می‌کند."

msgid "``'d'``"
msgstr "``'d'``"

msgid "Decimal Integer. Outputs the number in base 10."
msgstr "عدد صحیح دهدهی. عدد را در مبنای ۱۰ خروجی می‌دهد."

msgid "``'o'``"
msgstr "``'o'``"

msgid "Octal format. Outputs the number in base 8."
msgstr "قالب مبنای هشت. عدد را در مبنای ۸ خروجی می‌دهد."

msgid "``'x'``"
msgstr "``'x'``"

msgid "Hex format. Outputs the number in base 16, using lower-case letters for the digits above 9."
msgstr "قالب مبنای شانزده. عدد را در مبنای ۱۶ خروجی می‌دهد و برای ارقام بزرگ‌تر از ۹ از حروف کوچک استفاده می‌کند."

msgid "``'X'``"
msgstr "``'X'``"

msgid "Hex format. Outputs the number in base 16, using upper-case letters for the digits above 9. In case ``'#'`` is specified, the prefix ``'0x'`` will be upper-cased to ``'0X'`` as well."
msgstr "قالب مبنای شانزده. عدد را در مبنای ۱۶ خروجی می‌دهد و برای ارقام بزرگ‌تر از ۹ از حروف بزرگ استفاده می‌کند. در صورتی که ``'#'`` مشخص شده باشد، پیشوند ``'0x'`` نیز به ``'0X'`` تبدیل به حروف بزرگ می‌شود."

msgid "``'n'``"
msgstr "``'n'``"

msgid "Number. This is the same as ``'d'``, except that it uses the current locale setting to insert the appropriate digit group separators. Note that the default locale is not the system locale. Depending on your use case, you may wish to set :const:`~locale.LC_NUMERIC` with :func:`locale.setlocale` before using ``'n'``."
msgstr "عدد. این همان ``'d'`` است، با این تفاوت که از تنظیمات locale برای درج جداکننده‌های مناسب گروه ارقام استفاده می‌کند. توجه داشته باشید که locale پیش‌فرض، locale سیستم نیست. بسته به مورد استفاده خود، ممکن است بخواهید پیش از استفاده از ``'n'``، :const:`~locale.LC_NUMERIC` را با :func:`locale.setlocale` تنظیم کنید."

msgid "The same as ``'d'``."
msgstr "همانند ``'d'``."

msgid "In addition to the above presentation types, integers can be formatted with the floating-point presentation types listed below (except ``'n'`` and ``None``). When doing so, :func:`float` is used to convert the integer to a floating-point number before formatting."
msgstr "علاوه بر انواع نمایش بالا، می‌توان اعداد صحیح را با انواع نمایش ممیز شناور که در زیر فهرست شده‌اند نیز قالب‌بندی کرد (به‌جز ``'n'`` و ``None``). هنگام این کار، برای تبدیل عدد صحیح به عدد ممیز شناور پیش از قالب‌بندی از :func:`float` استفاده می‌شود."

msgid "The available presentation types for :class:`float` and :class:`~decimal.Decimal` values are:"
msgstr "انواع نمایش موجود برای مقادیر :class:`float` و :class:`~decimal.Decimal` عبارتند از:"

msgid "``'e'``"
msgstr "``'e'``"

msgid "Scientific notation. For a given precision ``p``, formats the number in scientific notation with the letter 'e' separating the coefficient from the exponent. The coefficient has one digit before and ``p`` digits after the decimal point, for a total of ``p + 1`` significant digits. With no precision given, uses a precision of ``6`` digits after the decimal point for :class:`float`, and shows all coefficient digits for :class:`~decimal.Decimal`.  If ``p=0``, the decimal point is omitted unless the ``#`` option is used."
msgstr "نماد علمی. برای دقت داده‌شده ``p``، عدد را در نماد علمی با حرف 'e' که ضریب را از توان جدا می‌کند، قالب‌بندی می‌کند. ضریب یک رقم پیش از نقطه اعشار و ``p`` رقم پس از آن دارد، که در مجموع ``p + 1`` رقم معنادار می‌شود. وقتی دقتی داده نشده باشد، از دقت ``6`` رقم پس از نقطه اعشار برای :class:`float` استفاده می‌کند و تمام ارقام ضریب را برای :class:`~decimal.Decimal` نمایش می‌دهد. اگر ``p=0`` باشد، نقطه اعشار حذف می‌شود مگر اینکه گزینه ``#`` استفاده شده باشد."

msgid "For :class:`float`, the exponent always contains at least two digits, and is zero if the value is zero."
msgstr "برای :class:`float`، توان همیشه حداقل شامل دو رقم است و اگر مقدار صفر باشد، صفر خواهد بود."

msgid "``'E'``"
msgstr "``'E'``"

msgid "Scientific notation. Same as ``'e'`` except it uses an upper case 'E' as the separator character."
msgstr "نماد علمی. مانند ``'e'`` است، با این تفاوت که از 'E' بزرگ به‌عنوان نویسه‌ی جداکننده استفاده می‌کند."

msgid "``'f'``"
msgstr "``'f'``"

msgid "Fixed-point notation. For a given precision ``p``, formats the number as a decimal number with exactly ``p`` digits following the decimal point. With no precision given, uses a precision of ``6`` digits after the decimal point for :class:`float`, and uses a precision large enough to show all coefficient digits for :class:`~decimal.Decimal`.  If ``p=0``, the decimal point is omitted unless the ``#`` option is used."
msgstr "نماد نقطه‌ثابت. برای دقت داده‌شده ``p``، عدد را به‌صورت یک عدد اعشاری با دقیقاً ``p`` رقم پس از نقطه اعشار قالب‌بندی می‌کند. اگر دقتی داده نشده باشد، برای :class:`float` از دقت ``6`` رقم پس از نقطه اعشار استفاده می‌کند، و برای :class:`~decimal.Decimal` از دقتی به‌اندازه کافی زیاد برای نمایش تمام ارقام ضریب استفاده می‌کند. اگر ``p=0`` باشد، نقطه اعشار حذف می‌شود، مگر اینکه از گزینه ``#`` استفاده شده باشد."

msgid "``'F'``"
msgstr "``'F'``"

msgid "Fixed-point notation. Same as ``'f'``, but converts ``nan`` to  ``NAN`` and ``inf`` to ``INF``."
msgstr "نماد نقطه‌ثابت. مانند ``'f'``، اما ``nan`` را به ``NAN`` و ``inf`` را به ``INF`` تبدیل می‌کند."

msgid "``'g'``"
msgstr "``'g'``"

msgid "General format.  For a given precision ``p >= 1``, this rounds the number to ``p`` significant digits and then formats the result in either fixed-point format or in scientific notation, depending on its magnitude. A precision of ``0`` is treated as equivalent to a precision of ``1``."
msgstr "قالب عمومی. برای دقت داده‌شده ``p >= 1``، عدد به ``p`` رقم بامعنا گرد می‌شود و سپس نتیجه بسته به بزرگی آن، در قالب ممیز ثابت یا نماد علمی قالب‌بندی می‌شود. دقت ``0`` معادل دقت ``1`` در نظر گرفته می‌شود."

msgid "The precise rules are as follows: suppose that the result formatted with presentation type ``'e'`` and precision ``p-1`` would have exponent ``exp``.  Then, if ``m <= exp < p``, where ``m`` is -4 for floats and -6 for :class:`Decimals <decimal.Decimal>`, the number is formatted with presentation type ``'f'`` and precision ``p-1-exp``.  Otherwise, the number is formatted with presentation type ``'e'`` and precision ``p-1``. In both cases insignificant trailing zeros are removed from the significand, and the decimal point is also removed if there are no remaining digits following it, unless the ``'#'`` option is used."
msgstr "قواعد دقیق به شرح زیر است: فرض کنید نتیجه‌ای که با نوع نمایش ``'e'`` و دقت ``p-1`` قالب‌بندی شده باشد، توان ``exp`` داشته باشد. سپس، اگر ``m <= exp < p`` باشد، که در آن ``m`` برای floatها برابر با -۴ و برای :class:`Decimals <decimal.Decimal>` برابر با -۶ است، عدد با نوع نمایش ``'f'`` و دقت ``p-1-exp`` قالب‌بندی می‌شود. در غیر این صورت، عدد با نوع نمایش ``'e'`` و دقت ``p-1`` قالب‌بندی می‌شود. در هر دو حالت، صفرهای انتهایی بی‌اهمیت از بخش معنادار (significand) حذف می‌شوند، و اگر هیچ رقمی پس از آن باقی نمانده باشد، نقطه‌ی اعشار نیز حذف می‌شود، مگر آنکه از گزینه‌ی ``'#'`` استفاده شده باشد."

msgid "With no precision given, uses a precision of ``6`` significant digits for :class:`float`. For :class:`~decimal.Decimal`, the coefficient of the result is formed from the coefficient digits of the value; scientific notation is used for values smaller than ``1e-6`` in absolute value and values where the place value of the least significant digit is larger than 1, and fixed-point notation is used otherwise."
msgstr "در صورتی که دقتی مشخص نشده باشد، برای :class:`float` از دقت ``6`` رقم معنادار استفاده می‌شود. برای :class:`~decimal.Decimal`، ضریب نتیجه از ارقام ضریب مقدار تشکیل می‌شود؛ برای مقادیری که از نظر قدر مطلق کوچک‌تر از ``1e-6`` هستند و برای مقادیری که ارزش مکانی کم‌اهمیت‌ترین رقم آن‌ها بزرگ‌تر از ۱ است، از نماد علمی استفاده می‌شود و در غیر این صورت از نماد نقطه‌ثابت استفاده می‌شود."

msgid "Positive and negative infinity, positive and negative zero, and nans, are formatted as ``inf``, ``-inf``, ``0``, ``-0`` and ``nan`` respectively, regardless of the precision."
msgstr "بی‌نهایت مثبت و منفی، صفر مثبت و منفی و مقادیر NaN، صرف‌نظر از دقت، به‌ترتیب به‌صورت ``inf``، ``-inf``، ``0``، ``-0`` و ``nan`` قالب‌بندی می‌شوند."

msgid "``'G'``"
msgstr "``'G'``"

msgid "General format. Same as ``'g'`` except switches to ``'E'`` if the number gets too large. The representations of infinity and NaN are uppercased, too."
msgstr "قالب عمومی. همانند ``'g'`` است، با این تفاوت که اگر عدد بیش از حد بزرگ شود، به ``'E'`` تغییر می‌کند. نمایش بی‌نهایت و NaN نیز با حروف بزرگ است."

msgid "Number. This is the same as ``'g'``, except that it uses the current locale setting to insert the appropriate digit group separators for the integral part of a number. Note that the default locale is not the system locale. Depending on your use case, you may wish to set :const:`~locale.LC_NUMERIC` with :func:`locale.setlocale` before using ``'n'``."
msgstr "عدد. این همان ``'g'`` است، با این تفاوت که از تنظیمات locale فعلی برای درج جداکننده‌های مناسب گروه‌بندی ارقام در بخش صحیح یک عدد استفاده می‌کند. توجه داشته باشید که تنظیمات locale پیش‌فرض، تنظیمات locale سیستم نیست. بسته به مورد استفاده شما، ممکن است بخواهید پیش از استفاده از ``'n'``، :const:`~locale.LC_NUMERIC` را با :func:`locale.setlocale` تنظیم کنید."

msgid "``'%'``"
msgstr "``'%'``"

msgid "Percentage. Multiplies the number by 100 and displays in fixed (``'f'``) format, followed by a percent sign."
msgstr "درصد. عدد را در ۱۰۰ ضرب می‌کند و آن را در قالب ثابت (``'f'``) نمایش می‌دهد و به دنبال آن علامت درصد قرار می‌گیرد."

msgid "For :class:`float` this is like the ``'g'`` type, except that when fixed-point notation is used to format the result, it always includes at least one digit past the decimal point, and switches to the scientific notation when ``exp >= p - 1``.  When the precision is not specified, the latter will be as large as needed to represent the given value faithfully."
msgstr "برای :class:`float`، این مانند نوع ``'g'`` است، با این تفاوت که هنگامی که برای قالب‌بندی نتیجه از نماد نقطه‌ثابت استفاده می‌شود، همیشه حداقل یک رقم پس از نقطه اعشار را شامل می‌شود و هرگاه ``exp >= p - 1`` باشد، به نماد علمی تغییر می‌کند. وقتی دقت مشخص نشده باشد، دقت به‌اندازه‌ای خواهد بود که برای نمایش وفادارانه‌ی مقدار داده‌شده لازم است."

msgid "For :class:`~decimal.Decimal`, this is the same as either ``'g'`` or ``'G'`` depending on the value of ``context.capitals`` for the current decimal context."
msgstr "برای :class:`~decimal.Decimal`، این معادل ``'g'`` یا ``'G'`` است، بسته به مقدار ``context.capitals`` در زمینه‌ی اعشاری جاری."

msgid "The overall effect is to match the output of :func:`str` as altered by the other format modifiers."
msgstr "اثر کلی، مطابقت با خروجی :func:`str` است، همان‌گونه که توسط سایر اصلاح‌کننده‌های قالب تغییر یافته است."

msgid "The result should be correctly rounded to a given precision ``p`` of digits after the decimal point.  The rounding mode for :class:`float` matches that of the :func:`round` builtin.  For :class:`~decimal.Decimal`, the rounding mode of the current :ref:`context <decimal-context>` will be used."
msgstr "نتیجه باید به‌درستی تا دقت مشخص ``p`` رقم پس از نقطه‌ی اعشار گرد شود. حالت گرد کردن برای :class:`float` با حالت تابع توکار :func:`round` مطابقت دارد. برای :class:`~decimal.Decimal`، از حالت گرد کردن :ref:`زمینه <decimal-context>` جاری استفاده می‌شود."

msgid "The available presentation types for :class:`complex` are the same as those for :class:`float` (``'%'`` is not allowed).  Both the real and imaginary components of a complex number are formatted as floating-point numbers, according to the specified presentation type.  They are separated by the mandatory sign of the imaginary part, the latter being terminated by a ``j`` suffix.  If the presentation type is missing, the result will match the output of :func:`str` (complex numbers with a non-zero real part are also surrounded by parentheses), possibly altered by other format modifiers."
msgstr "انواع نمایش موجود برای :class:`complex` همان انواع موجود برای :class:`float` هستند (``'%'`` مجاز نیست). هر دو بخش حقیقی و موهومی یک عدد مختلط، مطابق نوع نمایش مشخص‌شده، به‌صورت اعداد ممیز شناور قالب‌بندی می‌شوند. این دو با علامت اجباری بخش موهومی از هم جدا می‌شوند و این بخش با یک پسوند ``j`` پایان می‌یابد. اگر نوع نمایش وجود نداشته باشد، نتیجه با خروجی :func:`str` مطابقت خواهد داشت (اعداد مختلط با بخش حقیقی غیرصفر نیز در پرانتز قرار می‌گیرند)، که ممکن است توسط سایر اصلاح‌کننده‌های قالب تغییر کند."

msgid "Format examples"
msgstr "نمونه‌های قالب‌بندی"

msgid "This section contains examples of the :meth:`str.format` syntax and comparison with the old ``%``-formatting."
msgstr "این بخش شامل مثال‌هایی از سینتکس :meth:`str.format` و مقایسه‌ای با قالب‌بندی قدیمی ``%`` است."

msgid "In most of the cases the syntax is similar to the old ``%``-formatting, with the addition of the ``{}`` and with ``:`` used instead of ``%``. For example, ``'%03.2f'`` can be translated to ``'{:03.2f}'``."
msgstr "در بیشتر موارد، سینتکس شبیه به قالب‌بندی قدیمی ``%`` است، با اضافه شدن ``{}`` و استفاده از ``:`` به‌جای ``%``. برای مثال، ``'%03.2f'`` را می‌توان به ``'{:03.2f}'`` تبدیل کرد."

msgid "The new format syntax also supports new and different options, shown in the following examples."
msgstr "سینتکس جدید قالب‌بندی همچنین از گزینه‌های جدید و متفاوتی پشتیبانی می‌کند که در مثال‌های زیر نشان داده شده‌اند."

msgid "Accessing arguments by position::"
msgstr "دسترسی به آرگومان‌ها بر اساس جایگاه::"

msgid ""
">>> '{0}, {1}, {2}'.format('a', 'b', 'c')\n"
"'a, b, c'\n"
">>> '{}, {}, {}'.format('a', 'b', 'c')  # 3.1+ only\n"
"'a, b, c'\n"
">>> '{2}, {1}, {0}'.format('a', 'b', 'c')\n"
"'c, b, a'\n"
">>> '{2}, {1}, {0}'.format(*'abc')      # unpacking argument sequence\n"
"'c, b, a'\n"
">>> '{0}{1}{0}'.format('abra', 'cad')   # arguments' indices can be repeated\n"
"'abracadabra'"
msgstr ""
">>> '{0}, {1}, {2}'.format('a', 'b', 'c')\n"
"'a, b, c'\n"
">>> '{}, {}, {}'.format('a', 'b', 'c')  # 3.1+ only\n"
"'a, b, c'\n"
">>> '{2}, {1}, {0}'.format('a', 'b', 'c')\n"
"'c, b, a'\n"
">>> '{2}, {1}, {0}'.format(*'abc')      # unpacking argument sequence\n"
"'c, b, a'\n"
">>> '{0}{1}{0}'.format('abra', 'cad')   # arguments' indices can be repeated\n"
"'abracadabra'"

msgid "Accessing arguments by name::"
msgstr "دسترسی به آرگومان‌ها با نام::"

msgid ""
">>> 'Coordinates: {latitude}, {longitude}'.format(latitude='37.24N', longitude='-115.81W')\n"
"'Coordinates: 37.24N, -115.81W'\n"
">>> coord = {'latitude': '37.24N', 'longitude': '-115.81W'}\n"
">>> 'Coordinates: {latitude}, {longitude}'.format(**coord)\n"
"'Coordinates: 37.24N, -115.81W'"
msgstr ""
">>> 'Coordinates: {latitude}, {longitude}'.format(latitude='37.24N', longitude='-115.81W')\n"
"'Coordinates: 37.24N, -115.81W'\n"
">>> coord = {'latitude': '37.24N', 'longitude': '-115.81W'}\n"
">>> 'Coordinates: {latitude}, {longitude}'.format(**coord)\n"
"'Coordinates: 37.24N, -115.81W'"

msgid "Accessing arguments' attributes::"
msgstr "دسترسی به ویژگی‌های آرگومان‌ها::"

msgid ""
">>> c = 3-5j\n"
">>> ('The complex number {0} is formed from the real part {0.real} '\n"
"...  'and the imaginary part {0.imag}.').format(c)\n"
"'The complex number (3-5j) is formed from the real part 3.0 and the imaginary part -5.0.'\n"
">>> class Point:\n"
"...     def __init__(self, x, y):\n"
"...         self.x, self.y = x, y\n"
"...     def __str__(self):\n"
"...         return 'Point({self.x}, {self.y})'.format(self=self)\n"
"...\n"
">>> str(Point(4, 2))\n"
"'Point(4, 2)'"
msgstr ""
">>> c = 3-5j\n"
">>> ('The complex number {0} is formed from the real part {0.real} '\n"
"...  'and the imaginary part {0.imag}.').format(c)\n"
"'The complex number (3-5j) is formed from the real part 3.0 and the imaginary part -5.0.'\n"
">>> class Point:\n"
"...     def __init__(self, x, y):\n"
"...         self.x, self.y = x, y\n"
"...     def __str__(self):\n"
"...         return 'Point({self.x}, {self.y})'.format(self=self)\n"
"...\n"
">>> str(Point(4, 2))\n"
"'Point(4, 2)'"

msgid "Accessing arguments' items::"
msgstr "دسترسی به آیتم‌های آرگومان‌ها::"

msgid ""
">>> coord = (3, 5)\n"
">>> 'X: {0[0]};  Y: {0[1]}'.format(coord)\n"
"'X: 3;  Y: 5'"
msgstr ""
">>> coord = (3, 5)\n"
">>> 'X: {0[0]};  Y: {0[1]}'.format(coord)\n"
"'X: 3;  Y: 5'"

msgid "Replacing ``%s`` and ``%r``::"
msgstr "جایگزینی ``%s`` و ``%r``::"

msgid ""
">>> \"repr() shows quotes: {!r}; str() doesn't: {!s}\".format('test1', 'test2')\n"
"\"repr() shows quotes: 'test1'; str() doesn't: test2\""
msgstr ""
">>> \"repr() shows quotes: {!r}; str() doesn't: {!s}\".format('test1', 'test2')\n"
"\"repr() shows quotes: 'test1'; str() doesn't: test2\""

msgid "Aligning the text and specifying a width::"
msgstr "تراز کردن متن و تعیین عرض::"

msgid ""
">>> '{:<30}'.format('left aligned')\n"
"'left aligned                  '\n"
">>> '{:>30}'.format('right aligned')\n"
"'                 right aligned'\n"
">>> '{:^30}'.format('centered')\n"
"'           centered           '\n"
">>> '{:*^30}'.format('centered')  # use '*' as a fill char\n"
"'***********centered***********'"
msgstr ""
">>> '{:<30}'.format('left aligned')\n"
"'left aligned                  '\n"
">>> '{:>30}'.format('right aligned')\n"
"'                 right aligned'\n"
">>> '{:^30}'.format('centered')\n"
"'           centered           '\n"
">>> '{:*^30}'.format('centered')  # use '*' as a fill char\n"
"'***********centered***********'"

msgid "Replacing ``%+f``, ``%-f``, and ``% f`` and specifying a sign::"
msgstr "جایگزینی ``%+f``، ``%-f`` و ``% f`` و تعیین علامت::"

msgid ""
">>> '{:+f}; {:+f}'.format(3.14, -3.14)  # show it always\n"
"'+3.140000; -3.140000'\n"
">>> '{: f}; {: f}'.format(3.14, -3.14)  # show a space for positive numbers\n"
"' 3.140000; -3.140000'\n"
">>> '{:-f}; {:-f}'.format(3.14, -3.14)  # show only the minus -- same as '{:f}; {:f}'\n"
"'3.140000; -3.140000'"
msgstr ""
">>> '{:+f}; {:+f}'.format(3.14, -3.14)  # show it always\n"
"'+3.140000; -3.140000'\n"
">>> '{: f}; {: f}'.format(3.14, -3.14)  # show a space for positive numbers\n"
"' 3.140000; -3.140000'\n"
">>> '{:-f}; {:-f}'.format(3.14, -3.14)  # show only the minus -- same as '{:f}; {:f}'\n"
"'3.140000; -3.140000'"

msgid "Replacing ``%x`` and ``%o`` and converting the value to different bases::"
msgstr "جایگزینی ``%x`` و ``%o`` و تبدیل مقدار به مبناهای مختلف::"

msgid ""
">>> # format also supports binary numbers\n"
">>> \"int: {0:d};  hex: {0:x};  oct: {0:o};  bin: {0:b}\".format(42)\n"
"'int: 42;  hex: 2a;  oct: 52;  bin: 101010'\n"
">>> # with 0x, 0o, or 0b as prefix:\n"
">>> \"int: {0:d};  hex: {0:#x};  oct: {0:#o};  bin: {0:#b}\".format(42)\n"
"'int: 42;  hex: 0x2a;  oct: 0o52;  bin: 0b101010'"
msgstr ""
">>> # format also supports binary numbers\n"
">>> \"int: {0:d};  hex: {0:x};  oct: {0:o};  bin: {0:b}\".format(42)\n"
"'int: 42;  hex: 2a;  oct: 52;  bin: 101010'\n"
">>> # with 0x, 0o, or 0b as prefix:\n"
">>> \"int: {0:d};  hex: {0:#x};  oct: {0:#o};  bin: {0:#b}\".format(42)\n"
"'int: 42;  hex: 0x2a;  oct: 0o52;  bin: 0b101010'"

msgid "Using the comma or the underscore as a digit group separator::"
msgstr "استفاده از ویرگول یا زیرخط به‌عنوان جداکننده گروه ارقام::"

msgid ""
">>> '{:,}'.format(1234567890)\n"
"'1,234,567,890'\n"
">>> '{:_}'.format(1234567890)\n"
"'1_234_567_890'\n"
">>> '{:_b}'.format(1234567890)\n"
"'100_1001_1001_0110_0000_0010_1101_0010'\n"
">>> '{:_x}'.format(1234567890)\n"
"'4996_02d2'\n"
">>> '{:_}'.format(123456789.123456789)\n"
"'123_456_789.12345679'\n"
">>> '{:.,}'.format(123456789.123456789)\n"
"'123456789.123,456,79'\n"
">>> '{:,._}'.format(123456789.123456789)\n"
"'123,456,789.123_456_79'"
msgstr ""
">>> '{:,}'.format(1234567890)\n"
"'1,234,567,890'\n"
">>> '{:_}'.format(1234567890)\n"
"'1_234_567_890'\n"
">>> '{:_b}'.format(1234567890)\n"
"'100_1001_1001_0110_0000_0010_1101_0010'\n"
">>> '{:_x}'.format(1234567890)\n"
"'4996_02d2'\n"
">>> '{:_}'.format(123456789.123456789)\n"
"'123_456_789.12345679'\n"
">>> '{:.,}'.format(123456789.123456789)\n"
"'123456789.123,456,79'\n"
">>> '{:,._}'.format(123456789.123456789)\n"
"'123,456,789.123_456_79'"

msgid "Expressing a percentage::"
msgstr "بیان یک درصد::"

msgid ""
">>> points = 19\n"
">>> total = 22\n"
">>> 'Correct answers: {:.2%}'.format(points/total)\n"
"'Correct answers: 86.36%'"
msgstr ""
">>> points = 19\n"
">>> total = 22\n"
">>> 'Correct answers: {:.2%}'.format(points/total)\n"
"'Correct answers: 86.36%'"

msgid "Using type-specific formatting::"
msgstr "استفاده از قالب‌بندی مختص نوع::"

msgid ""
">>> import datetime as dt\n"
">>> d = dt.datetime(2010, 7, 4, 12, 15, 58)\n"
">>> '{:%Y-%m-%d %H:%M:%S}'.format(d)\n"
"'2010-07-04 12:15:58'"
msgstr ""
">>> import datetime as dt\n"
">>> d = dt.datetime(2010, 7, 4, 12, 15, 58)\n"
">>> '{:%Y-%m-%d %H:%M:%S}'.format(d)\n"
"'2010-07-04 12:15:58'"

msgid "Nesting arguments and more complex examples::"
msgstr "آرگومان‌های تودرتو و نمونه‌های پیچیده‌تر::"

msgid ""
">>> for align, text in zip('<^>', ['left', 'center', 'right']):\n"
"...     '{0:{fill}{align}16}'.format(text, fill=align, align=align)\n"
"...\n"
"'left<<<<<<<<<<<<'\n"
"'^^^^^center^^^^^'\n"
"'>>>>>>>>>>>right'\n"
">>>\n"
">>> octets = [192, 168, 0, 1]\n"
">>> '{:02X}{:02X}{:02X}{:02X}'.format(*octets)\n"
"'C0A80001'\n"
">>> int(_, 16)\n"
"3232235521\n"
">>>\n"
">>> width = 5\n"
">>> for num in range(5,12):\n"
"...     for base in 'dXob':\n"
"...         print('{0:{width}{base}}'.format(num, base=base, width=width), end=' ')\n"
"...     print()\n"
"...\n"
"    5     5     5   101\n"
"    6     6     6   110\n"
"    7     7     7   111\n"
"    8     8    10  1000\n"
"    9     9    11  1001\n"
"   10     A    12  1010\n"
"   11     B    13  1011"
msgstr ""
">>> for align, text in zip('<^>', ['left', 'center', 'right']):\n"
"...     '{0:{fill}{align}16}'.format(text, fill=align, align=align)\n"
"...\n"
"'left<<<<<<<<<<<<'\n"
"'^^^^^center^^^^^'\n"
"'>>>>>>>>>>>right'\n"
">>>\n"
">>> octets = [192, 168, 0, 1]\n"
">>> '{:02X}{:02X}{:02X}{:02X}'.format(*octets)\n"
"'C0A80001'\n"
">>> int(_, 16)\n"
"3232235521\n"
">>>\n"
">>> width = 5\n"
">>> for num in range(5,12):\n"
"...     for base in 'dXob':\n"
"...         print('{0:{width}{base}}'.format(num, base=base, width=width), end=' ')\n"
"...     print()\n"
"...\n"
"    5     5     5   101\n"
"    6     6     6   110\n"
"    7     7     7   111\n"
"    8     8    10  1000\n"
"    9     9    11  1001\n"
"   10     A    12  1010\n"
"   11     B    13  1011"

msgid "Template strings ($-strings)"
msgstr "رشته‌های قالب ($-strings)"

msgid "The feature described here was introduced in Python 2.4; a simple templating method based upon regular expressions. It predates :meth:`str.format`, :ref:`formatted string literals <f-strings>`, and :ref:`template string literals <template-strings>`."
msgstr "این قابلیت که در اینجا توضیح داده شده است، در پایتون 2.4 معرفی شد؛ یک روش قالب‌بندی ساده مبتنی بر عبارت‌های باقاعده. این قابلیت پیش از :meth:`str.format`، :ref:`formatted string literals <f-strings>` و :ref:`template string literals <template-strings>` وجود داشته است."

msgid "It is unrelated to template string literals (t-strings), which were introduced in Python 3.14. These evaluate to  :class:`string.templatelib.Template` objects, found in the :mod:`string.templatelib` module."
msgstr "این مورد به مقادیر لفظی رشته قالبی (t-strings)، که در پایتون 3.14 معرفی شده‌اند، مربوط نمی‌شود. حاصل ارزیابی این موارد، اشیای :class:`string.templatelib.Template` است که در ماژول :mod:`string.templatelib` قرار دارند."

msgid "Template strings provide simpler string substitutions as described in :pep:`292`.  A primary use case for template strings is for internationalization (i18n) since in that context, the simpler syntax and functionality makes it easier to translate than other built-in string formatting facilities in Python.  As an example of a library built on template strings for i18n, see the `flufl.i18n <https://flufli18n.readthedocs.io/en/latest/>`_ package."
msgstr "رشته‌های الگو جایگزینی‌های رشته‌ای ساده‌تری را فراهم می‌کنند، همان‌طور که در :pep:`292` توضیح داده شده است. یکی از کاربردهای اصلی رشته‌های الگو، بین‌المللی‌سازی (i18n) است، زیرا در آن زمینه، سینتکس و قابلیت ساده‌تر، ترجمه‌ی آن‌ها را نسبت به سایر امکانات توکار قالب‌بندی رشته در پایتون آسان‌تر می‌سازد. به‌عنوان نمونه‌ای از یک کتابخانه‌ی ساخته‌شده بر پایه‌ی رشته‌های الگو برای i18n، بسته‌ی `flufl.i18n <https://flufli18n.readthedocs.io/en/latest/>`_ را ببینید."

msgid "Template strings support ``$``-based substitutions, using the following rules:"
msgstr "رشته‌های قالب از جایگزینی‌های مبتنی بر ``$`` با استفاده از قوانین زیر پشتیبانی می‌کنند:"

msgid "``$$`` is an escape; it is replaced with a single ``$``."
msgstr "``$$`` یک خنثی‌سازی است؛ با یک ``$`` جایگزین می‌شود."

msgid "``$identifier`` names a substitution placeholder matching a mapping key of ``\"identifier\"``.  By default, ``\"identifier\"`` is restricted to any case-insensitive ASCII alphanumeric string (including underscores) that starts with an underscore or ASCII letter.  The first non-identifier character after the ``$`` character terminates this placeholder specification."
msgstr "``$identifier`` نشان‌دهنده‌ی یک جای‌نگهدار جایگزینی است که با کلید نگاشت ``\"identifier\"`` مطابقت دارد. به‌طور پیش‌فرض، ``\"identifier\"`` به هر رشته‌ی الفباعددی ASCII بدون حساسیت به بزرگی و کوچکی حروف (شامل زیرسطرها) که با زیرخط یا حرف ASCII آغاز شود، محدود است. نخستین نویسه‌ی غیرشناسه پس از نویسه‌ی ``$``، مشخصات این جای‌نگهدار را پایان می‌دهد."

msgid "``${identifier}`` is equivalent to ``$identifier``.  It is required when valid identifier characters follow the placeholder but are not part of the placeholder, such as ``\"${noun}ification\"``."
msgstr "``${identifier}`` معادل ``$identifier`` است. هنگامی که نویسه‌های معتبر شناسه پس از جای‌نگهدار بیایند اما بخشی از آن نباشند، استفاده از این قالب الزامی است، مانند ``\"${noun}ification\"``."

msgid "Any other appearance of ``$`` in the string will result in a :exc:`ValueError` being raised."
msgstr "هر ظهور دیگر ``$`` در رشته، منجر به پرتاب :exc:`ValueError` خواهد شد."

msgid "The :mod:`!string` module provides a :class:`Template` class that implements these rules.  The methods of :class:`Template` are:"
msgstr "ماژول :mod:`!string` یک کلاس :class:`Template` ارائه می‌دهد که این قوانین را پیاده‌سازی می‌کند. متدهای :class:`Template` عبارتند از:"

msgid "The constructor takes a single argument which is the template string."
msgstr "سازنده یک آرگومان دریافت می‌کند که رشته‌ی الگو است."

msgid "Performs the template substitution, returning a new string.  *mapping* is any dictionary-like object with keys that match the placeholders in the template.  Alternatively, you can provide keyword arguments, where the keywords are the placeholders.  When both *mapping* and *kwds* are given and there are duplicates, the placeholders from *kwds* take precedence."
msgstr "جایگذاری قالب را انجام می‌دهد و یک رشته جدید برمی‌گرداند. *mapping* هر شیء دیکشنری‌مانندی است که کلیدهای آن با جای‌نگهدارهای قالب مطابقت دارند. به‌عنوان جایگزین، می‌توانید آرگومان‌های کلیدواژه‌ای ارائه دهید، که در آن‌ها کلیدواژه‌ها همان جای‌نگهدارها هستند. وقتی هر دو *mapping* و *kwds* داده شده باشند و جای‌نگهدارهای تکراری وجود داشته باشد، جای‌نگهدارهای *kwds* اولویت دارند."

msgid "Like :meth:`substitute`, except that if placeholders are missing from *mapping* and *kwds*, instead of raising a :exc:`KeyError` exception, the original placeholder will appear in the resulting string intact.  Also, unlike with :meth:`substitute`, any other appearances of the ``$`` will simply return ``$`` instead of raising :exc:`ValueError`."
msgstr "مانند :meth:`substitute`، با این تفاوت که اگر جای‌نگهدارها در *mapping* و *kwds* موجود نباشند، به‌جای پرتاب یک استثنای :exc:`KeyError`، جای‌نگهدار اصلی به‌صورت دست‌نخورده در رشته‌ی حاصل ظاهر خواهد شد. همچنین، برخلاف :meth:`substitute`، هر ظهور دیگرِ ``$`` صرفاً ``$`` را برمی‌گرداند، به‌جای پرتاب :exc:`ValueError`."

msgid "While other exceptions may still occur, this method is called \"safe\" because it always tries to return a usable string instead of raising an exception.  In another sense, :meth:`safe_substitute` may be anything other than safe, since it will silently ignore malformed templates containing dangling delimiters, unmatched braces, or placeholders that are not valid Python identifiers."
msgstr "اگرچه ممکن است همچنان استثناهای دیگری رخ دهند، این متد «امن» نامیده می‌شود، زیرا همیشه تلاش می‌کند به جای پرتاب استثنا، رشته‌ای قابل استفاده برگرداند. از معنایی دیگر، :meth:`safe_substitute` ممکن است هر چیزی باشد جز امن، زیرا قالب‌های نادرست حاوی جداکننده‌های معلق، آکولادهای ناهم‌خوان، یا جای‌نگهدارهایی که شناسه‌های معتبر پایتون نیستند را بی‌سرصدا نادیده می‌گیرد."

msgid "Returns ``False`` if the template has invalid placeholders that will cause :meth:`substitute` to raise :exc:`ValueError`."
msgstr "اگر قالب دارای جای‌نگهدارنده‌های نامعتبری باشد که باعث شود :meth:`substitute` یک :exc:`ValueError` پرتاب کند، ``False`` را برمی‌گرداند."

msgid "Returns a list of the valid identifiers in the template, in the order they first appear, ignoring any invalid identifiers."
msgstr "فهرستی از شناسه‌های معتبر موجود در قالب را به ترتیبی که برای نخستین بار ظاهر می‌شوند برمی‌گرداند و از هر شناسه نامعتبری چشم‌پوشی می‌کند."

msgid ":class:`Template` instances also provide one public data attribute:"
msgstr "نمونه‌های :class:`Template` همچنین یک ویژگی داده‌ای عمومی ارائه می‌دهند:"

msgid "This is the object passed to the constructor's *template* argument.  In general, you shouldn't change it, but read-only access is not enforced."
msgstr "این همان شیءای است که به آرگومان *template* سازنده داده می‌شود. به‌طور کلی، نباید آن را تغییر دهید، اما دسترسی فقط‌خواندنی اجباری نیست."

msgid "Here is an example of how to use a Template::"
msgstr "در اینجا مثالی از چگونگی استفاده از یک Template آورده شده است::"

msgid ""
">>> from string import Template\n"
">>> s = Template('$who likes $what')\n"
">>> s.substitute(who='tim', what='kung pao')\n"
"'tim likes kung pao'\n"
">>> d = dict(who='tim')\n"
">>> Template('Give $who $100').substitute(d)\n"
"Traceback (most recent call last):\n"
"...\n"
"ValueError: Invalid placeholder in string: line 1, col 11\n"
">>> Template('$who likes $what').substitute(d)\n"
"Traceback (most recent call last):\n"
"...\n"
"KeyError: 'what'\n"
">>> Template('$who likes $what').safe_substitute(d)\n"
"'tim likes $what'"
msgstr ""
">>> from string import Template\n"
">>> s = Template('$who likes $what')\n"
">>> s.substitute(who='tim', what='kung pao')\n"
"'tim likes kung pao'\n"
">>> d = dict(who='tim')\n"
">>> Template('Give $who $100').substitute(d)\n"
"Traceback (most recent call last):\n"
"...\n"
"ValueError: Invalid placeholder in string: line 1, col 11\n"
">>> Template('$who likes $what').substitute(d)\n"
"Traceback (most recent call last):\n"
"...\n"
"KeyError: 'what'\n"
">>> Template('$who likes $what').safe_substitute(d)\n"
"'tim likes $what'"

msgid "Advanced usage: you can derive subclasses of :class:`Template` to customize the placeholder syntax, delimiter character, or the entire regular expression used to parse template strings.  To do this, you can override these class attributes:"
msgstr "استفاده پیشرفته: شما می‌توانید با مشتق کردن زیرکلاس‌هایی از :class:`Template`، سینتکس جای‌نگدار، نویسه‌ی جداکننده، یا کل عبارت باقاعده‌ی مورد استفاده برای تجزیه‌ی رشته‌های قالب را سفارشی کنید. برای این کار، می‌توانید این ویژگی‌های کلاس را بازنویسی کنید:"

msgid "*delimiter* -- This is the literal string describing a placeholder introducing delimiter.  The default value is ``$``.  Note that this should *not* be a regular expression, as the implementation will call :meth:`re.escape` on this string as needed.  Note further that you cannot change the delimiter after class creation (i.e. a different delimiter must be set in the subclass's class namespace)."
msgstr "*delimiter* -- این رشته‌ی لفظی، جداکننده‌ی معرف جای‌نگهدار را توصیف می‌کند. مقدار پیش‌فرض ``$`` است. توجه داشته باشید که این *نباید* یک عبارت باقاعده باشد، زیرا پیاده‌سازی در صورت نیاز :meth:`re.escape` را روی این رشته فراخوانی می‌کند. همچنین توجه داشته باشید که نمی‌توانید جداکننده را پس از ایجاد کلاس تغییر دهید (یعنی یک جداکننده‌ی متفاوت باید در فضای نام کلاسِ زیرکلاس تنظیم شود)."

msgid "*idpattern* -- This is the regular expression describing the pattern for non-braced placeholders.  The default value is the regular expression ``(?a:[_a-z][_a-z0-9]*)``.  If this is given and *braceidpattern* is ``None`` this pattern will also apply to braced placeholders."
msgstr "*idpattern* -- این عبارت باقاعدهی است که الگوی جای‌نگهدارهای بدون آکولاد را توصیف می‌کند. مقدار پیش‌فرض، عبارت باقاعده ``(?a:[_a-z][_a-z0-9]*)`` است. اگر این مقدار داده شده باشد و *braceidpattern* برابر ``None`` باشد، این الگو برای جای‌نگهدارهای دارای آکولاد نیز اعمال خواهد شد."

msgid "Since default *flags* is ``re.IGNORECASE``, pattern ``[a-z]`` can match with some non-ASCII characters. That's why we use the local ``a`` flag here."
msgstr "از آن‌جا که *flags* پیش‌فرض ``re.IGNORECASE`` است، الگوی ``[a-z]`` می‌تواند با برخی نویسه‌های غیر ASCII تطابق داشته باشد. به همین دلیل، ما در اینجا از پرچم محلی ``a`` استفاده می‌کنیم."

msgid "*braceidpattern* can be used to define separate patterns used inside and outside the braces."
msgstr "می‌توان از *braceidpattern* برای تعریف الگوهای جداگانه‌ای که در داخل و خارج از آکولادها استفاده می‌شوند، استفاده کرد."

msgid "*braceidpattern* -- This is like *idpattern* but describes the pattern for braced placeholders.  Defaults to ``None`` which means to fall back to *idpattern* (i.e. the same pattern is used both inside and outside braces). If given, this allows you to define different patterns for braced and unbraced placeholders."
msgstr "*braceidpattern* — این مانند *idpattern* است، اما الگوی جای‌نگهدارهای دارای آکولاد را توصیف می‌کند. پیش‌فرض آن ``None`` است که به معنای بازگشت به *idpattern* است (یعنی هم داخل آکولادها و هم خارج از آن‌ها از یک الگو استفاده می‌شود). اگر داده شود، این به شما امکان می‌دهد الگوهای متفاوتی برای جای‌نگهدارهای دارای آکولاد و بدون آکولاد تعریف کنید."

msgid "*flags* -- The regular expression flags that will be applied when compiling the regular expression used for recognizing substitutions.  The default value is ``re.IGNORECASE``.  Note that ``re.VERBOSE`` will always be added to the flags, so custom *idpattern*\\ s must follow conventions for verbose regular expressions."
msgstr "*flags* -- پرچم‌های عبارت باقاعده که هنگام کامپایل عبارت باقاعده‌ی مورد استفاده برای تشخیص جایگزینی‌ها اعمال خواهند شد. مقدار پیش‌فرض ``re.IGNORECASE`` است. توجه داشته باشید که ``re.VERBOSE`` همواره به پرچم‌ها اضافه خواهد شد، بنابراین *idpattern*\\ s سفارشی باید از قراردادهای عبارت‌های باقاعده پرجزئیات (verbose) پیروی کنند."

msgid "Alternatively, you can provide the entire regular expression pattern by overriding the class attribute *pattern*.  If you do this, the value must be a regular expression pattern string, or a compiled regular expression object, with four named capturing groups.  The capturing groups correspond to the rules given above, along with the invalid placeholder rule:"
msgstr "به‌عنوان جایگزین، می‌توانید کل الگوی عبارت باقاعده را با بازنویسی ویژگی کلاس *pattern* فراهم کنید. اگر این کار را انجام دهید، مقدار باید یک رشته‌ی الگوی عبارت باقاعده یا یک شیء عبارت باقاعده‌ی کامپایل‌شده، با چهار گروه ثبت‌کننده نام‌دار باشد. گروه‌های ثبت‌کننده با قوانین بیان‌شده در بالا، به‌همراه قانون جای‌نگهدار نامعتبر، مطابقت دارند:"

msgid "*escaped* -- This group matches the escape sequence, e.g. ``$$``, in the default pattern."
msgstr "*escaped* -- این گروه با دنباله خنثی‌سازی، برای مثال ``$$``، در الگوی پیش‌فرض مطابقت دارد."

msgid "*named* -- This group matches the unbraced placeholder name; it should not include the delimiter in capturing group."
msgstr "*named* -- این گروه با نام جای‌نگهدار بدون آکولاد مطابقت دارد؛ نباید جداکننده را در گروه ثبت‌کننده بگنجاند."

msgid "*braced* -- This group matches the brace enclosed placeholder name; it should not include either the delimiter or braces in the capturing group."
msgstr "*braced* -- این گروه با نام جای‌نگهدار محصور در آکولاد مطابقت دارد؛ نباید در گروه ثبت‌کننده (capturing group) شامل جداکننده یا آکولادها باشد."

msgid "*invalid* -- This group matches any other delimiter pattern (usually a single delimiter), and it should appear last in the regular expression."
msgstr "*invalid* -- این گروه با هر الگوی جداکننده دیگری (معمولاً یک جداکننده) مطابقت دارد و باید در انتهای عبارت باقاعده قرار گیرد."

msgid "The methods on this class will raise :exc:`ValueError` if the pattern matches the template without one of these named groups matching."
msgstr "متدهای این کلاس در صورتی استثنای :exc:`ValueError` را پرتاب می‌کنند که الگو با قالب تطبیق داشته باشد، بدون این‌که یکی از این گروه‌های نام‌دار تطبیق یافته باشد."

msgid "Helper functions"
msgstr "توابع کمکی"

msgid "Split the argument into words using :meth:`str.split`, capitalize each word using :meth:`str.capitalize`, and join the capitalized words using :meth:`str.join`.  If the optional second argument *sep* is absent or ``None``, runs of whitespace characters are replaced by a single space and leading and trailing whitespace are removed, otherwise *sep* is used to split and join the words."
msgstr "آرگومان را با استفاده از :meth:`str.split` به کلمات تقسیم کنید، هر کلمه را با استفاده از :meth:`str.capitalize` حرف اول بزرگ کنید، و کلمات با حرف اول بزرگ را با استفاده از :meth:`str.join` به‌هم بپیوندید. اگر آرگومان دوم اختیاری *sep* وجود نداشته باشد یا ``None`` باشد، دنباله‌هایی از نویسه‌های فضای خالی با یک فاصله جایگزین می‌شوند و فضاهای خالی ابتدا و انتها حذف می‌شوند، در غیر این صورت از *sep* برای تقسیم و به‌هم پیوستن کلمات استفاده می‌شود."

msgid "{} (curly brackets)"
msgstr "{} (آکولاد)"

msgid "in string formatting"
msgstr "در قالب‌بندی رشته"

msgid ". (dot)"
msgstr ". (نقطه)"

msgid "[] (square brackets)"
msgstr "[] (کروشه)"

msgid "! (exclamation)"
msgstr "! (علامت تعجب)"

msgid ": (colon)"
msgstr ": (دونقطه)"

msgid "< (less)"
msgstr "< (کمتر)"

msgid "> (greater)"
msgstr "> (بزرگ‌تر)"

msgid "= (equals)"
msgstr "= (برابر)"

msgid "^ (caret)"
msgstr "^ (caret)"

msgid "+ (plus)"
msgstr "+ (به‌علاوه)"

msgid "- (minus)"
msgstr "- (منها)"

msgid "z"
msgstr "z"

msgid "# (hash)"
msgstr "# (هش)"

msgid ", (comma)"
msgstr ", (کاما)"

msgid "_ (underscore)"
msgstr "_ (زیرخط)"

msgid "$ (dollar)"
msgstr "$ (دلار)"

msgid "in template strings"
msgstr "در رشته‌های قالبی"