unicode.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 16:24+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 "Unicode Objects and Codecs"
msgstr "اشیاء یونیکد و کدک‌ها"

msgid "Unicode Objects"
msgstr "اشیاء یونیکد"

msgid "Since the implementation of :pep:`393` in Python 3.3, Unicode objects internally use a variety of representations, in order to allow handling the complete range of Unicode characters while staying memory efficient.  There are special cases for strings where all code points are below 128, 256, or 65536; otherwise, code points must be below 1114112 (which is the full Unicode range)."
msgstr "از زمان پیاده‌سازی :pep:`393` در پایتون 3.3، شیءهای یونیکد به‌طور داخلی از نمایش‌های گوناگونی استفاده می‌کنند تا امکان مدیریت کل بازه‌ی نویسه‌های یونیکد فراهم شود و در عین حال از نظر حافظه بهره‌ور باقی بمانند. برای رشته‌هایی که تمام نقطه‌کدهای آن‌ها کمتر از ۱۲۸، ۲۵۶ یا ۶۵۵۳۶ است، حالت‌های خاصی وجود دارد؛ در غیر این صورت، نقطه‌کدها باید کمتر از ۱۱۱۴۱۱۲ باشند (که بازه‌ی کامل یونیکد است)."

msgid "UTF-8 representation is created on demand and cached in the Unicode object."
msgstr "بازنمایی UTF-8 به‌هنگام نیاز ایجاد می‌شود و در نهانگاه شیء یونیکد ذخیره می‌شود."

msgid "The :c:type:`Py_UNICODE` representation has been removed since Python 3.12 with deprecated APIs. See :pep:`623` for more information."
msgstr "نمایش :c:type:`Py_UNICODE` از پایتون 3.12 همراه با APIهای منسوخ حذف شده است. برای اطلاعات بیشتر به :pep:`623` مراجعه کنید."

msgid "Unicode Type"
msgstr "نوع یونیکد"

msgid "These are the basic Unicode object types used for the Unicode implementation in Python:"
msgstr "این‌ها انواع پایه‌ای شیء یونیکد هستند که در پیاده‌سازی یونیکد در پایتون استفاده می‌شوند:"

msgid "This instance of :c:type:`PyTypeObject` represents the Python Unicode type. It is exposed to Python code as :py:class:`str`."
msgstr "این نمونه از :c:type:`PyTypeObject` نمایانگر نوع یونیکد پایتون است. این نوع در کد پایتون به‌صورت :py:class:`str` در دسترس قرار می‌گیرد."

msgid "This instance of :c:type:`PyTypeObject` represents the Python Unicode iterator type. It is used to iterate over Unicode string objects."
msgstr "این نمونه از :c:type:`PyTypeObject` نوع پیمایش‌گر یونیکد پایتون را نمایندگی می‌کند. برای پیمایش اشیاء رشته‌ی یونیکد استفاده می‌شود."

msgid "These types are typedefs for unsigned integer types wide enough to contain characters of 32 bits, 16 bits and 8 bits, respectively.  When dealing with single Unicode characters, use :c:type:`Py_UCS4`."
msgstr "این نوع‌ها تعریف‌های نوع (typedef) برای نوع‌های عدد صحیح بدون علامت‌اند که به اندازه‌ی کافی پهن هستند تا بتوانند به ترتیب نویسه‌های ۳۲ بیتی، ۱۶ بیتی و ۸ بیتی را در خود جای دهند. هنگام کار با نویسه‌های منفرد یونیکد، از :c:type:`Py_UCS4` استفاده کنید."

msgid "These subtypes of :c:type:`PyObject` represent a Python Unicode object.  In almost all cases, they shouldn't be used directly, since all API functions that deal with Unicode objects take and return :c:type:`PyObject` pointers."
msgstr "این زیرنوع‌های :c:type:`PyObject` نمایانگر یک شیء یونیکد پایتون هستند. در تقریباً همه موارد، نباید مستقیماً از آن‌ها استفاده شود، زیرا تمام توابع API که با اشیاء یونیکد سروکار دارند، اشاره‌گرهای :c:type:`PyObject` می‌گیرند و برمی‌گردانند."

msgid "The structure of a particular object can be determined using the following macros. The macros cannot fail; their behavior is undefined if their argument is not a Python Unicode object."
msgstr "ساختار یک شیء خاص را می‌توان با استفاده از ماکروهای زیر تعیین کرد. این ماکروها نمی‌توانند شکست بخورند؛ رفتار آن‌ها در صورتی که آرگومانشان یک شیء یونیکد پایتون نباشد، تعریف‌نشده است."

msgid "True if *o* uses the :c:struct:`PyCompactUnicodeObject` structure."
msgstr "درست است اگر *o* از ساختار :c:struct:`PyCompactUnicodeObject` استفاده کند."

msgid "True if *o* uses the :c:struct:`PyASCIIObject` structure."
msgstr "در صورتی که *o* از ساختار :c:struct:`PyASCIIObject` استفاده کند، درست است."

msgid "The following APIs are C macros and static inlined functions for fast checks and access to internal read-only data of Unicode objects:"
msgstr "APIهای زیر ماکروهای C و توابع درون‌خطی ایستا برای بررسی‌های سریع و دسترسی به داده‌های داخلی فقط‌خواندنی اشیاء یونیکد هستند:"

msgid "Return true if the object *obj* is a Unicode object or an instance of a Unicode subtype.  This function always succeeds."
msgstr "اگر شیء *obj* یک شیء یونیکد یا نمونه‌ای از یک زیرنوع یونیکد باشد، مقدار true برمی‌گرداند. این تابع همیشه با موفقیت انجام می‌شود."

msgid "Return true if the object *obj* is a Unicode object, but not an instance of a subtype.  This function always succeeds."
msgstr "اگر شیء *obj* یک شیء یونیکد باشد، اما نمونه‌ای از یک زیرنوع نباشد، مقدار true را برمی‌گرداند. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Return the length of the Unicode string, in code points.  *unicode* has to be a Unicode object in the \"canonical\" representation (not checked)."
msgstr "طول رشته یونیکد را بر حسب نقطه‌کد برمی‌گرداند.  *unicode* باید یک شیء یونیکد در نمایش «کانونیکال» باشد (بررسی نمی‌شود)."

msgid "Return a pointer to the canonical representation cast to UCS1, UCS2 or UCS4 integer types for direct character access.  No checks are performed if the canonical representation has the correct character size; use :c:func:`PyUnicode_KIND` to select the right function."
msgstr "اشاره‌گری به نمایش کانونیکال قالب‌ریزی‌شده به نوع‌های عدد صحیح UCS1، UCS2 یا UCS4 را برای دسترسی مستقیم به نویسه برمی‌گرداند. هیچ بررسی‌ای انجام نمی‌شود که آیا نمایش کانونیکال اندازه‌ی درست نویسه را دارد یا خیر؛ برای انتخاب تابع درست از :c:func:`PyUnicode_KIND` استفاده کنید."

msgid "Return values of the :c:func:`PyUnicode_KIND` macro."
msgstr "مقادیر بازگشتی ماکروی :c:func:`PyUnicode_KIND`."

msgid "``PyUnicode_WCHAR_KIND`` has been removed."
msgstr "``PyUnicode_WCHAR_KIND`` حذف شده است."

msgid "Return one of the PyUnicode kind constants (see above) that indicate how many bytes per character this Unicode object uses to store its data.  *unicode* has to be a Unicode object in the \"canonical\" representation (not checked)."
msgstr "یکی از ثابت‌های kind مربوط به PyUnicode (که در بالا آمده‌اند) را برمی‌گرداند که نشان می‌دهند این شیء یونیکد برای ذخیره داده‌های خود از چند بایت به ازای هر نویسه استفاده می‌کند.  *unicode* باید یک شیء یونیکد در نمایش «کانونیکال» باشد (بررسی نمی‌شود)."

msgid "Return a void pointer to the raw Unicode buffer.  *unicode* has to be a Unicode object in the \"canonical\" representation (not checked)."
msgstr "یک اشاره‌گر void به بافر خام یونیکد برمی‌گرداند. *unicode* باید یک شیء یونیکد در نمایش «کانونیکال» باشد (بررسی نمی‌شود)."

msgid "Write the code point *value* to the given zero-based *index* in a string."
msgstr "*مقدار* نقطه‌کد را در *اندیس* داده‌شده‌ی مبتنی بر صفر درون یک رشته می‌نویسد."

msgid "The *kind* value and *data* pointer must have been obtained from a string using :c:func:`PyUnicode_KIND` and :c:func:`PyUnicode_DATA` respectively. You must hold a reference to that string while calling :c:func:`!PyUnicode_WRITE`. All requirements of :c:func:`PyUnicode_WriteChar` also apply."
msgstr "مقدار *kind* و اشاره‌گر *data* باید به ترتیب از یک رشته با استفاده از :c:func:`PyUnicode_KIND` و :c:func:`PyUnicode_DATA` به‌دست آمده باشند. شما باید هنگام فراخوانی :c:func:`!PyUnicode_WRITE`، ارجاعی به آن رشته را نگه دارید. تمام الزامات :c:func:`PyUnicode_WriteChar` نیز اعمال می‌شوند."

msgid "The function performs no checks for any of its requirements, and is intended for usage in loops."
msgstr "این تابع هیچ بررسی‌ای برای هیچ‌یک از نیازمندی‌های خود انجام نمی‌دهد و برای استفاده در حلقه‌ها در نظر گرفته شده است."

msgid "Read a code point from a canonical representation *data* (as obtained with :c:func:`PyUnicode_DATA`).  No checks or ready calls are performed."
msgstr "یک نقطه‌کد را از نمایش کانونیکال *data* (که با :c:func:`PyUnicode_DATA` به دست آمده است) می‌خواند.  هیچ بررسی یا فراخوانی ready انجام نمی‌شود."

msgid "Read a character from a Unicode object *unicode*, which must be in the \"canonical\" representation.  This is less efficient than :c:func:`PyUnicode_READ` if you do multiple consecutive reads."
msgstr "یک نویسه از شیء یونیکد *unicode* می‌خواند که باید در نمایش «کانونیکال» باشد. اگر چندین خواندن متوالی انجام می‌دهید، این کارایی کمتری نسبت به :c:func:`PyUnicode_READ` دارد."

msgid "Return the maximum code point that is suitable for creating another string based on *unicode*, which must be in the \"canonical\" representation.  This is always an approximation but more efficient than iterating over the string."
msgstr "بیشینه نقطه‌کدی را برمی‌گرداند که برای ایجاد رشته‌ای دیگر بر اساس *unicode* مناسب است؛ *unicode* باید در نمایش «کانونیکال» باشد. این همیشه یک تقریب است، اما از پیمایش کردن رشته کارآمدتر است."

msgid "Return ``1`` if the string is a valid identifier according to the language definition, section :ref:`identifiers`. Return ``0`` otherwise."
msgstr "اگر رشته مطابق تعریف زبان، بخش :ref:`identifiers`، یک شناسه‌ی معتبر باشد، ``1`` را برمی‌گرداند. در غیر این صورت ``0`` را برمی‌گرداند."

msgid "The function does not call :c:func:`Py_FatalError` anymore if the string is not ready."
msgstr "اگر رشته آماده نباشد، این تابع دیگر :c:func:`Py_FatalError` را فراخوانی نمی‌کند."

msgid "Return true if the string only contains ASCII characters. Equivalent to :py:meth:`str.isascii`."
msgstr "اگر رشته فقط شامل نویسه‌های اسکی باشد، مقدار درست را برمی‌گرداند. معادل :py:meth:`str.isascii` است."

msgid "Unicode Character Properties"
msgstr "ویژگی‌های نویسه‌ی یونیکد"

msgid "Unicode provides many different character properties. The most often needed ones are available through these macros which are mapped to C functions depending on the Python configuration."
msgstr "یونیکد ویژگی‌های نویسه‌ی متعدد و گوناگونی را فراهم می‌کند. پرکاربردترین آن‌ها از طریق این ماکروها در دسترس‌اند که بسته به پیکربندی پایتون به توابع C نگاشت می‌شوند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is a whitespace character."
msgstr "بسته به این‌که *ch* یک نویسه فاصله‌ساز باشد یا نه، ``1`` یا ``0`` برمی‌گرداند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is a lowercase character."
msgstr "بسته به اینکه *ch* یک نویسه‌ی کوچک باشد یا نه، ``1`` یا ``0`` را برمی‌گرداند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is an uppercase character."
msgstr "بسته به اینکه *ch* یک نویسه‌ی بزرگ باشد یا نه، ``1`` یا ``0`` را برمی‌گرداند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is a titlecase character."
msgstr "بسته به اینکه *ch* یک نویسه‌ی عنوان‌نویسی‌شده باشد یا نه، ``1`` یا ``0`` را برمی‌گرداند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is a linebreak character."
msgstr "بسته به اینکه *ch* یک نویسه شکست سطر باشد یا نه، ``1`` یا ``0`` را برمی‌گرداند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is a decimal character."
msgstr "بسته به اینکه *ch* یک نویسه ده‌دهی باشد یا نه، ``1`` یا ``0`` را برمی‌گرداند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is a digit character."
msgstr "بسته به اینکه *ch* یک نویسه رقم باشد یا نه، ``1`` یا ``0`` را برمی‌گرداند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is a numeric character."
msgstr "بسته به این‌که *ch* یک نویسه عددی باشد یا نه، ``1`` یا ``0`` برمی‌گرداند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is an alphabetic character."
msgstr "بسته به این‌که *ch* یک نویسه الفبایی باشد یا نه، ``1`` یا ``0`` برمی‌گرداند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is an alphanumeric character."
msgstr "بسته به اینکه *ch* یک نویسه الفبایی-عددی باشد یا نه، ``1`` یا ``0`` را برمی‌گرداند."

msgid "Return ``1`` or ``0`` depending on whether *ch* is a printable character, in the sense of :meth:`str.isprintable`."
msgstr "بسته به اینکه *ch* یک نویسه‌ی چاپ‌پذیر در معنای :meth:`str.isprintable` باشد یا نه، مقدار ``1`` یا ``0`` را برمی‌گرداند."

msgid "These APIs can be used for fast direct character conversions:"
msgstr "از این APIها می‌توان برای تبدیل‌های سریع و مستقیم نویسه‌ها استفاده کرد:"

msgid "Return the character *ch* converted to lower case."
msgstr "نویسه‌ی *ch* را به حروف کوچک تبدیل‌شده برمی‌گرداند."

msgid "Return the character *ch* converted to upper case."
msgstr "نویسه *ch* را که به حروف بزرگ تبدیل شده است برمی‌گرداند."

msgid "Return the character *ch* converted to title case."
msgstr "نویسه *ch* تبدیل‌شده به نگارش عنوان‌نویسی را بازمی‌گرداند."

msgid "Return the character *ch* converted to a decimal positive integer.  Return ``-1`` if this is not possible.  This function does not raise exceptions."
msgstr "نویسه *ch* را به صورت یک عدد صحیح مثبت ده‌دهی تبدیل‌شده برمی‌گرداند. اگر این کار ممکن نباشد، ``-1`` برمی‌گرداند. این تابع استثنا ایجاد نمی‌کند."

msgid "Return the character *ch* converted to a single digit integer. Return ``-1`` if this is not possible.  This function does not raise exceptions."
msgstr "نویسه *ch* را به یک عدد صحیح تک‌رقمی تبدیل‌شده برمی‌گرداند. اگر این کار ممکن نباشد، ``-1`` برمی‌گرداند. این تابع استثنا ایجاد نمی‌کند."

msgid "Return the character *ch* converted to a double. Return ``-1.0`` if this is not possible.  This function does not raise exceptions."
msgstr "نویسه *ch* را به یک عدد ممیز شناور با دقت مضاعف تبدیل‌شده برمی‌گرداند. اگر این کار ممکن نباشد، ``-1.0`` را برمی‌گرداند.  این تابع استثنا ایجاد نمی‌کند."

msgid "These APIs can be used to work with surrogates:"
msgstr "می‌توان از این APIها برای کار با جانشین‌ها استفاده کرد:"

msgid "Check if *ch* is a surrogate (``0xD800 <= ch <= 0xDFFF``)."
msgstr "بررسی می‌کند که آیا *ch* جانشین است یا خیر (``0xD800 <= ch <= 0xDFFF``)."

msgid "Check if *ch* is a high surrogate (``0xD800 <= ch <= 0xDBFF``)."
msgstr "بررسی کنید که *ch* جانشین بالایی باشد (``0xD800 <= ch <= 0xDBFF``)."

msgid "Check if *ch* is a low surrogate (``0xDC00 <= ch <= 0xDFFF``)."
msgstr "بررسی کنید که آیا *ch* یک جانشین پایین است (``0xDC00 <= ch <= 0xDFFF``)."

msgid "Return the high UTF-16 surrogate (``0xD800`` to ``0xDBFF``) for a Unicode code point in the range ``[0x10000; 0x10FFFF]``."
msgstr "بازگرداندن جانشین بالای UTF-16 (``0xD800`` تا ``0xDBFF``) برای یک نقطه‌کد یونیکد در بازه‌ی ``[0x10000; 0x10FFFF]``."

msgid "Return the low UTF-16 surrogate (``0xDC00`` to ``0xDFFF``) for a Unicode code point in the range ``[0x10000; 0x10FFFF]``."
msgstr "جانشین پایین UTF-16 (``0xDC00`` تا ``0xDFFF``) را برای یک نقطه‌کد یونیکد در محدوده‌ی ``[0x10000; 0x10FFFF]`` بازمی‌گرداند."

msgid "Join two surrogate code points and return a single :c:type:`Py_UCS4` value. *high* and *low* are respectively the leading and trailing surrogates in a surrogate pair. *high* must be in the range ``[0xD800; 0xDBFF]`` and *low* must be in the range ``[0xDC00; 0xDFFF]``."
msgstr "دو نقطه‌کد جانشین را به هم می‌پیوندد و یک مقدار :c:type:`Py_UCS4` برمی‌گرداند. *high* و *low* به ترتیب جانشین پیشرو و جانشین پسرو در یک جفت جانشین هستند. *high* باید در محدوده‌ی ``[0xD800; 0xDBFF]`` و *low* باید در محدوده‌ی ``[0xDC00; 0xDFFF]`` باشد."

msgid "Creating and accessing Unicode strings"
msgstr "ایجاد و دسترسی به رشته‌های یونیکد"

msgid "To create Unicode objects and access their basic sequence properties, use these APIs:"
msgstr "برای ایجاد اشیاء یونیکد و دسترسی به ویژگی‌های پایه‌ی دنباله‌ی آن‌ها، از این API‌ها استفاده کنید:"

msgid "Create a new Unicode object.  *maxchar* should be the true maximum code point to be placed in the string.  As an approximation, it can be rounded up to the nearest value in the sequence 127, 255, 65535, 1114111."
msgstr "یک شیء یونیکد جدید ایجاد کنید.  *maxchar* باید حداکثر نقطه‌کد واقعی‌ای باشد که در رشته قرار می‌گیرد.  به‌عنوان یک تقریب، می‌توان آن را رو به بالا به نزدیک‌ترین مقدار در دنباله‌ی ۱۲۷، ۲۵۵، ۶۵۵۳۵، ۱۱۱۴۱۱۱ گرد کرد."

msgid "On error, set an exception and return ``NULL``."
msgstr "در صورت خطا، یک استثنا تنظیم کنید و ``NULL`` را برگردانید."

msgid "After creation, the string can be filled by :c:func:`PyUnicode_WriteChar`, :c:func:`PyUnicode_CopyCharacters`, :c:func:`PyUnicode_Fill`, :c:func:`PyUnicode_WRITE` or similar. Since strings are supposed to be immutable, take care to not “use” the result while it is being modified. In particular, before it's filled with its final contents, a string:"
msgstr "پس از ایجاد، می‌توان رشته را با :c:func:`PyUnicode_WriteChar`، :c:func:`PyUnicode_CopyCharacters`، :c:func:`PyUnicode_Fill`، :c:func:`PyUnicode_WRITE` یا توابع مشابه پر کرد. از آنجا که رشته‌ها باید تغییرناپذیر باشند، مراقب باشید که نتیجه را هنگام تغییر «استفاده» نکنید. به‌طور خاص، پیش از آنکه با محتوای نهایی خود پر شود، یک رشته:"

msgid "must not be hashed,"
msgstr "نباید هش شود،"

msgid "must not be :c:func:`converted to UTF-8 <PyUnicode_AsUTF8AndSize>`, or another non-\"canonical\" representation,"
msgstr "نباید :c:func:`به UTF-8 تبدیل شود <PyUnicode_AsUTF8AndSize>`، یا به بازنمایی غیر«کانونیکال» دیگری تبدیل شود،"

msgid "must not have its reference count changed,"
msgstr "نباید شمارش ارجاع آن تغییر داده شود،"

msgid "must not be shared with code that might do one of the above."
msgstr "نباید با کدی که ممکن است یکی از موارد فوق را انجام دهد به اشتراک گذاشته شود."

msgid "This list is not exhaustive. Avoiding these uses is your responsibility; Python does not always check these requirements."
msgstr "این فهرست جامع نیست. پرهیز از این کاربردها مسئولیت شماست؛ پایتون همیشه این الزامات را بررسی نمی‌کند."

msgid "To avoid accidentally exposing a partially-written string object, prefer using the :c:type:`PyUnicodeWriter` API, or one of the ``PyUnicode_From*`` functions below."
msgstr "برای جلوگیری از افشای ناخواسته‌ی شیء رشته‌ی نیمه‌نوشته، استفاده از API :c:type:`PyUnicodeWriter` یا یکی از توابع ``PyUnicode_From*`` زیر را ترجیح دهید."

msgid "Create a new Unicode object with the given *kind* (possible values are :c:macro:`PyUnicode_1BYTE_KIND` etc., as returned by :c:func:`PyUnicode_KIND`).  The *buffer* must point to an array of *size* units of 1, 2 or 4 bytes per character, as given by the kind."
msgstr "یک شیء یونیکد جدید با *kind* داده‌شده ایجاد می‌کند (مقادیر ممکن عبارت‌اند از :c:macro:`PyUnicode_1BYTE_KIND` و غیره، همان‌طور که توسط :c:func:`PyUnicode_KIND` برگردانده می‌شوند).  *buffer* باید به آرایه‌ای از *size* واحدِ ۱، ۲ یا ۴ بایتی به ازای هر نویسه اشاره کند، همان‌طور که توسط kind مشخص شده است."

msgid "If necessary, the input *buffer* is copied and transformed into the canonical representation.  For example, if the *buffer* is a UCS4 string (:c:macro:`PyUnicode_4BYTE_KIND`) and it consists only of codepoints in the UCS1 range, it will be transformed into UCS1 (:c:macro:`PyUnicode_1BYTE_KIND`)."
msgstr "در صورت نیاز، *بافر* ورودی کپی شده و به نمایش کانونیکال تبدیل می‌شود. برای مثال، اگر *بافر* یک رشته‌ی UCS4 باشد (:c:macro:`PyUnicode_4BYTE_KIND`) و تنها شامل نقطه‌کدهایی در محدوده‌ی UCS1 باشد، به UCS1 تبدیل می‌شود (:c:macro:`PyUnicode_1BYTE_KIND`)."

msgid "Create a Unicode object from the char buffer *str*.  The bytes will be interpreted as being UTF-8 encoded.  The buffer is copied into the new object. The return value might be a shared object, i.e. modification of the data is not allowed."
msgstr "یک شیء یونیکد از بافر نویسه *str* ایجاد می‌کند. بایت‌ها به‌عنوان کدگذاری‌شده با UTF-8 تفسیر می‌شوند. بافر در شیء جدید کپی می‌شود. مقدار بازگشتی ممکن است یک شیء مشترک باشد، یعنی تغییر داده‌ها مجاز نیست."

msgid "This function raises :exc:`SystemError` when:"
msgstr "این تابع در موارد زیر استثنای :exc:`SystemError` را ایجاد می‌کند:"

msgid "*size* < 0,"
msgstr "*size* < 0,"

msgid "*str* is ``NULL`` and *size* > 0"
msgstr "*str* برابر ``NULL`` است و *size* > 0"

msgid "*str* == ``NULL`` with *size* > 0 is not allowed anymore."
msgstr "*str* == ``NULL`` همراه با *size* > 0 دیگر مجاز نیست."

msgid "Create a Unicode object from a UTF-8 encoded null-terminated char buffer *str*."
msgstr "یک شیء یونیکد از بافر نویسه‌ی کدگذاری‌شده با UTF-8 و پایان‌یافته با تهی *str* ایجاد می‌کند."

msgid "Take a C :c:func:`printf`\\ -style *format* string and a variable number of arguments, calculate the size of the resulting Python Unicode string and return a string with the values formatted into it.  The variable arguments must be C types and must correspond exactly to the format characters in the *format* ASCII-encoded string."
msgstr "یک رشته *قالب* به سبک :c:func:`printf`\\ در C و تعداد متغیری از آرگومان‌ها می‌گیرد، اندازه‌ی رشته‌ی یونیکد پایتونِ حاصل را محاسبه می‌کند و رشته‌ای را که مقادیر در آن قالب‌بندی شده‌اند برمی‌گرداند.  آرگومان‌های متغیر باید نوع‌های C باشند و دقیقاً با نویسه‌های قالب در رشته *قالب* کدگذاری‌شده با اسکی مطابقت داشته باشند."

msgid "A conversion specifier contains two or more characters and has the following components, which must occur in this order:"
msgstr "مشخص‌کننده تبدیل شامل دو نویسه یا بیشتر است و دارای اجزای زیر است که باید به این ترتیب ظاهر شوند:"

msgid "The ``'%'`` character, which marks the start of the specifier."
msgstr "نویسه‌ی ``'%'`` که آغاز مشخص‌کننده را علامت‌گذاری می‌کند."

msgid "Conversion flags (optional), which affect the result of some conversion types."
msgstr "پرچم‌های تبدیل (اختیاری) که بر نتیجه‌ی برخی از نوع‌های تبدیل تأثیر می‌گذارند."

msgid "Minimum field width (optional). If specified as an ``'*'`` (asterisk), the actual width is given in the next argument, which must be of type :c:expr:`int`, and the object to convert comes after the minimum field width and optional precision."
msgstr "حداقل عرض میدان (اختیاری). اگر به‌صورت ``'*'`` (ستاره) مشخص شود، عرض واقعی در آرگومان بعدی داده می‌شود که باید از نوع :c:expr:`int` باشد، و شیئی که باید تبدیل شود، پس از حداقل عرض میدان و دقت اختیاری قرار می‌گیرد."

msgid "Precision (optional), given as a ``'.'`` (dot) followed by the precision. If specified as ``'*'`` (an asterisk), the actual precision is given in the next argument, which must be of type :c:expr:`int`, and the value to convert comes after the precision."
msgstr "دقت (اختیاری)، به‌صورت ``'.'`` (نقطه) و به دنبال آن مقدار دقت داده می‌شود. اگر به‌صورت ``'*'`` (ستاره) تعیین شود، دقت واقعی در آرگومان بعدی داده می‌شود که باید از نوع :c:expr:`int` باشد، و مقداری که باید تبدیل شود پس از دقت می‌آید."

msgid "Length modifier (optional)."
msgstr "اصلاح‌کننده‌ی طول (اختیاری)."

msgid "Conversion type."
msgstr "نوع تبدیل."

msgid "The conversion flag characters are:"
msgstr "نویسه‌های پرچم تبدیل عبارت‌اند از:"

msgid "Flag"
msgstr "پرچم"

msgid "Meaning"
msgstr "معنا"

msgid "``0``"
msgstr "``0``"

msgid "The conversion will be zero padded for numeric values."
msgstr "تبدیل برای مقادیر عددی با صفر پر خواهد شد."

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

msgid "The converted value is left adjusted (overrides the ``0`` flag if both are given)."
msgstr "مقدار تبدیل‌شده چپ‌تراز می‌شود (اگر هر دو داده شوند، پرچم ``0`` نادیده گرفته می‌شود)."

msgid "The length modifiers for following integer conversions (``d``, ``i``, ``o``, ``u``, ``x``, or ``X``) specify the type of the argument (:c:expr:`int` by default):"
msgstr "اصلاح‌کننده‌های طول برای تبدیل‌های عدد صحیح زیر (``d``، ``i``، ``o``، ``u``، ``x`` یا ``X``) نوع آرگومان را تعیین می‌کنند (:c:expr:`int` به‌طور پیش‌فرض):"

msgid "Modifier"
msgstr "اصلاح‌گر"

msgid "Types"
msgstr "نوع‌ها"

msgid "``l``"
msgstr "``l``"

msgid ":c:expr:`long` or :c:expr:`unsigned long`"
msgstr ":c:expr:`long` یا :c:expr:`unsigned long`"

msgid "``ll``"
msgstr "``ll``"

msgid ":c:expr:`long long` or :c:expr:`unsigned long long`"
msgstr ":c:expr:`long long` یا :c:expr:`unsigned long long`"

msgid "``j``"
msgstr "``j````"

msgid ":c:type:`intmax_t` or :c:type:`uintmax_t`"
msgstr ":c:type:`intmax_t` یا :c:type:`uintmax_t`"

msgid "``z``"
msgstr "``z``"

msgid ":c:type:`size_t` or :c:type:`ssize_t`"
msgstr ":c:type:`size_t` یا :c:type:`ssize_t`"

msgid "``t``"
msgstr "``t``"

msgid ":c:type:`ptrdiff_t`"
msgstr ":c:type:`ptrdiff_t`"

msgid "The length modifier ``l`` for following conversions ``s`` or ``V`` specify that the type of the argument is :c:expr:`const wchar_t*`."
msgstr "اصلاح‌کننده‌ی طول ``l`` برای تبدیل‌های بعدی ``s`` یا ``V`` مشخص می‌کند که نوع آرگومان :c:expr:`const wchar_t*` است."

msgid "The conversion specifiers are:"
msgstr "مشخص‌کننده‌های تبدیل عبارت‌اند از:"

msgid "Conversion Specifier"
msgstr "مشخص‌کننده تبدیل"

msgid "Type"
msgstr "نوع"

msgid "Comment"
msgstr "کامنت"

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

msgid "*n/a*"
msgstr "*n/a*"

msgid "The literal ``%`` character."
msgstr "نویسه‌ی لفظی ``%``."

msgid "``d``, ``i``"
msgstr "``d``, ``i``"

msgid "Specified by the length modifier"
msgstr "تعیین‌شده توسط اصلاح‌گر طول (length modifier)"

msgid "The decimal representation of a signed C integer."
msgstr "نمایش دهدهی یک عدد صحیح علامت‌دار در C."

msgid "``u``"
msgstr "``u``"

msgid "The decimal representation of an unsigned C integer."
msgstr "نمایش مبنای ده یک عدد صحیح بدون علامت C."

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

msgid "The octal representation of an unsigned C integer."
msgstr "نمایش مبنای هشت یک عدد صحیح بدون علامت C."

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

msgid "The hexadecimal representation of an unsigned C integer (lowercase)."
msgstr "نمایش مبنای شانزده‌ی یک عدد صحیح بدون علامت C (با حروف کوچک)."

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

msgid "The hexadecimal representation of an unsigned C integer (uppercase)."
msgstr "نمایش مبنای شانزده‌ی یک عدد صحیح بدون علامت C (با حروف بزرگ)."

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

msgid ":c:expr:`int`"
msgstr ":c:expr:`int`"

msgid "A single character."
msgstr "یک نویسه."

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

msgid ":c:expr:`const char*` or :c:expr:`const wchar_t*`"
msgstr ":c:expr:`const char*` یا :c:expr:`const wchar_t*`"

msgid "A null-terminated C character array."
msgstr "آرایه‌ی نویسه‌ای C که با نویسه‌ی تهی پایان می‌یابد."

msgid "``p``"
msgstr "``p``"

msgid ":c:expr:`const void*`"
msgstr ":c:expr:`const void*`"

msgid "The hex representation of a C  pointer. Mostly equivalent to ``printf(\"%p\")`` except that it is guaranteed to start with the literal ``0x`` regardless of what the platform's ``printf`` yields."
msgstr "نمایش مبنای شانزده‌ی یک اشاره‌گر C. عمدتاً معادل ``printf(\"%p\")`` است، با این تفاوت که تضمین می‌شود صرف‌نظر از آنچه ``printf`` پلتفرم تولید می‌کند، با مقدار لفظی ``0x`` آغاز شود."

msgid "``A``"
msgstr "``A``"

msgid ":c:expr:`PyObject*`"
msgstr ":c:expr:`PyObject*`"

msgid "The result of calling :func:`ascii`."
msgstr "نتیجه فراخوانی :func:`ascii`."

msgid "``U``"
msgstr "``U``"

msgid "A Unicode object."
msgstr "یک شیء یونیکد."

msgid "``V``"
msgstr "``V``"

msgid ":c:expr:`PyObject*`, :c:expr:`const char*` or :c:expr:`const wchar_t*`"
msgstr ":c:expr:`PyObject*`، :c:expr:`const char*` یا :c:expr:`const wchar_t*`"

msgid "A Unicode object (which may be ``NULL``) and a null-terminated C character array as a second parameter (which will be used, if the first parameter is ``NULL``)."
msgstr "یک شیء یونیکد (که ممکن است ``NULL`` باشد) و یک آرایه‌ی نویسه‌ای C پایان‌یافته با نویسه تهی به‌عنوان پارامتر دوم (که اگر پارامتر اول ``NULL`` باشد، استفاده خواهد شد)."

msgid "``S``"
msgstr "``S``"

msgid "The result of calling :c:func:`PyObject_Str`."
msgstr "نتیجه فراخوانی :c:func:`PyObject_Str`."

msgid "``R``"
msgstr "``R``"

msgid "The result of calling :c:func:`PyObject_Repr`."
msgstr "نتیجه‌ی فراخوانی :c:func:`PyObject_Repr`."

msgid "``T``"
msgstr "``T````"

msgid "Get the fully qualified name of an object type; call :c:func:`PyType_GetFullyQualifiedName`."
msgstr "برای به‌دست‌آوردن نام کامل نوع یک شیء، :c:func:`PyType_GetFullyQualifiedName` را فراخوانی کنید."

msgid "``#T``"
msgstr "``#T``"

msgid "Similar to ``T`` format, but use a colon (``:``) as separator between the module name and the qualified name."
msgstr "شبیه به قالب ``T``، اما از دونقطه (``:``) به‌عنوان جداکننده بین نام ماژول و نام کامل استفاده می‌کند."

msgid "``N``"
msgstr "``N``"

msgid ":c:expr:`PyTypeObject*`"
msgstr ":c:expr:`PyTypeObject*`"

msgid "Get the fully qualified name of a type; call :c:func:`PyType_GetFullyQualifiedName`."
msgstr "نام کامل یک نوع را دریافت کنید؛ :c:func:`PyType_GetFullyQualifiedName` را فراخوانی کنید."

msgid "``#N``"
msgstr "``#N``"

msgid "Similar to ``N`` format, but use a colon (``:``) as separator between the module name and the qualified name."
msgstr "مشابه قالب ``N``، اما از دونقطه (``:``) به عنوان جداکننده بین نام ماژول و نام کامل استفاده می‌کند."

msgid "The width formatter unit is number of characters rather than bytes. The precision formatter unit is number of bytes or :c:type:`wchar_t` items (if the length modifier ``l`` is used) for ``\"%s\"`` and ``\"%V\"`` (if the ``PyObject*`` argument is ``NULL``), and a number of characters for ``\"%A\"``, ``\"%U\"``, ``\"%S\"``, ``\"%R\"`` and ``\"%V\"`` (if the ``PyObject*`` argument is not ``NULL``)."
msgstr "واحد قالب‌بند عرض، تعداد نویسه‌ها است نه بایت‌ها. واحد قالب‌بند دقت برای ``\"%s\"`` و ``\"%V\"`` (اگر آرگومان ``PyObject*`` برابر با ``NULL`` باشد)، تعداد بایت‌ها یا آیتم‌های :c:type:`wchar_t` (در صورت استفاده از اصلاح‌کننده طول ``l``) است، و برای ``\"%A\"``، ``\"%U\"``، ``\"%S\"``، ``\"%R\"`` و ``\"%V\"`` (اگر آرگومان ``PyObject*`` برابر با ``NULL`` نباشد)، تعداد نویسه‌ها است."

msgid "Unlike to C :c:func:`printf` the ``0`` flag has effect even when a precision is given for integer conversions (``d``, ``i``, ``u``, ``o``, ``x``, or ``X``)."
msgstr "برخلاف :c:func:`printf` در C، پرچم ``0`` حتی وقتی دقتی برای تبدیل‌های عدد صحیح (``d``، ``i``، ``u``، ``o``، ``x`` یا ``X``) تعیین شده باشد، اثر دارد."

msgid "Support for ``\"%lld\"`` and ``\"%llu\"`` added."
msgstr "پشتیبانی از ``\"%lld\"`` و ``\"%llu\"`` افزوده شد."

msgid "Support for ``\"%li\"``, ``\"%lli\"`` and ``\"%zi\"`` added."
msgstr "پشتیبانی از ``\"%li\"``، ``\"%lli\"`` و ``\"%zi\"`` افزوده شد."

msgid "Support width and precision formatter for ``\"%s\"``, ``\"%A\"``, ``\"%U\"``, ``\"%V\"``, ``\"%S\"``, ``\"%R\"`` added."
msgstr "پشتیبانی از قالب‌بند عرض و دقت برای ``\"%s\"``، ``\"%A\"``، ``\"%U\"``، ``\"%V\"``، ``\"%S\"``، ``\"%R\"`` افزوده شد."

msgid "Support for conversion specifiers ``o`` and ``X``. Support for length modifiers ``j`` and ``t``. Length modifiers are now applied to all integer conversions. Length modifier ``l`` is now applied to conversion specifiers ``s`` and ``V``. Support for variable width and precision ``*``. Support for flag ``-``."
msgstr "پشتیبانی از مشخص‌کننده‌های تبدیل ``o`` و ``X``. پشتیبانی از اصلاح‌کننده‌های طول ``j`` و ``t``. اصلاح‌کننده‌های طول اکنون بر همه‌ی تبدیل‌های عدد صحیح اعمال می‌شوند. اصلاح‌کننده‌ی طول ``l`` اکنون بر مشخص‌کننده‌های تبدیل ``s`` و ``V`` اعمال می‌شود. پشتیبانی از عرض و دقت متغیر ``*``. پشتیبانی از پرچم ``-``."

msgid "An unrecognized format character now sets a :exc:`SystemError`. In previous versions it caused all the rest of the format string to be copied as-is to the result string, and any extra arguments discarded."
msgstr "اکنون نویسه‌ی قالب‌بندی ناشناخته یک :exc:`SystemError` ایجاد می‌کند. در نسخه‌های قبلی، این نویسه باعث می‌شد تمام بقیه‌ی رشته‌ی قالب عیناً در رشته‌ی نتیجه رونوشت شود و هر آرگومان اضافی دور ریخته شود."

msgid "Support for ``%T``, ``%#T``, ``%N`` and ``%#N`` formats added."
msgstr "پشتیبانی از قالب‌های ``%T``، ``%#T``، ``%N`` و ``%#N`` افزوده شد."

msgid "Identical to :c:func:`PyUnicode_FromFormat` except that it takes exactly two arguments."
msgstr "یکسان با :c:func:`PyUnicode_FromFormat` است، با این تفاوت که دقیقاً دو آرگومان می‌گیرد."

msgid "Copy an instance of a Unicode subtype to a new true Unicode object if necessary. If *obj* is already a true Unicode object (not a subtype), return a new :term:`strong reference` to the object."
msgstr "در صورت نیاز، یک نمونه از یک زیرنوع یونیکد را به یک شیء یونیکد واقعی جدید کپی می‌کند. اگر *obj* از قبل یک شیء یونیکد واقعی باشد (نه یک زیرنوع)، یک :term:`ارجاع قوی <strong reference>` جدید به همان شیء برمی‌گرداند."

msgid "Objects other than Unicode or its subtypes will cause a :exc:`TypeError`."
msgstr "اشیایی غیر از یونیکد یا زیرنوع‌های آن باعث ایجاد :exc:`TypeError` خواهند شد."

msgid "Create a Unicode Object from the given Unicode code point *ordinal*."
msgstr "یک شیء یونیکد از *ترتیبی*\\ ِ نقطه‌کد یونیکدِ داده‌شده ایجاد می‌کند."

msgid "The ordinal must be in ``range(0x110000)``. A :exc:`ValueError` is raised in the case it is not."
msgstr "مقدار ترتیبی باید در ``range(0x110000)`` باشد. در صورتی که چنین نباشد، استثنای :exc:`ValueError` مطرح می‌شود."

msgid "Decode an encoded object *obj* to a Unicode object."
msgstr "یک شیء کدگذاری‌شده *obj* را به یک شیء یونیکد کدگشایی می‌کند."

msgid ":class:`bytes`, :class:`bytearray` and other :term:`bytes-like objects <bytes-like object>` are decoded according to the given *encoding* and using the error handling defined by *errors*. Both can be ``NULL`` to have the interface use the default values (see :ref:`builtincodecs` for details)."
msgstr ":class:`bytes`، :class:`bytearray` و سایر :term:`اشیاء شبه‌بایت <bytes-like object>` بر اساس *encoding* داده‌شده و با استفاده از مدیریت خطای تعریف‌شده توسط *errors* کدگشایی می‌شوند. هر دو می‌توانند ``NULL`` باشند تا رابط از مقادیر پیش‌فرض استفاده کند (برای جزئیات به :ref:`builtincodecs` مراجعه کنید)."

msgid "All other objects, including Unicode objects, cause a :exc:`TypeError` to be set."
msgstr "تمام اشیاء دیگر، از جمله اشیاء یونیکد، باعث می‌شوند استثنای :exc:`TypeError` تنظیم شود."

msgid "The API returns ``NULL`` if there was an error.  The caller is responsible for decref'ing the returned objects."
msgstr "در صورت وقوع خطا، این API مقدار ``NULL`` را برمی‌گرداند. کاهش شمارش ارجاع (decref) اشیاء برگردانده‌شده بر عهده‌ی فراخواننده است."

msgid "Append the string *right* to the end of *p_left*. *p_left* must point to a :term:`strong reference` to a Unicode object; :c:func:`!PyUnicode_Append` releases (\":term:`steals <steal>`\") this reference."
msgstr "رشته *right* را به انتهای *p_left* اضافه کنید. *p_left* باید به یک :term:`ارجاع قوی <strong reference>` به یک شیء یونیکد اشاره کند؛ :c:func:`!PyUnicode_Append` این ارجاع را آزاد می‌کند (\":term:`می‌دزدد <steal>`\")."

msgid "On error, set *\\*p_left* to ``NULL`` and set an exception."
msgstr "در صورت خطا، *\\*p_left* را برابر ``NULL`` قرار دهید و یک استثنا تنظیم کنید."

msgid "On success, set *\\*p_left* to a new strong reference to the result."
msgstr "در صورت موفقیت، *\\*p_left* را برابر با ارجاع قوی جدیدی به نتیجه قرار می‌دهد."

msgid "The function is similar to :c:func:`PyUnicode_Append`, with the only difference being that it decrements the reference count of *right* by one."
msgstr "این تابع مشابه :c:func:`PyUnicode_Append` است و تنها تفاوت آن این است که شمارش ارجاع *right* را یکی کاهش می‌دهد."

msgid "Return a mapping suitable for decoding a custom single-byte encoding. Given a Unicode string *string* of up to 256 characters representing an encoding table, returns either a compact internal mapping object or a dictionary mapping character ordinals to byte values. Raises a :exc:`TypeError` and return ``NULL`` on invalid input."
msgstr "یک نگاشت مناسب برای کدگشایی یک کدگذاری سفارشی تک‌بایتی برمی‌گرداند. با گرفتن یک رشته یونیکد *string* با حداکثر ۲۵۶ نویسه که نمایانگر یک جدول کدگذاری است، یا یک شیء نگاشت داخلی فشرده یا یک دیکشنری که مقادیر ترتیبی نویسه‌ها را به مقادیر بایت نگاشت می‌کند، برمی‌گرداند. در صورت نامعتبر بودن ورودی، استثنای :exc:`TypeError` ایجاد کرده و ``NULL`` را برمی‌گرداند."

msgid "Return the name of the default string encoding, ``\"utf-8\"``. See :func:`sys.getdefaultencoding`."
msgstr "نام کدگذاری پیش‌فرض رشته، ``\"utf-8\"`` را برمی‌گرداند. به :func:`sys.getdefaultencoding` مراجعه کنید."

msgid "The returned string does not need to be freed, and is valid until interpreter shutdown."
msgstr "رشته‌ی بازگردانده‌شده نیازی به آزاد شدن ندارد و تا خاموش شدن مفسر معتبر است."

msgid "Return the length of the Unicode object, in code points."
msgstr "طول شیء یونیکد را بر حسب نقطه‌کد برمی‌گرداند."

msgid "On error, set an exception and return ``-1``."
msgstr "در صورت خطا، یک استثنا تنظیم شده و ``-1`` بازگردانده می‌شود."

msgid "Copy characters from one Unicode object into another.  This function performs character conversion when necessary and falls back to :c:func:`!memcpy` if possible.  Returns ``-1`` and sets an exception on error, otherwise returns the number of copied characters."
msgstr "نویسه‌ها را از یک شیء یونیکد به شیء یونیکد دیگر کپی می‌کند.  این تابع در صورت نیاز تبدیل نویسه‌ها را انجام می‌دهد و در صورت امکان به :c:func:`!memcpy` روی می‌آورد.  در صورت خطا ``-1`` برمی‌گرداند و یک استثنا تنظیم می‌کند، در غیر این صورت تعداد نویسه‌های کپی‌شده را برمی‌گرداند."

msgid "The string must not have been “used” yet. See :c:func:`PyUnicode_New` for details."
msgstr "رشته نباید هنوز «استفاده شده» باشد. برای جزئیات به :c:func:`PyUnicode_New` مراجعه کنید."

msgid "Resize a Unicode object *\\*unicode* to the new *length* in code points."
msgstr "اندازه یک شیء یونیکد *\\*unicode* را به *length* جدید بر حسب نقطه‌کد تغییر دهید."

msgid "Try to resize the string in place (which is usually faster than allocating a new string and copying characters), or create a new string."
msgstr "سعی کنید رشته را درجا تغییر اندازه دهید (که معمولاً سریع‌تر از تخصیص دادن یک رشته جدید و کپی کردن نویسه‌ها است)، یا یک رشته جدید ایجاد کنید."

msgid "*\\*unicode* is modified to point to the new (resized) object and ``0`` is returned on success. Otherwise, ``-1`` is returned and an exception is set, and *\\*unicode* is left untouched."
msgstr "*\\*unicode* به‌گونه‌ای تغییر می‌کند که به شیء جدید (تغییر اندازه‌یافته) اشاره کند و در صورت موفقیت ``0`` بازگردانده می‌شود. در غیر این صورت، ``-1`` بازگردانده می‌شود، یک استثنا تنظیم می‌شود و *\\*unicode* دست‌نخورده باقی می‌ماند."

msgid "The function doesn't check string content, the result may not be a string in canonical representation."
msgstr "این تابع محتوای رشته را بررسی نمی‌کند و نتیجه ممکن است رشته‌ای در نمایش کانونیکال نباشد."

msgid "Fill a string with a character: write *fill_char* into ``unicode[start:start+length]``."
msgstr "پر کردن یک رشته با یک نویسه: نوشتن *fill_char* در ``unicode[start:start+length]``."

msgid "Fail if *fill_char* is bigger than the string maximum character, or if the string has more than 1 reference."
msgstr "اگر *fill_char* بزرگ‌تر از بیشینه نویسه‌ی رشته باشد یا رشته بیش از ۱ ارجاع داشته باشد، شکست می‌خورد."

msgid "Return the number of written characters, or return ``-1`` and raise an exception on error."
msgstr "تعداد نویسه‌های نوشته‌شده را برمی‌گرداند، یا در صورت خطا ``-1`` را برمی‌گرداند و استثنا raise می‌کند."

msgid "Write a *character* to the string *unicode* at the zero-based *index*. Return ``0`` on success, ``-1`` on error with an exception set."
msgstr "نویسه‌ی *character* را در اندیس مبنای صفرِ *index* از رشته‌ی *unicode* می‌نویسد. در صورت موفقیت ``0`` و در صورت خطا با تنظیم یک استثنا ``-1`` برمی‌گرداند."

msgid "This function checks that *unicode* is a Unicode object, that the index is not out of bounds, and that the object's reference count is one. See :c:func:`PyUnicode_WRITE` for a version that skips these checks, making them your responsibility."
msgstr "این تابع بررسی می‌کند که *unicode* یک شیء یونیکد باشد، که اندیس خارج از محدوده نباشد، و اینکه شمارش ارجاع شیء برابر با یک باشد. برای نسخه‌ای که این بررسی‌ها را انجام نمی‌دهد و مسئولیت آن‌ها را بر عهده‌ی شما می‌گذارد، به :c:func:`PyUnicode_WRITE` مراجعه کنید."

msgid "Read a character from a string.  This function checks that *unicode* is a Unicode object and the index is not out of bounds, in contrast to :c:func:`PyUnicode_READ_CHAR`, which performs no error checking."
msgstr "یک نویسه از یک رشته می‌خواند. این تابع بررسی می‌کند که *unicode* یک شیء یونیکد باشد و اندیس خارج از کران‌ها نباشد، برخلاف :c:func:`PyUnicode_READ_CHAR` که هیچ بررسی خطایی انجام نمی‌دهد."

msgid "Return character on success, ``-1`` on error with an exception set."
msgstr "در صورت موفقیت نویسه و در صورت خطا ``-1`` را همراه با استثنای تنظیم‌شده برمی‌گرداند."

msgid "Return a substring of *unicode*, from character index *start* (included) to character index *end* (excluded).  Negative indices are not supported. On error, set an exception and return ``NULL``."
msgstr "زیررشته‌ای از *unicode* را برمی‌گرداند که از اندیس نویسه‌ی *start* (شامل) تا اندیس نویسه‌ی *end* (بدون) است.  اندیس‌های منفی پشتیبانی نمی‌شوند. در صورت خطا، یک استثنا تنظیم کرده و ``NULL`` را برمی‌گرداند."

msgid "Copy the string *unicode* into a UCS4 buffer, including a null character, if *copy_null* is set.  Returns ``NULL`` and sets an exception on error (in particular, a :exc:`SystemError` if *buflen* is smaller than the length of *unicode*).  *buffer* is returned on success."
msgstr "رشته *unicode* را در یک بافر UCS4 کپی می‌کند و در صورت تنظیم بودن *copy_null*، یک نویسه تهی نیز در آن گنجانده می‌شود. در صورت خطا، ``NULL`` را برمی‌گرداند و یک استثنا تنظیم می‌کند (به‌طور خاص، :exc:`SystemError` در صورتی که *buflen* کوچک‌تر از طول *unicode* باشد). در صورت موفقیت، *buffer* را برمی‌گرداند."

msgid "Copy the string *unicode* into a new UCS4 buffer that is allocated using :c:func:`PyMem_Malloc`.  If this fails, ``NULL`` is returned with a :exc:`MemoryError` set.  The returned buffer always has an extra null code point appended."
msgstr "رشته *unicode* را به یک بافر UCS4 جدید که با استفاده از :c:func:`PyMem_Malloc` تخصیص داده‌شده است، کپی می‌کند. اگر این کار ناموفق باشد، ``NULL`` برگردانده می‌شود و :exc:`MemoryError` تنظیم می‌شود. بافر برگردانده‌شده همیشه یک نقطه‌کد تهی اضافی در انتهای خود دارد."

msgid "Locale Encoding"
msgstr "کدگذاری locale"

msgid "The current locale encoding can be used to decode text from the operating system."
msgstr "از کدگذاری locale فعلی می‌توان برای کدگشایی متن از سیستم‌عامل استفاده کرد."

msgid "Decode a string from UTF-8 on Android and VxWorks, or from the current locale encoding on other platforms. The supported error handlers are ``\"strict\"`` and ``\"surrogateescape\"`` (:pep:`383`). The decoder uses ``\"strict\"`` error handler if *errors* is ``NULL``.  *str* must end with a null character but cannot contain embedded null characters."
msgstr "یک رشته را در اندروید و VxWorks از UTF-8، یا در پلتفرم‌های دیگر از کدگذاری locale جاری کدگشایی می‌کند. هندلرهای خطای پشتیبانی‌شده ``\"strict\"`` و ``\"surrogateescape\"`` هستند (:pep:`383`). کدگشا در صورتی که *errors* ``NULL`` باشد، از هندلر خطای ``\"strict\"`` استفاده می‌کند. *str* باید با یک نویسه تهی پایان یابد، اما نمی‌تواند شامل نویسه‌های تهی تعبیه‌شده باشد."

msgid "Use :c:func:`PyUnicode_DecodeFSDefaultAndSize` to decode a string from the :term:`filesystem encoding and error handler`."
msgstr "از :c:func:`PyUnicode_DecodeFSDefaultAndSize` برای کدگشایی یک رشته از :term:`filesystem encoding and error handler` استفاده کنید."

msgid "This function ignores the :ref:`Python UTF-8 Mode <utf8-mode>`."
msgstr "این تابع :ref:`حالت UTF-8 پایتون <utf8-mode>` را نادیده می‌گیرد."

msgid "The :c:func:`Py_DecodeLocale` function."
msgstr "تابع :c:func:`Py_DecodeLocale`."

msgid "The function now also uses the current locale encoding for the ``surrogateescape`` error handler, except on Android. Previously, :c:func:`Py_DecodeLocale` was used for the ``surrogateescape``, and the current locale encoding was used for ``strict``."
msgstr "این تابع اکنون برای هندلر خطای ``surrogateescape`` از کدگذاری locale جاری نیز استفاده می‌کند، به‌جز در اندروید. پیش‌تر، :c:func:`Py_DecodeLocale` برای ``surrogateescape`` استفاده می‌شد و کدگذاری locale جاری برای ``strict`` به کار می‌رفت."

msgid "Similar to :c:func:`PyUnicode_DecodeLocaleAndSize`, but compute the string length using :c:func:`!strlen`."
msgstr "مشابه :c:func:`PyUnicode_DecodeLocaleAndSize`، اما طول رشته را با استفاده از :c:func:`!strlen` محاسبه می‌کند."

msgid "Encode a Unicode object to UTF-8 on Android and VxWorks, or to the current locale encoding on other platforms. The supported error handlers are ``\"strict\"`` and ``\"surrogateescape\"`` (:pep:`383`). The encoder uses ``\"strict\"`` error handler if *errors* is ``NULL``. Return a :class:`bytes` object. *unicode* cannot contain embedded null characters."
msgstr "یک شیء یونیکد را در اندروید و VxWorks به UTF-8، یا در پلتفرم‌های دیگر به کدگذاری locale جاری کدگذاری می‌کند. هندلرهای خطای پشتیبانی‌شده عبارت‌اند از ``\"strict\"`` و ``\"surrogateescape\"`` (:pep:`383`). کدگذار در صورت ``NULL`` بودن *errors* از هندلر خطای ``\"strict\"`` استفاده می‌کند. یک شیء :class:`bytes` برمی‌گرداند. *unicode* نمی‌تواند حاوی نویسه‌های تهی تعبیه‌شده باشد."

msgid "Use :c:func:`PyUnicode_EncodeFSDefault` to encode a string to the :term:`filesystem encoding and error handler`."
msgstr "برای کدگذاری یک رشته به :term:`filesystem encoding and error handler` از :c:func:`PyUnicode_EncodeFSDefault` استفاده کنید."

msgid "The :c:func:`Py_EncodeLocale` function."
msgstr "تابع :c:func:`Py_EncodeLocale`."

msgid "The function now also uses the current locale encoding for the ``surrogateescape`` error handler, except on Android. Previously, :c:func:`Py_EncodeLocale` was used for the ``surrogateescape``, and the current locale encoding was used for ``strict``."
msgstr "این تابع اکنون برای هندلر خطای ``surrogateescape`` نیز از کدگذاری locale جاری استفاده می‌کند، به‌جز در اندروید. پیش‌تر، برای ``surrogateescape`` از :c:func:`Py_EncodeLocale` استفاده می‌شد و برای ``strict`` از کدگذاری locale جاری به کار می‌رفت."

msgid "File System Encoding"
msgstr "کدگذاری سامانه فایل‌بندی"

msgid "Functions encoding to and decoding from the :term:`filesystem encoding and error handler` (:pep:`383` and :pep:`529`)."
msgstr "توابعی که به :term:`filesystem encoding and error handler` کدگذاری و از آن کدگشایی می‌کنند (:pep:`383` و :pep:`529`)."

msgid "To encode file names to :class:`bytes` during argument parsing, the ``\"O&\"`` converter should be used, passing :c:func:`!PyUnicode_FSConverter` as the conversion function:"
msgstr "برای کدگذاری نام پرونده‌ها به :class:`bytes` در حین پارس آرگومان‌ها، باید از مبدل ``\"O&\"`` استفاده کرد و :c:func:`!PyUnicode_FSConverter` را به‌عنوان تابع تبدیل‌کننده ارسال کرد:"

msgid ":ref:`PyArg_Parse\\* converter <arg-parsing>`: encode :class:`str` objects -- obtained directly or through the :class:`os.PathLike` interface -- to :class:`bytes` using :c:func:`PyUnicode_EncodeFSDefault`; :class:`bytes` objects are output as-is. *result* must be an address of a C variable of type :c:expr:`PyObject*` (or :c:expr:`PyBytesObject*`). On success, set the variable to a new :term:`strong reference` to a :ref:`bytes object <bytesobjects>` which must be released when it is no longer used and return a non-zero value (:c:macro:`Py_CLEANUP_SUPPORTED`). Embedded null bytes are not allowed in the result. On failure, return ``0`` with an exception set."
msgstr ":ref:`مبدل PyArg_Parse\\* <arg-parsing>`: اشیاء :class:`str` را -- که مستقیماً یا از طریق رابط :class:`os.PathLike` به دست آمده‌اند -- با استفاده از :c:func:`PyUnicode_EncodeFSDefault` به :class:`bytes` کدگذاری می‌کند؛ اشیاء :class:`bytes` بدون تغییر خروجی داده می‌شوند. *result* باید آدرس یک متغیر C از نوع :c:expr:`PyObject*` (یا :c:expr:`PyBytesObject*`) باشد. در صورت موفقیت، متغیر را روی یک :term:`ارجاع قوی <strong reference>` جدید به :ref:`شیء بایت <bytesobjects>` تنظیم می‌کند که باید هنگامی که دیگر استفاده نمی‌شود آزاد شود و یک مقدار ناصفر (:c:macro:`Py_CLEANUP_SUPPORTED`) برمی‌گرداند. بایت‌های تهی تعبیه‌شده در نتیجه مجاز نیستند. در صورت شکست، ``0`` را همراه با تنظیم یک استثنا برمی‌گرداند."

msgid "If *obj* is ``NULL``, the function releases a strong reference stored in the variable referred by *result* and returns ``1``."
msgstr "اگر *obj* برابر ``NULL`` باشد، تابع ارجاع قوی ذخیره‌شده در متغیری را که *result* به آن ارجاع می‌دهد آزاد می‌کند و ``1`` را برمی‌گرداند."

msgid "Accepts a :term:`path-like object`."
msgstr "یک :term:`path-like object` را می‌پذیرد."

msgid "To decode file names to :class:`str` during argument parsing, the ``\"O&\"`` converter should be used, passing :c:func:`!PyUnicode_FSDecoder` as the conversion function:"
msgstr "برای کدگشایی نام پرونده‌ها به :class:`str` در حین تجزیه آرگومان‌ها، باید از مبدل ``\"O&\"`` استفاده کرد و :c:func:`!PyUnicode_FSDecoder` را به‌عنوان تابع تبدیل‌کننده پاس داد:"

msgid ":ref:`PyArg_Parse\\* converter <arg-parsing>`: decode :class:`bytes` objects -- obtained either directly or indirectly through the :class:`os.PathLike` interface -- to :class:`str` using :c:func:`PyUnicode_DecodeFSDefaultAndSize`; :class:`str` objects are output as-is. *result* must be an address of a C variable of type :c:expr:`PyObject*` (or :c:expr:`PyUnicodeObject*`). On success, set the variable to a new :term:`strong reference` to a :ref:`Unicode object <unicodeobjects>` which must be released when it is no longer used and return a non-zero value (:c:macro:`Py_CLEANUP_SUPPORTED`). Embedded null characters are not allowed in the result. On failure, return ``0`` with an exception set."
msgstr ":ref:`مبدل PyArg_Parse\\* <arg-parsing>`: اشیاء :class:`bytes` را -- که به‌طور مستقیم یا غیرمستقیم از طریق رابط :class:`os.PathLike` به دست آمده‌اند -- با استفاده از :c:func:`PyUnicode_DecodeFSDefaultAndSize` به :class:`str` کدگشایی می‌کند؛ اشیاء :class:`str` بدون تغییر به خروجی داده می‌شوند. *result* باید نشانی یک متغیر C از نوع :c:expr:`PyObject*` (یا :c:expr:`PyUnicodeObject*`) باشد. در صورت موفقیت، متغیر را به یک :term:`ارجاع قوی <strong reference>` جدید به :ref:`شیء یونیکد <unicodeobjects>` -- که باید هنگامی که دیگر استفاده نمی‌شود آزاد شود -- تنظیم می‌کند و یک مقدار ناصفر (:c:macro:`Py_CLEANUP_SUPPORTED`) را برمی‌گرداند. نتیجه نمی‌تواند شامل نویسه‌های تهی تعبیه‌شده باشد. در صورت شکست، ``0`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند."

msgid "If *obj* is ``NULL``, release the strong reference to the object referred to by *result* and return ``1``."
msgstr "اگر *obj* برابر ``NULL`` باشد، ارجاع قوی به شیئی را که *result* به آن ارجاع می‌دهد آزاد کنید و ``1`` را بازگردانید."

msgid "Decode a string from the :term:`filesystem encoding and error handler`."
msgstr "کدگشایی یک رشته از :term:`کدگذاری سامانه فایل‌بندی و هندلر خطا <filesystem encoding and error handler>`."

msgid "If you need to decode a string from the current locale encoding, use :c:func:`PyUnicode_DecodeLocaleAndSize`."
msgstr "اگر نیاز دارید رشته‌ای را از کدگذاری locale جاری کدگشایی کنید، از :c:func:`PyUnicode_DecodeLocaleAndSize` استفاده کنید."

msgid "The :term:`filesystem error handler <filesystem encoding and error handler>` is now used."
msgstr "اکنون از :term:`هندلر خطای سامانه فایل‌بندی <filesystem encoding and error handler>` استفاده می‌شود."

msgid "Decode a null-terminated string from the :term:`filesystem encoding and error handler`."
msgstr "کدگشایی یک رشته‌ی پایان‌یافته با تهی از :term:`کدگذاری سامانه فایل‌بندی و هندلر خطا <filesystem encoding and error handler>`."

msgid "If the string length is known, use :c:func:`PyUnicode_DecodeFSDefaultAndSize`."
msgstr "اگر طول رشته مشخص باشد، از :c:func:`PyUnicode_DecodeFSDefaultAndSize` استفاده کنید."

msgid "Encode a Unicode object to the :term:`filesystem encoding and error handler`, and return :class:`bytes`. Note that the resulting :class:`bytes` object can contain null bytes."
msgstr "یک شیء یونیکد را به :term:`filesystem encoding and error handler` کدگذاری می‌کند و :class:`bytes` برمی‌گرداند. توجه داشته باشید که شیء :class:`bytes` حاصل می‌تواند شامل بایت‌های تهی باشد."

msgid "If you need to encode a string to the current locale encoding, use :c:func:`PyUnicode_EncodeLocale`."
msgstr "اگر نیاز دارید رشته‌ای را به کدگذاری locale جاری کدگذاری کنید، از :c:func:`PyUnicode_EncodeLocale` استفاده کنید."

msgid "wchar_t Support"
msgstr "پشتیبانی از wchar_t"

msgid ":c:type:`wchar_t` support for platforms which support it:"
msgstr "پشتیبانی از :c:type:`wchar_t` برای پلتفرم‌هایی که از آن پشتیبانی می‌کنند:"

msgid "Create a Unicode object from the :c:type:`wchar_t` buffer *wstr* of the given *size*. Passing ``-1`` as the *size* indicates that the function must itself compute the length, using :c:func:`!wcslen`. Return ``NULL`` on failure."
msgstr "یک شیء یونیکد از بافر :c:type:`wchar_t` به نام *wstr* با اندازه‌ی داده‌شده *size* می‌سازد. گذراندن ``-1`` به عنوان *size* نشان می‌دهد که خودِ تابع باید طول را با استفاده از :c:func:`!wcslen` محاسبه کند. در صورت شکست، ``NULL`` بازمی‌گرداند."

msgid "Copy the Unicode object contents into the :c:type:`wchar_t` buffer *wstr*.  At most *size* :c:type:`wchar_t` characters are copied (excluding a possibly trailing null termination character).  Return the number of :c:type:`wchar_t` characters copied or ``-1`` in case of an error."
msgstr "محتوای شیء یونیکد را در بافر *wstr* از نوع :c:type:`wchar_t` کپی می‌کند. حداکثر *size* نویسه‌ی :c:type:`wchar_t` کپی می‌شود (بدون احتساب نویسه‌ی پایانی تهی که ممکن است در انتها باشد). تعداد نویسه‌های :c:type:`wchar_t` کپی‌شده را برمی‌گرداند و در صورت بروز خطا ``-1``."

msgid "When *wstr* is ``NULL``, instead return the *size* that would be required to store all of *unicode* including a terminating null."
msgstr "وقتی *wstr* برابر ``NULL`` باشد، به‌جای آن *اندازه*‌ای که برای ذخیره‌ی تمام *unicode* شامل یک تهی پایانی لازم است، بازگردانده می‌شود."

msgid "Note that the resulting :c:expr:`wchar_t*` string may or may not be null-terminated.  It is the responsibility of the caller to make sure that the :c:expr:`wchar_t*` string is null-terminated in case this is required by the application. Also, note that the :c:expr:`wchar_t*` string might contain null characters, which would cause the string to be truncated when used with most C functions."
msgstr "توجه داشته باشید که رشته‌ی حاصلِ :c:expr:`wchar_t*` ممکن است تهی‌پایان (null-terminated) باشد یا نباشد. اطمینان از تهی‌پایان بودن رشته‌ی :c:expr:`wchar_t*` در صورتی که برنامه به آن نیاز داشته باشد، بر عهده‌ی فراخوان‌کننده است. همچنین توجه داشته باشید که رشته‌ی :c:expr:`wchar_t*` ممکن است حاوی نویسه‌های تهی باشد، که این امر باعث می‌شود رشته هنگام استفاده در بیشتر توابع C بریده شود."

msgid "Convert the Unicode object to a wide character string. The output string always ends with a null character. If *size* is not ``NULL``, write the number of wide characters (excluding the trailing null termination character) into *\\*size*. Note that the resulting :c:type:`wchar_t` string might contain null characters, which would cause the string to be truncated when used with most C functions. If *size* is ``NULL`` and the :c:expr:`wchar_t*` string contains null characters a :exc:`ValueError` is raised."
msgstr "شیء یونیکد را به یک رشته نویسه پهن تبدیل می‌کند. رشته خروجی همیشه با یک نویسه تهی پایان می‌یابد. اگر *size* برابر ``NULL`` نباشد، تعداد نویسه‌های پهن (بدون احتساب نویسه تهی پایانی) در *\\*size* نوشته می‌شود. توجه داشته باشید که رشته :c:type:`wchar_t` حاصل ممکن است شامل نویسه‌های تهی باشد، که این امر باعث می‌شود رشته هنگام استفاده با بیشتر توابع C قطع شود. اگر *size* برابر ``NULL`` باشد و رشته :c:expr:`wchar_t*` شامل نویسه‌های تهی باشد، :exc:`ValueError` مطرح می‌شود."

msgid "Returns a buffer allocated by :c:macro:`PyMem_New` (use :c:func:`PyMem_Free` to free it) on success. On error, returns ``NULL`` and *\\*size* is undefined. Raises a :exc:`MemoryError` if memory allocation is failed."
msgstr "در صورت موفقیت، بافر تخصیص‌یافته توسط :c:macro:`PyMem_New` را برمی‌گرداند (برای آزاد کردن آن از :c:func:`PyMem_Free` استفاده کنید). در صورت خطا، ``NULL`` برمی‌گرداند و *\\*size* تعریف‌نشده است. در صورت شکست تخصیص حافظه، استثنای :exc:`MemoryError` را ایجاد می‌کند."

msgid "Raises a :exc:`ValueError` if *size* is ``NULL`` and the :c:expr:`wchar_t*` string contains null characters."
msgstr "اگر *size* برابر ``NULL`` باشد و رشته‌ی :c:expr:`wchar_t*` شامل نویسه‌های تهی باشد، استثنای :exc:`ValueError` را مطرح می‌کند."

msgid "Built-in Codecs"
msgstr "کدک‌های توکار"

msgid "Python provides a set of built-in codecs which are written in C for speed. All of these codecs are directly usable via the following functions."
msgstr "پایتون مجموعه‌ای از کدک‌های توکار را ارائه می‌کند که برای سرعت بیشتر به زبان C نوشته‌شده‌اند. همه‌ی این کدک‌ها مستقیماً از طریق توابع زیر قابل استفاده هستند."

msgid "Many of the following APIs take two arguments encoding and errors, and they have the same semantics as the ones of the built-in :func:`str` string object constructor."
msgstr "بسیاری از API‌های زیر دو آرگومان encoding و errors دریافت می‌کنند و معناشناسی این آرگومان‌ها با معناشناسی آرگومان‌های سازنده‌ی شیء رشته‌ی توکار :func:`str` یکسان است."

msgid "Setting encoding to ``NULL`` causes the default encoding to be used which is UTF-8.  The file system calls should use :c:func:`PyUnicode_FSConverter` for encoding file names. This uses the :term:`filesystem encoding and error handler` internally."
msgstr "تنظیم کدگذاری به ``NULL`` باعث می‌شود از کدگذاری پیش‌فرض که UTF-8 است استفاده شود. فراخوانی‌های سامانه فایل‌بندی باید برای کدگذاری نام پرونده‌ها از :c:func:`PyUnicode_FSConverter` استفاده کنند. این تابع به‌طور داخلی از :term:`کدگذاری سامانه فایل‌بندی و هندلر خطا <filesystem encoding and error handler>` استفاده می‌کند."

msgid "Error handling is set by errors which may also be set to ``NULL`` meaning to use the default handling defined for the codec.  Default error handling for all built-in codecs is \"strict\" (:exc:`ValueError` is raised)."
msgstr "رسیدگی به خطا توسط errors تنظیم می‌شود که ممکن است به ``NULL`` نیز تنظیم شود، به این معنا که از رسیدگی پیش‌فرض تعریف‌شده برای کدک استفاده شود.  رسیدگی پیش‌فرض به خطا برای همه‌ی کدک‌های توکار \"strict\" است (استثنای :exc:`ValueError` پرتاب می‌شود)."

msgid "The codecs all use a similar interface.  Only deviations from the following generic ones are documented for simplicity."
msgstr "همه‌ی کدک‌ها از رابط مشابهی استفاده می‌کنند. برای سادگی، تنها انحراف‌ها از رابط‌های عام زیر مستند شده‌اند."

msgid "Generic Codecs"
msgstr "کدک‌های عمومی"

msgid "The following macro is provided:"
msgstr "ماکروی زیر ارائه شده است:"

msgid "The Unicode code point ``U+FFFD`` (replacement character)."
msgstr "نقطه‌کد یونیکد ``U+FFFD`` (نویسه جایگزینی)."

msgid "This Unicode character is used as the replacement character during decoding if the *errors* argument is set to \"replace\"."
msgstr "اگر آرگومان *errors* روی \"replace\" تنظیم شده باشد، از این نویسه‌ی یونیکد در حین کدگشایی به‌عنوان نویسه‌ی جایگزین استفاده می‌شود."

msgid "These are the generic codec APIs:"
msgstr "این‌ها APIهای کدک عام هستند:"

msgid "Create a Unicode object by decoding *size* bytes of the encoded string *str*. *encoding* and *errors* have the same meaning as the parameters of the same name in the :func:`str` built-in function.  The codec to be used is looked up using the Python codec registry.  Return ``NULL`` if an exception was raised by the codec."
msgstr "با کدگشایی *size* بایت از رشته کدگذاری‌شده *str*، یک شیء یونیکد ایجاد می‌کند. *encoding* و *errors* همان معنای پارامترهای هم‌نام در تابع توکار :func:`str` را دارند.  کدک مورد استفاده با بهره‌گیری از رجیستری کدک پایتون جستجو می‌شود.  اگر استثنایی توسط کدک ایجاد‌شده باشد، ``NULL`` برمی‌گرداند."

msgid "Encode a Unicode object and return the result as Python bytes object. *encoding* and *errors* have the same meaning as the parameters of the same name in the Unicode :meth:`~str.encode` method. The codec to be used is looked up using the Python codec registry. Return ``NULL`` if an exception was raised by the codec."
msgstr "یک شیء یونیکد را کدگذاری می‌کند و نتیجه را به‌صورت شیء بایتی پایتون برمی‌گرداند. *encoding* و *errors* همان معنای پارامترهای هم‌نام در متد :meth:`~str.encode` یونیکد را دارند. کدک مورد استفاده از طریق رجیستری کدک پایتون جستجو می‌شود. اگر کدک استثنایی ایجاد کرده باشد، ``NULL`` را برمی‌گرداند."

msgid "UTF-8 Codecs"
msgstr "کدک‌های UTF-8"

msgid "These are the UTF-8 codec APIs:"
msgstr "این‌ها APIهای کدک UTF-8 هستند:"

msgid "Create a Unicode object by decoding *size* bytes of the UTF-8 encoded string *str*. Return ``NULL`` if an exception was raised by the codec."
msgstr "یک شیء یونیکد با کدگشایی *size* بایت از رشته‌ی کدگذاری‌شده با UTF-8 به نام *str* ایجاد می‌کند. اگر کدک استثنایی ایجاد کرده باشد، مقدار ``NULL`` را برمی‌گرداند."

msgid "If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF8`. If *consumed* is not ``NULL``, trailing incomplete UTF-8 byte sequences will not be treated as an error. Those bytes will not be decoded and the number of bytes that have been decoded will be stored in *consumed*."
msgstr "اگر *consumed* برابر ``NULL`` باشد، مانند :c:func:`PyUnicode_DecodeUTF8` رفتار می‌کند. اگر *consumed* برابر ``NULL`` نباشد، دنباله‌های بایتی ناقص انتهایی UTF-8 به عنوان خطا در نظر گرفته نمی‌شوند. این بایت‌ها کدگشایی نمی‌شوند و تعداد بایت‌هایی که کدگشایی شده‌اند در *consumed* ذخیره می‌شود."

msgid "Encode a Unicode object using UTF-8 and return the result as Python bytes object.  Error handling is \"strict\".  Return ``NULL`` if an exception was raised by the codec."
msgstr "یک شیء یونیکد را با استفاده از UTF-8 کدگذاری می‌کند و نتیجه را به‌صورت شیء بایت پایتون برمی‌گرداند. مدیریت خطا «strict» است. اگر کدک استثنایی مطرح کرده باشد، ``NULL`` را برمی‌گرداند."

msgid "The function fails if the string contains surrogate code points (``U+D800`` - ``U+DFFF``)."
msgstr "در صورتی که رشته شامل نقطه‌کدهای جانشین باشد، این تابع شکست می‌خورد (``U+D800`` - ``U+DFFF``)."

msgid "Return a pointer to the UTF-8 encoding of the Unicode object, and store the size of the encoded representation (in bytes) in *size*.  The *size* argument can be ``NULL``; in this case no size will be stored.  The returned buffer always has an extra null byte appended (not included in *size*), regardless of whether there are any other null code points."
msgstr "یک اشاره‌گر به کدگذاری UTF-8 شیء یونیکد را برمی‌گرداند و اندازه‌ی بازنمایش کدگذاری‌شده (بر حسب بایت) را در *size* ذخیره می‌کند. آرگومان *size* می‌تواند ``NULL`` باشد؛ در این حالت هیچ اندازه‌ای ذخیره نمی‌شود. بافر بازگردانده‌شده همیشه یک بایت تهی اضافی در انتها دارد (که در *size* حساب نمی‌شود)، صرف‌نظر از اینکه نقاط کد تهی دیگری وجود داشته باشد یا نه."

msgid "On error, set an exception, set *size* to ``-1`` (if it's not NULL) and return ``NULL``."
msgstr "در صورت خطا، یک استثنا تنظیم کنید، *size* را برابر ``-1`` قرار دهید (اگر NULL نباشد) و ``NULL`` را برگردانید."

msgid "This caches the UTF-8 representation of the string in the Unicode object, and subsequent calls will return a pointer to the same buffer.  The caller is not responsible for deallocating the buffer. The buffer is deallocated and pointers to it become invalid when the Unicode object is garbage collected."
msgstr "این کار نمایش UTF-8 رشته را در شیء یونیکد نهانگاه‌سازی می‌کند و فراخوانی‌های بعدی اشاره‌گری به همان بافر را برمی‌گردانند. فراخواننده مسئول آزاد کردن بافر نیست. زمانی که شیء یونیکد زباله‌روبی شود، بافر آزاد می‌شود و اشاره‌گرهایی که به آن اشاره می‌کنند، نامعتبر می‌شوند."

msgid "The return type is now ``const char *`` rather than ``char *``."
msgstr "نوع بازگشتی اکنون ``const char *`` به‌جای ``char *`` است."

msgid "This function is a part of the :ref:`limited API <limited-c-api>`."
msgstr "این تابع بخشی از :ref:`API محدود <limited-c-api>` است."

msgid "As :c:func:`PyUnicode_AsUTF8AndSize`, but does not store the size."
msgstr "مانند :c:func:`PyUnicode_AsUTF8AndSize`، اما اندازه را ذخیره نمی‌کند."

msgid "This function does not have any special behavior for `null characters <https://en.wikipedia.org/wiki/Null_character>`_ embedded within *unicode*. As a result, strings containing null characters will remain in the returned string, which some C functions might interpret as the end of the string, leading to truncation. If truncation is an issue, it is recommended to use :c:func:`PyUnicode_AsUTF8AndSize` instead."
msgstr "این تابع هیچ رفتار خاصی برای `نویسه‌های تهی <https://en.wikipedia.org/wiki/Null_character>`_ تعبیه‌شده درون *unicode* ندارد. در نتیجه، رشته‌های حاوی نویسه‌های تهی در رشته‌ی برگردانده‌شده باقی می‌مانند و ممکن است برخی توابع C این نویسه‌ها را به‌عنوان پایان رشته تفسیر کنند و همین امر به بریده‌شدن رشته منجر می‌شود. اگر بریده‌شدن رشته مشکل‌ساز باشد، توصیه می‌شود به‌جای آن از :c:func:`PyUnicode_AsUTF8AndSize` استفاده کنید."

msgid "UTF-32 Codecs"
msgstr "کدک‌های UTF-32"

msgid "These are the UTF-32 codec APIs:"
msgstr "این‌ها APIهای کُدک UTF-32 هستند:"

msgid "Decode *size* bytes from a UTF-32 encoded buffer string and return the corresponding Unicode object.  *errors* (if non-``NULL``) defines the error handling. It defaults to \"strict\"."
msgstr "بایت‌های *size* را از یک رشته بافر کدگذاری‌شده با UTF-32 کدگشایی می‌کند و شیء یونیکد متناظر را برمی‌گرداند. *errors* (در صورت ``NULL`` نبودن) برخورد با خطا را تعیین می‌کند. مقدار پیش‌فرض آن \"strict\" است."

msgid "If *byteorder* is non-``NULL``, the decoder starts decoding using the given byte order::"
msgstr "اگر *byteorder* غیر از ``NULL`` باشد، کدگشا کدگشایی را با استفاده از ترتیب بایت داده‌شده آغاز می‌کند::"

msgid ""
"*byteorder == -1: little endian\n"
"*byteorder == 0:  native order\n"
"*byteorder == 1:  big endian"
msgstr ""
"*byteorder == -1: little endian\n"
"*byteorder == 0:  native order\n"
"*byteorder == 1:  big endian"

msgid "If ``*byteorder`` is zero, and the first four bytes of the input data are a byte order mark (BOM), the decoder switches to this byte order and the BOM is not copied into the resulting Unicode string.  If ``*byteorder`` is ``-1`` or ``1``, any byte order mark is copied to the output."
msgstr "اگر ``*byteorder`` صفر باشد و چهار بایت نخست داده‌های ورودی، نشانگر ترتیب بایت (BOM) باشند، کدگشا به این ترتیب بایت تغییر می‌کند و BOM در رشته یونیکد حاصل کپی نمی‌شود.  اگر ``*byteorder`` برابر ``-1`` یا ``1`` باشد، هر نشانگر ترتیب بایتی به خروجی کپی می‌شود."

msgid "After completion, *\\*byteorder* is set to the current byte order at the end of input data."
msgstr "پس از اتمام، *\\*byteorder* به ترتیب بایت جاری در انتهای داده‌های ورودی تنظیم می‌شود."

msgid "If *byteorder* is ``NULL``, the codec starts in native order mode."
msgstr "اگر *byteorder* برابر ``NULL`` باشد، کدک در حالت ترتیب بومی آغاز می‌کند."

msgid "Return ``NULL`` if an exception was raised by the codec."
msgstr "اگر استثنایی توسط کدک مطرح شده باشد، ``NULL`` برمی‌گرداند."

msgid "If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF32`. If *consumed* is not ``NULL``, :c:func:`PyUnicode_DecodeUTF32Stateful` will not treat trailing incomplete UTF-32 byte sequences (such as a number of bytes not divisible by four) as an error. Those bytes will not be decoded and the number of bytes that have been decoded will be stored in *consumed*."
msgstr "اگر *consumed* برابر ``NULL`` باشد، مانند :c:func:`PyUnicode_DecodeUTF32` رفتار می‌کند. اگر *consumed* برابر ``NULL`` نباشد، :c:func:`PyUnicode_DecodeUTF32Stateful` دنباله‌های بایتی ناقص انتهایی UTF-32 (مانند تعدادی بایت که بر چهار بخش‌پذیر نیست) را به عنوان خطا در نظر نمی‌گیرد. این بایت‌ها کدگشایی نمی‌شوند و تعداد بایت‌هایی که کدگشایی شده‌اند در *consumed* ذخیره می‌شود."

msgid "Return a Python byte string using the UTF-32 encoding in native byte order. The string always starts with a BOM mark.  Error handling is \"strict\". Return ``NULL`` if an exception was raised by the codec."
msgstr "یک رشته بایتی پایتون را با استفاده از کدگذاری UTF-32 به ترتیب بایت بومی برمی‌گرداند. این رشته همیشه با نشانگر ترتیب بایت آغاز می‌شود. مدیریت خطا «strict» است. اگر استثنایی توسط کدک مطرح شده باشد، ``NULL`` را برمی‌گرداند."

msgid "UTF-16 Codecs"
msgstr "کدک‌های UTF-16"

msgid "These are the UTF-16 codec APIs:"
msgstr "این‌ها API‌های کدک UTF-16 هستند:"

msgid "Decode *size* bytes from a UTF-16 encoded buffer string and return the corresponding Unicode object.  *errors* (if non-``NULL``) defines the error handling. It defaults to \"strict\"."
msgstr "کدگشایی *size* بایت از یک رشته بافر کدگذاری‌شده با UTF-16 انجام می‌دهد و شیء یونیکد متناظر را برمی‌گرداند. *errors* (در صورت ``NULL`` نبودن) مدیریت خطا را تعیین می‌کند. مقدار پیش‌فرض آن \"strict\" است."

msgid "If ``*byteorder`` is zero, and the first two bytes of the input data are a byte order mark (BOM), the decoder switches to this byte order and the BOM is not copied into the resulting Unicode string.  If ``*byteorder`` is ``-1`` or ``1``, any byte order mark is copied to the output (where it will result in either a ``\\ufeff`` or a ``\\ufffe`` character)."
msgstr "اگر ``*byteorder`` صفر باشد و دو بایت نخست داده‌های ورودی، یک نشانگر ترتیب بایت (BOM) باشند، کدگشا به این ترتیب بایت تغییر می‌کند و BOM در رشته یونیکدی حاصل کپی نمی‌شود. اگر ``*byteorder`` برابر ``-1`` یا ``1`` باشد، هر نشانگر ترتیب بایتی به خروجی کپی می‌شود (که در آن به یک نویسه‌ی ``\\ufeff`` یا ``\\ufffe`` تبدیل خواهد شد)."

msgid "After completion, ``*byteorder`` is set to the current byte order at the end of input data."
msgstr "پس از تکمیل، ``*byteorder`` به ترتیب بایت جاری در انتهای داده‌های ورودی تنظیم می‌شود."

msgid "If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF16`. If *consumed* is not ``NULL``, :c:func:`PyUnicode_DecodeUTF16Stateful` will not treat trailing incomplete UTF-16 byte sequences (such as an odd number of bytes or a split surrogate pair) as an error. Those bytes will not be decoded and the number of bytes that have been decoded will be stored in *consumed*."
msgstr "اگر *consumed* برابر با ``NULL`` باشد، مانند :c:func:`PyUnicode_DecodeUTF16` رفتار می‌کند. اگر *consumed* برابر با ``NULL`` نباشد، :c:func:`PyUnicode_DecodeUTF16Stateful` دنباله‌های بایت ناقص انتهایی UTF-16 (مانند تعداد فردی از بایت‌ها یا یک جفت جانشین جداشده) را به‌عنوان خطا در نظر نمی‌گیرد. این بایت‌ها کدگشایی نمی‌شوند و تعداد بایت‌هایی که کدگشایی شده‌اند در *consumed* ذخیره خواهد شد."

msgid "Return a Python byte string using the UTF-16 encoding in native byte order. The string always starts with a BOM mark.  Error handling is \"strict\". Return ``NULL`` if an exception was raised by the codec."
msgstr "یک رشته بایت پایتون را با استفاده از کدگذاری UTF-16 در ترتیب بایت بومی برمی‌گرداند. این رشته همیشه با نشانگر ترتیب بایت (BOM) آغاز می‌شود. برخورد با خطا «strict» است. اگر توسط کدک استثنایی مطرح شده باشد، ``NULL`` را برمی‌گرداند."

msgid "UTF-7 Codecs"
msgstr "کدک‌های UTF-7"

msgid "These are the UTF-7 codec APIs:"
msgstr "این‌ها API‌های کدک UTF-7 هستند:"

msgid "Create a Unicode object by decoding *size* bytes of the UTF-7 encoded string *str*.  Return ``NULL`` if an exception was raised by the codec."
msgstr "با کدگشایی *size* بایت از رشته‌ی *str* که با UTF-7 کدگذاری شده است، یک شیء یونیکد ایجاد می‌کند. در صورتی که استثنایی از سوی کدک مطرح شده باشد، ``NULL`` را برمی‌گرداند."

msgid "If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF7`.  If *consumed* is not ``NULL``, trailing incomplete UTF-7 base-64 sections will not be treated as an error.  Those bytes will not be decoded and the number of bytes that have been decoded will be stored in *consumed*."
msgstr "اگر *consumed* برابر ``NULL`` باشد، مانند :c:func:`PyUnicode_DecodeUTF7` رفتار می‌کند. اگر *consumed* برابر ``NULL`` نباشد، بخش‌های ناقص پایانی base-64 در UTF-7 به‌عنوان خطا تلقی نمی‌شوند. این بایت‌ها کدگشایی نمی‌شوند و تعداد بایت‌هایی که کدگشایی شده‌اند در *consumed* ذخیره می‌شود."

msgid "Unicode-Escape Codecs"
msgstr "کدک‌های Unicode-Escape"

msgid "These are the \"Unicode Escape\" codec APIs:"
msgstr "این‌ها API‌های کدک «Unicode Escape» هستند:"

msgid "Create a Unicode object by decoding *size* bytes of the Unicode-Escape encoded string *str*.  Return ``NULL`` if an exception was raised by the codec."
msgstr "با کدگشایی *size* بایت از رشته *str* که با Unicode-Escape کدگذاری شده است، یک شیء یونیکد ایجاد می‌کند.  اگر استثنایی توسط کدک مطرح شده باشد، ``NULL`` را برمی‌گرداند."

msgid "Encode a Unicode object using Unicode-Escape and return the result as a bytes object.  Error handling is \"strict\".  Return ``NULL`` if an exception was raised by the codec."
msgstr "یک شیء یونیکد را با استفاده از Unicode-Escape کدگذاری می‌کند و نتیجه را به‌صورت یک شیء بایت برمی‌گرداند.  مدیریت خطا \"strict\" است.  اگر کدک استثنایی پرتاب کرده باشد، ``NULL`` برمی‌گرداند."

msgid "Raw-Unicode-Escape Codecs"
msgstr "کدک‌های Raw-Unicode-Escape"

msgid "These are the \"Raw Unicode Escape\" codec APIs:"
msgstr "این‌ها API‌های کدک «Raw Unicode Escape» هستند:"

msgid "Create a Unicode object by decoding *size* bytes of the Raw-Unicode-Escape encoded string *str*.  Return ``NULL`` if an exception was raised by the codec."
msgstr "با کدگشایی *size* بایت از رشته‌ی *str* کدگذاری‌شده با Raw-Unicode-Escape، یک شیء یونیکد ایجاد می‌کند. اگر استثنایی توسط کدک ایجاد شده باشد، ``NULL`` برمی‌گرداند."

msgid "Encode a Unicode object using Raw-Unicode-Escape and return the result as a bytes object.  Error handling is \"strict\".  Return ``NULL`` if an exception was raised by the codec."
msgstr "یک شیء یونیکد را با استفاده از Raw-Unicode-Escape کدگذاری کرده و نتیجه را به‌صورت یک شیء بایت برمی‌گرداند.  مدیریت خطا «strict» است.  در صورت ایجاد استثنا توسط کدک، ``NULL`` برگردانده می‌شود."

msgid "Latin-1 Codecs"
msgstr "کدک‌های Latin-1"

msgid "These are the Latin-1 codec APIs: Latin-1 corresponds to the first 256 Unicode ordinals and only these are accepted by the codecs during encoding."
msgstr "این‌ها API‌های کدک Latin-1 هستند: Latin-1 با نخستین ۲۵۶ مقدار ترتیبی یونیکد مطابقت دارد و کدک‌ها هنگام کدگذاری تنها همین مقادیر را می‌پذیرند."

msgid "Create a Unicode object by decoding *size* bytes of the Latin-1 encoded string *str*.  Return ``NULL`` if an exception was raised by the codec."
msgstr "با کدگشایی *size* بایت از رشته‌ی *str* کدگذاری‌شده با Latin-1، یک شیء یونیکد ایجاد می‌کند.  اگر کدک استثنایی ایجاد کرده باشد، ``NULL`` را برمی‌گرداند."

msgid "Encode a Unicode object using Latin-1 and return the result as Python bytes object.  Error handling is \"strict\".  Return ``NULL`` if an exception was raised by the codec."
msgstr "شیء یونیکد را با استفاده از Latin-1 کدگذاری می‌کند و نتیجه را به‌صورت شیء بایت پایتون برمی‌گرداند. رسیدگی به خطا «strict» است. اگر استثنایی توسط کدک مطرح شده باشد، ``NULL`` برمی‌گرداند."

msgid "ASCII Codecs"
msgstr "کدک‌های اسکی"

msgid "These are the ASCII codec APIs.  Only 7-bit ASCII data is accepted. All other codes generate errors."
msgstr "این‌ها APIهای کدک اسکی هستند. فقط داده‌های اسکی ۷-بیتی پذیرفته می‌شوند. تمامی کدهای دیگر خطا ایجاد می‌کنند."

msgid "Create a Unicode object by decoding *size* bytes of the ASCII encoded string *str*.  Return ``NULL`` if an exception was raised by the codec."
msgstr "یک شیء یونیکد را با کدگشایی *size* بایت از رشته‌ی کدگذاری‌شده‌ی اسکی *str* ایجاد کنید. اگر کدک استثنایی ایجاد کرده باشد، ``NULL`` را برگردانید."

msgid "Encode a Unicode object using ASCII and return the result as Python bytes object.  Error handling is \"strict\".  Return ``NULL`` if an exception was raised by the codec."
msgstr "یک شیء یونیکد را با استفاده از اسکی کدگذاری کرده و نتیجه را به‌صورت شیء بایت پایتون برمی‌گرداند. مدیریت خطا «strict» است. اگر کدک استثنایی ایجاد کند، ``NULL`` را برمی‌گرداند."

msgid "Character Map Codecs"
msgstr "کدک‌های نگاشت نویسه"

msgid "This codec is special in that it can be used to implement many different codecs (and this is in fact what was done to obtain most of the standard codecs included in the :mod:`!encodings` package). The codec uses mappings to encode and decode characters.  The mapping objects provided must support the :meth:`~object.__getitem__` mapping interface; dictionaries and sequences work well."
msgstr "این کدک از این نظر خاص است که می‌توان از آن برای پیاده‌سازی بسیاری از کدک‌های مختلف استفاده کرد (و در واقع همین کار برای به دست آوردن اکثر کدک‌های استاندارد موجود در بسته‌ی :mod:`!encodings` انجام شده است). این کدک برای کدگذاری و کدگشایی نویسه‌ها از نگاشت‌ها استفاده می‌کند. شیءهای نگاشتی ارائه‌شده باید از رابط نگاشت :meth:`~object.__getitem__` پشتیبانی کنند؛ دیکشنری‌ها و دنباله‌ها به‌خوبی کار می‌کنند."

msgid "These are the mapping codec APIs:"
msgstr "این‌ها APIهای کدک‌های نگاشتی هستند:"

msgid "Create a Unicode object by decoding *size* bytes of the encoded string *str* using the given *mapping* object.  Return ``NULL`` if an exception was raised by the codec."
msgstr "با کدگشایی *size* بایت از رشته‌ی کدگذاری‌شده‌ی *str* با استفاده از شیء نگاشت *mapping* داده‌شده، یک شیء یونیکد ایجاد می‌کند. اگر کدک استثنایی پرتاب کند، ``NULL`` را برمی‌گرداند."

msgid "If *mapping* is ``NULL``, Latin-1 decoding will be applied.  Else *mapping* must map bytes ordinals (integers in the range from 0 to 255) to Unicode strings, integers (which are then interpreted as Unicode ordinals) or ``None``.  Unmapped data bytes -- ones which cause a :exc:`LookupError`, as well as ones which get mapped to ``None``, ``0xFFFE`` or ``'\\ufffe'``, are treated as undefined mappings and cause an error."
msgstr "اگر *mapping* برابر ``NULL`` باشد، کدگشایی Latin-1 اعمال خواهد شد. در غیر این صورت، *mapping* باید مقادیر ترتیبی بایت‌ها (اعداد صحیح در بازه‌ی ۰ تا ۲۵۵) را به رشته‌های یونیکد، اعداد صحیح (که سپس به عنوان مقادیر ترتیبی یونیکد تفسیر می‌شوند) یا ``None`` نگاشت کند. بایت‌های داده‌ی نگاشت‌نشده -- بایت‌هایی که موجب :exc:`LookupError` می‌شوند و همچنین بایت‌هایی که به ``None``، ``0xFFFE`` یا ``'\\ufffe'`` نگاشت می‌شوند -- به عنوان نگاشت‌های تعریف‌نشده در نظر گرفته می‌شوند و باعث خطا می‌شوند."

msgid "Encode a Unicode object using the given *mapping* object and return the result as a bytes object.  Error handling is \"strict\".  Return ``NULL`` if an exception was raised by the codec."
msgstr "یک شیء یونیکد را با استفاده از شیء *نگاشت* داده‌شده کدگذاری می‌کند و نتیجه را به‌صورت یک شیء بایت برمی‌گرداند. مدیریت خطا «strict» است. اگر کدک استثنایی ایجاد کرده باشد، ``NULL`` برمی‌گرداند."

msgid "The *mapping* object must map Unicode ordinal integers to bytes objects, integers in the range from 0 to 255 or ``None``.  Unmapped character ordinals (ones which cause a :exc:`LookupError`) as well as mapped to ``None`` are treated as \"undefined mapping\" and cause an error."
msgstr "شیء *نگاشت* باید اعداد صحیح ترتیبی یونیکد را به اشیاء بایت، اعداد صحیح در بازه‌ی ۰ تا ۲۵۵ یا ``None`` نگاشت کند. شماره‌های ترتیبی نویسه‌های نگاشت‌نشده (همان‌هایی که باعث :exc:`LookupError` می‌شوند) و همچنین آن‌هایی که به ``None`` نگاشت شده‌اند، به‌عنوان «نگاشت تعریف‌نشده» در نظر گرفته می‌شوند و باعث خطا می‌شوند."

msgid "The following codec API is special in that maps Unicode to Unicode."
msgstr "API کدک زیر از این جهت ویژه است که یونیکد را به یونیکد نگاشت می‌کند."

msgid "Translate a string by applying a character mapping table to it and return the resulting Unicode object. Return ``NULL`` if an exception was raised by the codec."
msgstr "یک رشته را با اعمال جدول نگاشت نویسه بر روی آن ترجمه می‌کند و شیء یونیکد حاصل را برمی‌گرداند. اگر کدک استثنا را پرتاب کرده باشد، ``NULL`` برمی‌گرداند."

msgid "The mapping table must map Unicode ordinal integers to Unicode ordinal integers or ``None`` (causing deletion of the character)."
msgstr "جدول نگاشت باید اعداد صحیح ترتیبی یونیکد را به اعداد صحیح ترتیبی یونیکد یا ``None`` (که باعث حذف نویسه می‌شود) نگاشت کند."

msgid "Mapping tables need only provide the :meth:`~object.__getitem__` interface; dictionaries and sequences work well.  Unmapped character ordinals (ones which cause a :exc:`LookupError`) are left untouched and are copied as-is."
msgstr "برای جدول‌های نگاشت، تنها ارائه رابط :meth:`~object.__getitem__` کافی است؛ دیکشنری‌ها و دنباله‌ها به‌خوبی کار می‌کنند.  ترتیبی‌های نگاشت‌نشده‌ی نویسه‌ها (آن‌هایی که باعث :exc:`LookupError` می‌شوند) دست‌نخورده باقی می‌مانند و به همان صورت کپی می‌شوند."

msgid "*errors* has the usual meaning for codecs. It may be ``NULL`` which indicates to use the default error handling."
msgstr "*errors* برای کدک‌ها معنای متداول خود را دارد. ممکن است ``NULL`` باشد که نشان می‌دهد از مدیریت خطای پیش‌فرض استفاده شود."

msgid "MBCS codecs for Windows"
msgstr "کدک‌های MBCS برای ویندوز"

msgid "These are the MBCS codec APIs. They are currently only available on Windows and use the Win32 MBCS converters to implement the conversions.  Note that MBCS (or DBCS) is a class of encodings, not just one.  The target encoding is defined by the user settings on the machine running the codec."
msgstr "این‌ها APIهای کدک MBCS هستند. آن‌ها در حال حاضر فقط در ویندوز در دسترس هستند و از مبدل‌های MBCS در Win32 برای پیاده‌سازی تبدیل‌ها استفاده می‌کنند. توجه داشته باشید که MBCS (یا DBCS) دسته‌ای از کدگذاری‌هاست، نه فقط یک کدگذاری. کدگذاری مقصد توسط تنظیمات کاربر روی رایانه‌ای که کدک روی آن اجرا می‌شود تعریف می‌شود."

msgid "Create a Unicode object by decoding *size* bytes of the MBCS encoded string *str*. Return ``NULL`` if an exception was raised by the codec."
msgstr "با کدگشایی *size* بایت از رشته‌ی کدگذاری‌شده‌ی MBCS با نام *str*، یک شیء یونیکد ایجاد می‌کند. اگر کدک استثنایی مطرح کرده باشد، ``NULL`` برمی‌گرداند."

msgid "If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeMBCS`. If *consumed* is not ``NULL``, :c:func:`PyUnicode_DecodeMBCSStateful` will not decode trailing lead byte and the number of bytes that have been decoded will be stored in *consumed*."
msgstr "اگر *consumed* برابر ``NULL`` باشد، رفتاری مانند :c:func:`PyUnicode_DecodeMBCS` خواهد داشت. اگر *consumed* برابر ``NULL`` نباشد، :c:func:`PyUnicode_DecodeMBCSStateful` بایت پیشروی انتهایی (trailing lead byte) را کدگشایی نمی‌کند و تعداد بایت‌هایی که کدگشایی شده‌اند در *consumed* ذخیره می‌شود."

msgid "Similar to :c:func:`PyUnicode_DecodeMBCSStateful`, except uses the code page specified by *code_page*."
msgstr "مشابه :c:func:`PyUnicode_DecodeMBCSStateful`، با این تفاوت که از صفحه کد مشخص‌شده توسط *code_page* استفاده می‌کند."

msgid "Encode a Unicode object using MBCS and return the result as Python bytes object.  Error handling is \"strict\".  Return ``NULL`` if an exception was raised by the codec."
msgstr "یک شیء یونیکد را با استفاده از MBCS کدگذاری می‌کند و نتیجه را به‌صورت شیء بایت پایتون برمی‌گرداند. مدیریت خطا «strict» است. اگر استثنایی توسط کدک ایجاد شده باشد، ``NULL`` برمی‌گرداند."

msgid "Encode the Unicode object using the specified code page and return a Python bytes object.  Return ``NULL`` if an exception was raised by the codec. Use :c:macro:`!CP_ACP` code page to get the MBCS encoder."
msgstr "شیء یونیکد را با استفاده از صفحه کد مشخص‌شده کدگذاری کرده و یک شیء بایت پایتون را برمی‌گرداند. اگر کدک استثنایی مطرح کرده باشد، ``NULL`` برمی‌گرداند. برای گرفتن کدگذار MBCS از صفحه کد :c:macro:`!CP_ACP` استفاده کنید."

msgid "Methods and Slot Functions"
msgstr "متدها و توابع جایگاهی"

msgid "The following APIs are capable of handling Unicode objects and strings on input (we refer to them as strings in the descriptions) and return Unicode objects or integers as appropriate."
msgstr "APIهای زیر می‌توانند اشیاء یونیکد و رشته‌ها را در ورودی مدیریت کنند (در توضیحات، آن‌ها را رشته می‌نامیم) و بسته به مورد، شیء یونیکد یا عدد صحیح برمی‌گردانند."

msgid "They all return ``NULL`` or ``-1`` if an exception occurs."
msgstr "همگی در صورت وقوع استثنا ``NULL`` یا ``-1`` را برمی‌گردانند."

msgid "Concat two strings giving a new Unicode string."
msgstr "دو رشته را الحاق می‌کند و یک رشته یونیکد جدید به دست می‌دهد."

msgid "Split a string giving a list of Unicode strings.  If *sep* is ``NULL``, splitting will be done at all whitespace substrings.  Otherwise, splits occur at the given separator.  At most *maxsplit* splits will be done.  If negative, no limit is set.  Separators are not included in the resulting list."
msgstr "یک رشته را تقسیم می‌کند و فهرستی از رشته‌های یونیکد به دست می‌دهد. اگر *sep* برابر ``NULL`` باشد، تقسیم در تمام زیررشته‌های فضای سفید انجام می‌شود. در غیر این صورت، تقسیم‌ها در جداکننده‌ی داده‌شده رخ می‌دهند. حداکثر *maxsplit* تقسیم انجام می‌شود. اگر منفی باشد، هیچ محدودیتی تعیین نمی‌شود. جداکننده‌ها در فهرست حاصل قرار نمی‌گیرند."

msgid "On error, return ``NULL`` with an exception set."
msgstr "در صورت خطا، ``NULL`` همراه با یک استثنا تنظیم‌شده برگردانده می‌شود."

msgid "Equivalent to :py:meth:`str.split`."
msgstr "معادل :py:meth:`str.split` است."

msgid "Similar to :c:func:`PyUnicode_Split`, but splitting will be done beginning at the end of the string."
msgstr "مشابه :c:func:`PyUnicode_Split` است، اما تفکیک از انتهای رشته آغاز خواهد شد."

msgid "Equivalent to :py:meth:`str.rsplit`."
msgstr "معادل :py:meth:`str.rsplit` است."

msgid "Split a Unicode string at line breaks, returning a list of Unicode strings. CRLF is considered to be one line break.  If *keepends* is ``0``, the Line break characters are not included in the resulting strings."
msgstr "یک رشته یونیکد را در شکست‌های سطر تفکیک می‌کند و فهرستی از رشته‌های یونیکد برمی‌گرداند. CRLF به عنوان یک شکست سطر در نظر گرفته می‌شود. اگر *keepends* برابر ``0`` باشد، نویسه‌های شکست سطر در رشته‌های حاصل گنجانده نمی‌شوند."

msgid "Split a Unicode string at the first occurrence of *sep*, and return a 3-tuple containing the part before the separator, the separator itself, and the part after the separator. If the separator is not found, return a 3-tuple containing the string itself, followed by two empty strings."
msgstr "یک رشته یونیکد را در نخستین رخداد *sep* تقسیم می‌کند و یک تاپل سه‌تایی شامل بخش پیش از جداکننده، خود جداکننده و بخش پس از جداکننده برمی‌گرداند. اگر جداکننده یافت نشود، یک تاپل سه‌تایی شامل خود رشته و به دنبال آن دو رشته خالی برمی‌گرداند."

msgid "*sep* must not be empty."
msgstr "*sep* نباید خالی باشد."

msgid "Equivalent to :py:meth:`str.partition`."
msgstr "معادل با :py:meth:`str.partition` است."

msgid "Similar to :c:func:`PyUnicode_Partition`, but split a Unicode string at the last occurrence of *sep*. If the separator is not found, return a 3-tuple containing two empty strings, followed by the string itself."
msgstr "مشابه :c:func:`PyUnicode_Partition` است، اما یک رشته‌ی یونیکد را در آخرین رخداد *sep* جدا می‌کند. اگر جداکننده یافت نشود، یک تاپل سه‌تایی شامل دو رشته‌ی خالی و سپس خودِ رشته را برمی‌گرداند."

msgid "Equivalent to :py:meth:`str.rpartition`."
msgstr "معادل :py:meth:`str.rpartition` است."

msgid "Join a sequence of strings using the given *separator* and return the resulting Unicode string."
msgstr "دنباله‌ای از رشته‌ها را با استفاده از *جداکننده*\\ ‌ی داده‌شده الحاق کنید و رشته‌ی یونیکدی حاصل را برگردانید."

msgid "Return ``1`` if *substr* matches ``unicode[start:end]`` at the given tail end (*direction* == ``-1`` means to do a prefix match, *direction* == ``1`` a suffix match), ``0`` otherwise. Return ``-1`` if an error occurred."
msgstr "اگر *substr* با ``unicode[start:end]`` در انتهای مشخص‌شده تطبیق داشته باشد، ``1`` را برمی‌گرداند (*direction* == ``-1`` به معنای انجام تطبیق پیشوند و *direction* == ``1`` به معنای تطبیق پسوند است)، در غیر این صورت ``0``. در صورت وقوع خطا ``-1`` برمی‌گرداند."

msgid "Return the first position of *substr* in ``unicode[start:end]`` using the given *direction* (*direction* == ``1`` means to do a forward search, *direction* == ``-1`` a backward search).  The return value is the index of the first match; a value of ``-1`` indicates that no match was found, and ``-2`` indicates that an error occurred and an exception has been set."
msgstr "اولین موقعیت *substr* در ``unicode[start:end]`` را با استفاده از *direction* داده‌شده برمی‌گرداند (*direction* == ``1`` به معنای انجام جستجوی رو به جلو و *direction* == ``-1`` به معنای جستجوی رو به عقب است). مقدار بازگشتی اندیس اولین تطبیق است؛ مقدار ``-1`` نشان می‌دهد که هیچ تطبیقی یافت نشد و ``-2`` نشان می‌دهد که خطایی رخ داده و استثنایی تنظیم شده است."

msgid "Return the first position of the character *ch* in ``unicode[start:end]`` using the given *direction* (*direction* == ``1`` means to do a forward search, *direction* == ``-1`` a backward search).  The return value is the index of the first match; a value of ``-1`` indicates that no match was found, and ``-2`` indicates that an error occurred and an exception has been set."
msgstr "اولین موقعیت نویسه *ch* در ``unicode[start:end]`` را با استفاده از *direction* داده‌شده برمی‌گرداند (*direction* == ``1`` به معنای انجام جستجوی رو به جلو است و *direction* == ``-1`` به معنای جستجوی رو به عقب). مقدار بازگشتی، اندیس اولین تطبیق است؛ مقدار ``-1`` نشان می‌دهد که هیچ تطبیقی یافت نشد و ``-2`` نشان می‌دهد که خطایی رخ داده و استثنایی تنظیم شده است."

msgid "*start* and *end* are now adjusted to behave like ``unicode[start:end]``."
msgstr "*start* و *end* اکنون به‌گونه‌ای تنظیم شده‌اند که مانند ``unicode[start:end]`` رفتار کنند."

msgid "Return the number of non-overlapping occurrences of *substr* in ``unicode[start:end]``.  Return ``-1`` if an error occurred."
msgstr "تعداد رخدادهای بدون هم‌پوشانی *substr* در ``unicode[start:end]`` را برمی‌گرداند. در صورت وقوع خطا، ``-1`` برگردانده می‌شود."

msgid "Replace at most *maxcount* occurrences of *substr* in *unicode* with *replstr* and return the resulting Unicode object. *maxcount* == ``-1`` means replace all occurrences."
msgstr "حداکثر *maxcount* تکرار از *substr* در *unicode* را با *replstr* جایگزین می‌کند و شیء یونیکد حاصل را برمی‌گرداند. *maxcount* == ``-1`` به معنای جایگزینی همه‌ی تکرارها است."

msgid "Compare two strings and return ``-1``, ``0``, ``1`` for less than, equal, and greater than, respectively."
msgstr "دو رشته را مقایسه می‌کند و اگر کوچک‌تر باشد ``-1``، اگر مساوی باشد ``0`` و اگر بزرگ‌تر باشد ``1`` برمی‌گرداند."

msgid "This function returns ``-1`` upon failure, so one should call :c:func:`PyErr_Occurred` to check for errors."
msgstr "این تابع در صورت شکست ``-1`` را برمی‌گرداند، بنابراین برای بررسی خطاها باید :c:func:`PyErr_Occurred` را فراخوانی کنید."

msgid "The :c:func:`PyUnicode_Equal` function."
msgstr "تابع :c:func:`PyUnicode_Equal`."

msgid "Test if two strings are equal:"
msgstr "آزمون کنید که آیا دو رشته برابرند:"

msgid "Return ``1`` if *a* is equal to *b*."
msgstr "اگر *a* برابر با *b* باشد، ``1`` را برمی‌گرداند."

msgid "Return ``0`` if *a* is not equal to *b*."
msgstr "اگر *a* برابر *b* نباشد، ``0`` را برمی‌گرداند."

msgid "Set a :exc:`TypeError` exception and return ``-1`` if *a* or *b* is not a :class:`str` object."
msgstr "اگر *a* یا *b* یک شیء :class:`str` نباشد، یک استثنای :exc:`TypeError` تنظیم می‌شود و ``-1`` برگردانده می‌شود."

msgid "The function always succeeds if *a* and *b* are :class:`str` objects."
msgstr "اگر *a* و *b* شیءهای :class:`str` باشند، این تابع همیشه با موفقیت اجرا می‌شود."

msgid "The function works for :class:`str` subclasses, but does not honor custom ``__eq__()`` method."
msgstr "این تابع برای زیرکلاس‌های :class:`str` کار می‌کند، اما متد سفارشی ``__eq__()`` را رعایت نمی‌کند."

msgid "The :c:func:`PyUnicode_Compare` function."
msgstr "تابع :c:func:`PyUnicode_Compare`."

msgid "Compare a Unicode object with a char buffer which is interpreted as being UTF-8 or ASCII encoded and return true (``1``) if they are equal, or false (``0``) otherwise. If the Unicode object contains surrogate code points (``U+D800`` - ``U+DFFF``) or the C string is not valid UTF-8, false (``0``) is returned."
msgstr "یک شیء یونیکد را با یک بافر کاراکتری که به‌عنوان کدگذاری‌شده با UTF-8 یا اسکی تفسیر می‌شود، مقایسه می‌کند و در صورت برابری آن‌ها مقدار درست (``1``) و در غیر این صورت مقدار نادرست (``0``) را برمی‌گرداند. اگر شیء یونیکد شامل نقطه‌کدهای جانشین (``U+D800`` - ``U+DFFF``) باشد یا رشته‌ی C یک UTF-8 معتبر نباشد، مقدار نادرست (``0``) برگردانده می‌شود."

msgid "This function does not raise exceptions."
msgstr "این تابع هیچ استثنایی ایجاد نمی‌کند."

msgid "Similar to :c:func:`PyUnicode_EqualToUTF8AndSize`, but compute *string* length using :c:func:`!strlen`. If the Unicode object contains null characters, false (``0``) is returned."
msgstr "مشابه :c:func:`PyUnicode_EqualToUTF8AndSize` است، اما طول *string* با استفاده از :c:func:`!strlen` محاسبه می‌شود. اگر شیء یونیکد شامل نویسه‌های تهی باشد، مقدار نادرست (``0``) بازگردانده می‌شود."

msgid "Compare a Unicode object, *unicode*, with *string* and return ``-1``, ``0``, ``1`` for less than, equal, and greater than, respectively. It is best to pass only ASCII-encoded strings, but the function interprets the input string as ISO-8859-1 if it contains non-ASCII characters."
msgstr "شیء یونیکد *unicode* را با *string* مقایسه می‌کند و به ترتیب برای کمتر از، برابر با و بزرگ‌تر از، ``-1``، ``0`` و ``1`` را برمی‌گرداند. بهتر است فقط رشته‌های کدگذاری‌شده با اسکی ارسال شوند، اما تابع در صورتی که رشته ورودی شامل نویسه‌های غیراسکی باشد، آن را به عنوان ISO-8859-1 تفسیر می‌کند."

msgid "Rich compare two Unicode strings and return one of the following:"
msgstr "مقایسه غنی (rich compare) دو رشته یونیکد را انجام می‌دهد و یکی از موارد زیر را برمی‌گرداند:"

msgid "``NULL`` in case an exception was raised"
msgstr "``NULL`` در صورتی که استثنایی رخ داده باشد"

msgid ":c:data:`Py_True` or :c:data:`Py_False` for successful comparisons"
msgstr ":c:data:`Py_True` یا :c:data:`Py_False` برای مقایسه‌های موفق"

msgid ":c:data:`Py_NotImplemented` in case the type combination is unknown"
msgstr ":c:data:`Py_NotImplemented` در صورتی که ترکیب نوع‌ها نا‌شناخته باشد"

msgid "Possible values for *op* are :c:macro:`Py_GT`, :c:macro:`Py_GE`, :c:macro:`Py_EQ`, :c:macro:`Py_NE`, :c:macro:`Py_LT`, and :c:macro:`Py_LE`."
msgstr "مقادیر ممکن برای *op* عبارت‌اند از :c:macro:`Py_GT`، :c:macro:`Py_GE`، :c:macro:`Py_EQ`، :c:macro:`Py_NE`، :c:macro:`Py_LT` و :c:macro:`Py_LE`."

msgid "Return a new string object from *format* and *args*; this is analogous to ``format % args``."
msgstr "شیء رشته‌ی جدیدی از *format* و *args* برمی‌گرداند؛ این همانند ``format % args`` است."

msgid "Check whether *substr* is contained in *unicode* and return true or false accordingly."
msgstr "بررسی می‌کند که آیا *substr* در *unicode* موجود است و مطابق آن true یا false برمی‌گرداند."

msgid "*substr* has to coerce to a one element Unicode string. ``-1`` is returned if there was an error."
msgstr "*substr* باید به یک رشته یونیکدی تک‌عنصری تبدیل‌پذیر باشد. اگر خطایی رخ داده باشد، ``-1`` بازگردانده می‌شود."

msgid "Intern the argument :c:expr:`*p_unicode` in place.  The argument must be the address of a pointer variable pointing to a Python Unicode string object.  If there is an existing interned string that is the same as :c:expr:`*p_unicode`, it sets :c:expr:`*p_unicode` to it (releasing the reference to the old string object and creating a new :term:`strong reference` to the interned string object), otherwise it leaves :c:expr:`*p_unicode` alone and interns it."
msgstr "آرگومان :c:expr:`*p_unicode` را به‌صورت درجا درون‌سازی (intern) می‌کند. این آرگومان باید نشانی یک متغیر اشاره‌گر باشد که به یک شیء رشته یونیکد پایتون اشاره کند. اگر رشته‌ای از پیش درونی‌سازی‌شده موجود باشد که با :c:expr:`*p_unicode` یکسان باشد، :c:expr:`*p_unicode` را برابر آن قرار می‌دهد (با آزاد کردن ارجاع به شیء رشته قدیمی و ایجاد یک :term:`ارجاع قوی <strong reference>` جدید به شیء رشته درونی‌سازی‌شده)، در غیر این صورت :c:expr:`*p_unicode` را دست‌نخورده باقی می‌گذارد و آن را درون‌سازی می‌کند."

msgid "(Clarification: even though there is a lot of talk about references, think of this function as reference-neutral. You must own the object you pass in; after the call you no longer own the passed-in reference, but you newly own the result.)"
msgstr "(توضیح: هرچند بحث‌های فراوانی درباره‌ی ارجاع‌ها مطرح می‌شود، این تابع را از نظر ارجاع خنثی در نظر بگیرید. باید مالک شیء‌ای که ارسال می‌کنید باشید؛ پس از فراخوانی، دیگر مالک ارجاعی که ارسال کرده‌اید نیستید، اما از این پس مالک نتیجه هستید.)"

msgid "This function never raises an exception. On error, it leaves its argument unchanged without interning it."
msgstr "این تابع هرگز استثنایی ایجاد نمی‌کند. در صورت بروز خطا، آرگومان خود را بدون تغییر باقی می‌گذارد و آن را درون‌سازی (interning) نمی‌کند."

msgid "Instances of subclasses of :py:class:`str` may not be interned, that is, :c:expr:`PyUnicode_CheckExact(*p_unicode)` must be true. If it is not, then -- as with any other error -- the argument is left unchanged."
msgstr "نمونه‌های زیرکلاس‌های :py:class:`str` ممکن است درون‌سازی نشوند؛ به این معنا که :c:expr:`PyUnicode_CheckExact(*p_unicode)` باید درست باشد. اگر چنین نباشد، آرگومان — مانند هر خطای دیگر — بدون تغییر باقی می‌ماند."

msgid "Note that interned strings are not “immortal”. You must keep a reference to the result to benefit from interning."
msgstr "توجه داشته باشید که رشته‌های درونی‌سازی‌شده «نامیرا» نیستند. برای بهره‌مندی از درون‌سازی، باید ارجاعی به نتیجه نگه دارید."

msgid "A combination of :c:func:`PyUnicode_FromString` and :c:func:`PyUnicode_InternInPlace`, meant for statically allocated strings."
msgstr "ترکیبی از :c:func:`PyUnicode_FromString` و :c:func:`PyUnicode_InternInPlace`، که برای رشته‌های تخصیص‌یافته به‌صورت ایستا در نظر گرفته شده است."

msgid "Return a new (\"owned\") reference to either a new Unicode string object that has been interned, or an earlier interned string object with the same value."
msgstr "بازگرداندن ارجاعی جدید (مالکانه — owned) به یک شیء رشته‌ی یونیکدی جدید که درون‌سازی (intern) شده است، یا به یک شیء رشته‌ی درونی‌سازی‌شده‌ی قبلی با همان مقدار."

msgid "Python may keep a reference to the result, or make it :term:`immortal`, preventing it from being garbage-collected promptly. For interning an unbounded number of different strings, such as ones coming from user input, prefer calling :c:func:`PyUnicode_FromString` and :c:func:`PyUnicode_InternInPlace` directly."
msgstr "پایتون ممکن است ارجاعی به نتیجه را نگه دارد، یا آن را :term:`نامیرا <immortal>` کند و در نتیجه مانع از زباله‌روبی به‌موقع آن شود. برای درونی‌سازی تعداد نامحدودی از رشته‌های متفاوت، مانند رشته‌هایی که از ورودی کاربر می‌آیند، ترجیح دهید :c:func:`PyUnicode_FromString` و :c:func:`PyUnicode_InternInPlace` را مستقیماً فراخوانی کنید."

msgid "Return a non-zero value if *str* is interned, zero if not. The *str* argument must be a string; this is not checked. This function always succeeds."
msgstr "اگر *str* درونی‌سازی‌شده باشد، مقدار غیرصفر و در غیر این صورت صفر را برمی‌گرداند. آرگومان *str* باید یک رشته باشد؛ این مورد بررسی نمی‌شود. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "A non-zero return value may carry additional information about *how* the string is interned. The meaning of such non-zero values, as well as each specific string's intern-related details, may change between CPython versions."
msgstr "مقدار بازگشتی ناصفر ممکن است حاوی اطلاعات بیشتری درباره‌ی *چگونگی* درون‌سازی رشته باشد. معنای چنین مقادیر ناصفری، و همچنین جزئیات مربوط به درون‌سازی هر رشته‌ی خاص، ممکن است بین نسخه‌های سی‌پایتون تغییر کند."

msgid "PyUnicodeWriter"
msgstr "PyUnicodeWriter"

msgid "The :c:type:`PyUnicodeWriter` API can be used to create a Python :class:`str` object."
msgstr "از API :c:type:`PyUnicodeWriter` می‌توان برای ایجاد یک شیء :class:`str` پایتونی استفاده کرد."

msgid "A Unicode writer instance."
msgstr "یک نمونه‌ی نوشتارگر یونیکد."

msgid "The instance must be destroyed by :c:func:`PyUnicodeWriter_Finish` on success, or :c:func:`PyUnicodeWriter_Discard` on error."
msgstr "نمونه باید در صورت موفقیت توسط :c:func:`PyUnicodeWriter_Finish` یا در صورت خطا توسط :c:func:`PyUnicodeWriter_Discard` نابود شود."

msgid "Create a Unicode writer instance."
msgstr "یک نمونه از نویسنده یونیکد ایجاد کنید."

msgid "*length* must be greater than or equal to ``0``."
msgstr "*length* باید بزرگ‌تر یا مساوی ``0`` باشد."

msgid "If *length* is greater than ``0``, preallocate an internal buffer of *length* characters."
msgstr "اگر *length* بزرگ‌تر از ``0`` باشد، یک بافر داخلی به اندازه‌ی *length* نویسه از پیش تخصیص می‌دهد."

msgid "Set an exception and return ``NULL`` on error."
msgstr "در صورت خطا، یک استثنا تنظیم کرده و ``NULL`` را برگردانید."

msgid "Return the final Python :class:`str` object and destroy the writer instance."
msgstr "شیء :class:`str` نهایی پایتون را برمی‌گرداند و نمونه‌ی نویسنده را نابود می‌کند."

msgid "The writer instance is invalid after this call."
msgstr "نمونه‌ی نویسنده پس از این فراخوانی نامعتبر است."

msgid "Discard the internal Unicode buffer and destroy the writer instance."
msgstr "بافر داخلی یونیکد را دور می‌ریزد و نمونه‌ی نویسنده را نابود می‌کند."

msgid "If *writer* is ``NULL``, no operation is performed."
msgstr "اگر *writer* برابر ``NULL`` باشد، هیچ عملیاتی انجام نمی‌شود."

msgid "Write the single Unicode character *ch* into *writer*."
msgstr "نویسه‌ی تکی یونیکد *ch* را در *writer* بنویسید."

msgid "On success, return ``0``. On error, set an exception, leave the writer unchanged, and return ``-1``."
msgstr "در صورت موفقیت، ``0`` را برمی‌گرداند. در صورت خطا، یک استثنا تنظیم می‌کند، نوشتارگر را بدون تغییر باقی می‌گذارد و ``-1`` را برمی‌گرداند."

msgid "Decode the string *str* from UTF-8 in strict mode and write the output into *writer*."
msgstr "رشته *str* را از UTF-8 در حالت سخت‌گیرانه کدگشایی می‌کند و خروجی را در *writer* می‌نویسد."

msgid "*size* is the string length in bytes. If *size* is equal to ``-1``, call ``strlen(str)`` to get the string length."
msgstr "*size* طول رشته بر حسب بایت است. اگر *size* برابر با ``-1`` باشد، برای به دست آوردن طول رشته، ``strlen(str)`` فراخوانی می‌شود."

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

msgid "Write the ASCII string *str* into *writer*."
msgstr "رشته اسکی *str* را در *writer* بنویسید."

msgid "*str* must only contain ASCII characters. The behavior is undefined if *str* contains non-ASCII characters."
msgstr "*str* باید فقط شامل نویسه‌های اسکی باشد. اگر *str* شامل نویسه‌های غیر‌اسکی باشد، رفتار تعریف‌نشده است."

msgid "Write the wide string *str* into *writer*."
msgstr "رشته پهن *str* را در *writer* می‌نویسد."

msgid "*size* is a number of wide characters. If *size* is equal to ``-1``, call ``wcslen(str)`` to get the string length."
msgstr "*size* تعداد نویسه‌های پهن است. اگر *size* برابر با ``-1`` باشد، برای به‌دست آوردن طول رشته، ``wcslen(str)`` را فراخوانی کنید."

msgid "Writer the UCS4 string *str* into *writer*."
msgstr "رشته UCS4 *str* را در *writer* می‌نویسد."

msgid "*size* is a number of UCS4 characters."
msgstr "*size* تعداد نویسه‌های UCS4 است."

msgid "Call :c:func:`PyObject_Str` on *obj* and write the output into *writer*."
msgstr ":c:func:`PyObject_Str` را روی *obj* فراخوانی می‌کند و خروجی را در *writer* می‌نویسد."

msgid "To write a :class:`str` subclass which overrides the :meth:`~object.__str__` method, :c:func:`PyUnicode_FromObject` can be used to get the original string."
msgstr "برای نوشتن یک زیرکلاس از :class:`str` که متد :meth:`~object.__str__` را بازنویسی کند، می‌توان از :c:func:`PyUnicode_FromObject` برای به‌دست آوردن رشته اصلی استفاده کرد."

msgid "Call :c:func:`PyObject_Repr` on *obj* and write the output into *writer*."
msgstr ":c:func:`PyObject_Repr` را روی *obj* فراخوانی کنید و خروجی را در *writer* بنویسید."

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

msgid "Added support for ``NULL``."
msgstr "پشتیبانی از ``NULL`` افزوده شد."

msgid "Write the substring ``str[start:end]`` into *writer*."
msgstr "زیررشته‌ی ``str[start:end]`` را در *writer* بنویسید."

msgid "*str* must be Python :class:`str` object. *start* must be greater than or equal to 0, and less than or equal to *end*. *end* must be less than or equal to *str* length."
msgstr "*str* باید یک شیء :class:`str` پایتون باشد. *start* باید بزرگ‌تر یا مساوی ۰ و کوچک‌تر یا مساوی *end* باشد. *end* باید کوچک‌تر یا مساوی طول *str* باشد."

msgid "Similar to :c:func:`PyUnicode_FromFormat`, but write the output directly into *writer*."
msgstr "مشابه :c:func:`PyUnicode_FromFormat`، اما خروجی را مستقیماً در *writer* می‌نویسد."

msgid "Decode the string *str* from UTF-8 with *errors* error handler and write the output into *writer*."
msgstr "رشته‌ی *str* را از UTF-8 با هندلر خطای *errors* کدگشایی می‌کند و خروجی را در *writer* می‌نویسد."

msgid "*errors* is an :ref:`error handler <error-handlers>` name, such as ``\"replace\"``. If *errors* is ``NULL``, use the strict error handler."
msgstr "*errors* نام یک :ref:`هندلر خطا <error-handlers>` است، مانند ``\"replace\"``. اگر *errors* برابر ``NULL`` باشد، از هندلر خطای سخت‌گیرانه استفاده کنید."

msgid "If *consumed* is not ``NULL``, set *\\*consumed* to the number of decoded bytes on success. If *consumed* is ``NULL``, treat trailing incomplete UTF-8 byte sequences as an error."
msgstr "اگر *consumed* برابر ``NULL`` نباشد، در صورت موفقیت *\\*consumed* برابر با تعداد بایت‌های کدگشایی‌شده تنظیم می‌شود. اگر *consumed* برابر ``NULL`` باشد، دنباله‌های بایتی ناقص UTF-8 در انتها به‌عنوان خطا در نظر گرفته می‌شوند."

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

msgid "Deprecated API"
msgstr "API منسوخ"

msgid "The following API is deprecated."
msgstr "API زیر منسوخ شده است."

msgid "This is a typedef of :c:type:`wchar_t`, which is a 16-bit type or 32-bit type depending on the platform. Please use :c:type:`wchar_t` directly instead."
msgstr "این یک تعریف نوع (typedef) از :c:type:`wchar_t` است که بسته به پلتفرم، نوعی ۱۶ بیتی یا ۳۲ بیتی است. لطفاً به‌جای آن، مستقیماً از :c:type:`wchar_t` استفاده کنید."

msgid "In previous versions, this was a 16-bit type or a 32-bit type depending on whether you selected a \"narrow\" or \"wide\" Unicode version of Python at build time."
msgstr "در نسخه‌های قبلی، این یک نوع ۱۶بیتی یا ۳۲بیتی بود، بسته به اینکه شما در زمان ساخت، نسخه‌ی «باریک» یا «پهن» یونیکد پایتون را انتخاب کرده باشید."

msgid "Do nothing and return ``0``. This API is kept only for backward compatibility, but there are no plans to remove it."
msgstr "هیچ کاری انجام ندهید و ``0`` را برگردانید. این API تنها برای سازگاری با نسخه‌های پیشین نگه داشته شده است، اما برنامه‌ای برای حذف آن وجود ندارد."

msgid "This API does nothing since Python 3.12. Previously, this needed to be called for each string created using the old API (:c:func:`!PyUnicode_FromUnicode` or similar)."
msgstr "این API از پایتون 3.12 به بعد هیچ کاری انجام نمی‌دهد. پیش‌تر، لازم بود برای هر رشته‌ای که با استفاده از API قدیمی (:c:func:`!PyUnicode_FromUnicode` یا مشابه آن) ایجاد شده بود، فراخوانی شود."

msgid "Do nothing and return ``1``. This API is kept only for backward compatibility, but there are no plans to remove it."
msgstr "هیچ کاری انجام نمی‌دهد و ``1`` را برمی‌گرداند. این API تنها برای سازگاری با نسخه‌های قبلی نگه داشته شده است، اما برنامه‌ای برای حذف آن وجود ندارد."

msgid "This API does nothing since Python 3.12. Previously, this could be called to check if :c:func:`PyUnicode_READY` is necessary."
msgstr "این API از پایتون 3.12 به بعد هیچ کاری انجام نمی‌دهد. پیش‌تر، می‌شد آن را برای بررسی ضرورت :c:func:`PyUnicode_READY` فراخوانی کرد."