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

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

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

"PO-Revision-Date: 2026-09-13 07:00+0330\n"

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

"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"

"Language: fa\n"

"MIME-Version: 1.0\n"

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

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

"Plural-Forms: nplurals=2; plural=(n > 1);\n"

"X-Generator: Poedit 3.6\n"

msgid ":mod:`!codecs` --- Codec registry and base classes"

msgstr ":mod:`!codecs` --- رجیستری کدک و کلاس‌های پایه"

msgid "**Source code:** :source:`Lib/codecs.py`"

msgstr "**کد منبع:** :source:`Lib/codecs.py`"

msgid "This module defines base classes for standard Python codecs (encoders and decoders) and provides access to the internal Python codec registry, which manages the codec and error handling lookup process. Most standard codecs are :term:`text encodings <text encoding>`, which encode text to bytes (and decode bytes to text), but there are also codecs provided that encode text to text, and bytes to bytes. Custom codecs may encode and decode between arbitrary types, but some module features are restricted to be used specifically with :term:`text encodings <text encoding>` or with codecs that encode to :class:`bytes`."

msgstr "این ماژول کلاس‌های پایه‌ای برای کدک‌های استاندارد پایتون (کدگذارها و کدگشاها) تعریف می‌کند و دسترسی به رجیستری داخلی کدک پایتون را فراهم می‌کند، که فرایند جست‌وجوی کدک و مدیریت خطا را مدیریت می‌کند. بیشتر کدک‌های استاندارد :term:`کدگذاری‌های متنی <text encoding>` هستند، که متن را به بایت کدگذاری می‌کنند (و بایت را به متن کدگشایی می‌کنند)، اما کدک‌هایی نیز فراهم شده‌اند که متن را به متن و بایت را به بایت کدگذاری می‌کنند. کدک‌های سفارشی می‌توانند میان انواع دلخواه کدگذاری و کدگشایی کنند، اما برخی امکانات ماژول محدود شده‌اند که فقط با :term:`کدگذاری‌های متنی <text encoding>` یا با کدک‌هایی که به :class:`bytes` کدگذاری می‌کنند، استفاده شوند."

msgid "The module defines the following functions for encoding and decoding with any codec:"

msgstr "این ماژول توابع زیر را برای کدگذاری و کدگشایی با هر کدک تعریف می‌کند:"

msgid "Encodes *obj* using the codec registered for *encoding*."

msgstr "*obj* را با استفاده از کدک ثبت‌شده برای *encoding* کدگذاری می‌کند."

msgid "*Errors* may be given to set the desired error handling scheme. The default error handler is ``'strict'`` meaning that encoding errors raise :exc:`ValueError` (or a more codec specific subclass, such as :exc:`UnicodeEncodeError`). Refer to :ref:`codec-base-classes` for more information on codec error handling."

msgstr "می‌توان *Errors* را برای تنظیم طرح‌واره مدیریت خطای مورد نظر مشخص کرد. هندلر پیش‌فرض خطا ``'strict'`` است، به این معنا که خطاهای کدگذاری باعث پرتاب :exc:`ValueError` (یا زیرکلاسی اختصاصی‌تر برای کدک، مانند :exc:`UnicodeEncodeError`) می‌شوند. برای اطلاعات بیشتر درباره مدیریت خطای کدک، به :ref:`codec-base-classes` مراجعه کنید."

msgid "Decodes *obj* using the codec registered for *encoding*."

msgstr "*obj* را با استفاده از کدک ثبت‌شده برای *encoding* کدگشایی می‌کند."

msgid "*Errors* may be given to set the desired error handling scheme. The default error handler is ``'strict'`` meaning that decoding errors raise :exc:`ValueError` (or a more codec specific subclass, such as :exc:`UnicodeDecodeError`). Refer to :ref:`codec-base-classes` for more information on codec error handling."

msgstr "می‌توان *Errors* را برای تنظیم طرح‌واره مدیریت خطای دلخواه ارائه کرد. هندلر خطای پیش‌فرض ``'strict'`` است، به این معنا که خطاهای کدگشایی باعث پرتاب :exc:`ValueError` (یا یک زیرکلاس خاص‌ترِ مربوط به کدک، مانند :exc:`UnicodeDecodeError`) می‌شوند. برای اطلاعات بیشتر در مورد مدیریت خطای کدک، به :ref:`codec-base-classes` مراجعه کنید."

msgid "Return a mapping suitable for encoding with a custom single-byte encoding. Given a :class:`str` *string* of up to 256 characters representing a decoding table, returns either a compact internal mapping object ``EncodingMap`` or a :class:`dictionary <dict>` mapping character ordinals to byte values. Raises a :exc:`TypeError` on invalid input."

msgstr "یک نگاشت مناسب برای کدگذاری با یک کدگذاری تک‌بایتی سفارشی بازمی‌گرداند. به ازای دریافت یک :class:`str` *string* با حداکثر ۲۵۶ نویسه که نشان‌دهنده یک جدول کدگشایی است، یا یک شیء نگاشت داخلی فشرده ``EncodingMap`` یا یک :class:`دیکشنری <dict>` برای نگاشت شماره ترتیب هر نویسه به مقادیر بایت بازمی‌گرداند. در صورت ورودی نامعتبر، استثنای :exc:`TypeError` را پرتاب می‌کند."

msgid "The full details for each codec can also be looked up directly:"

msgstr "همچنین می‌توانید جزئیات کامل هر کدک را مستقیماً جستجو کنید:"

msgid "Looks up the codec info in the Python codec registry and returns a :class:`CodecInfo` object as defined below."

msgstr "اطلاعات کدک را در رجیستری کدک‌های پایتون جستجو می‌کند و یک شیء :class:`CodecInfo` را که در زیر تعریف شده است برمی‌گرداند."

msgid "Encodings are first looked up in the registry's cache. If not found, the list of registered search functions is scanned. If no :class:`CodecInfo` object is found, a :exc:`LookupError` is raised. Otherwise, the :class:`CodecInfo` object is stored in the cache and returned to the caller."

msgstr "کدگذاری‌ها ابتدا در نهانگاه رجیستری جستجو می‌شوند. اگر یافت نشوند، فهرست توابع جستجوی ثبت‌شده پویش می‌شود. اگر شیء :class:`CodecInfo` یافت نشود، :exc:`LookupError` پرتاب می‌شود. در غیر این صورت، شیء :class:`CodecInfo` در نهانگاه ذخیره می‌شود و به فراخواننده برگردانده می‌شود."

msgid "Codec details when looking up the codec registry. The constructor arguments are stored in attributes of the same name:"

msgstr "جزئیات کدک هنگام جستجو در رجیستری کدک (codec registry). آرگومان‌های سازنده در ویژگی‌های هم‌نام ذخیره می‌شوند:"

msgid "The name of the encoding."

msgstr "نام کدگذاری."

msgid "The stateless encoding and decoding functions. These must be functions or methods which have the same interface as the :meth:`~Codec.encode` and :meth:`~Codec.decode` methods of Codec instances (see :ref:`Codec Interface <codec-objects>`). The functions or methods are expected to work in a stateless mode."

msgstr "توابع کدگذاری و کدگشایی بی‌وضعیت. این‌ها باید توابع یا متدهایی باشند که رابطی یکسان با متدهای :meth:`~Codec.encode` و :meth:`~Codec.decode` نمونه‌های Codec دارند (به :ref:`رابط Codec <codec-objects>` مراجعه کنید). انتظار می‌رود این توابع یا متدها در حالت بی‌وضعیت کار کنند."

msgid "Incremental encoder and decoder classes or factory functions. These have to provide the interface defined by the base classes :class:`IncrementalEncoder` and :class:`IncrementalDecoder`, respectively. Incremental codecs can maintain state."

msgstr "کلاس‌های کدگذار و کدگشای تدریجی یا توابع کارخانه. این موارد باید به‌ترتیب رابط تعریف‌شده توسط کلاس‌های پایه :class:`IncrementalEncoder` و :class:`IncrementalDecoder` را ارائه دهند. کدک‌های تدریجی می‌توانند وضعیت را حفظ کنند."

msgid "Stream writer and reader classes or factory functions. These have to provide the interface defined by the base classes :class:`StreamWriter` and :class:`StreamReader`, respectively. Stream codecs can maintain state."

msgstr "کلاس‌ها یا توابع کارخانه‌ای نویسنده و خواننده جریان. این‌ها باید به‌ترتیب رابط تعریف‌شده توسط کلاس‌های پایه :class:`StreamWriter` و :class:`StreamReader` را فراهم کنند. کدک‌های جریان می‌توانند وضعیت را حفظ کنند."

msgid "To simplify access to the various codec components, the module provides these additional functions which use :func:`lookup` for the codec lookup:"

msgstr "برای ساده‌سازی دسترسی به کامپوننت‌های مختلف کدک، این ماژول این توابع اضافی را فراهم می‌کند که از :func:`lookup` برای جست‌وجوی کدک استفاده می‌کنند:"

msgid "Look up the codec for the given encoding and return its encoder function."

msgstr "کدک مربوط به کدگذاری داده‌شده را جست‌وجو کنید و تابع کدگذار (encoder) آن را برگردانید."

msgid "Raises a :exc:`LookupError` in case the encoding cannot be found."

msgstr "در صورتی که کدگذاری یافت نشود، یک :exc:`LookupError` پرتاب می‌کند."

msgid "Look up the codec for the given encoding and return its decoder function."

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

msgid "Look up the codec for the given encoding and return its incremental encoder class or factory function."

msgstr "کدک مربوط به کدگذاری داده‌شده را جستجو می‌کند و کلاس یا تابع کارخانه‌ی کدگذار افزایشی (incremental encoder) آن را بازمی‌گرداند."

msgid "Raises a :exc:`LookupError` in case the encoding cannot be found or the codec doesn't support an incremental encoder."

msgstr "در صورتی که کدگذاری یافت نشود یا کدک از کدگذار افزایشی پشتیبانی نکند، استثنای :exc:`LookupError` را پرتاب می‌کند."

msgid "Look up the codec for the given encoding and return its incremental decoder class or factory function."

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

msgid "Raises a :exc:`LookupError` in case the encoding cannot be found or the codec doesn't support an incremental decoder."

msgstr "در صورتی که کدگذاری یافت نشود یا کدک از کدگشای افزایشی پشتیبانی نکند، یک :exc:`LookupError` پرتاب می‌شود."

msgid "Look up the codec for the given encoding and return its :class:`StreamReader` class or factory function."

msgstr "کدک مربوط به کدگذاری داده‌شده را جست‌وجو کنید و کلاس :class:`StreamReader` یا تابع کارخانه‌ای آن را برگردانید."

msgid "Look up the codec for the given encoding and return its :class:`StreamWriter` class or factory function."

msgstr "کدک مربوط به کدگذاری داده‌شده را جستجو کنید و کلاس :class:`StreamWriter` یا تابع کارخانه (factory function) آن را برگردانید."

msgid "Custom codecs are made available by registering a suitable codec search function:"

msgstr "کدک‌های سفارشی با ثبت یک تابع جستجوی کدک مناسب در دسترس قرار می‌گیرند:"

msgid "Register a codec search function. Search functions are expected to take one argument, being the encoding name in all lower case letters with hyphens and spaces converted to underscores, and return a :class:`CodecInfo` object. In case a search function cannot find a given encoding, it should return ``None``."

msgstr "یک تابع جست‌وجوی کدک ثبت کنید. انتظار می‌رود توابع جست‌وجو یک آرگومان دریافت کنند و یک شیء :class:`CodecInfo` برگردانند؛ این آرگومان نام کدگذاری است که تماماً با حروف کوچک بوده و سطرهای تیره و فاصله‌های آن به زیرخط تبدیل شده‌اند. در صورتی که یک تابع جست‌وجو نتواند کدگذاری داده‌شده را پیدا کند، باید ``None`` برگرداند."

msgid "Hyphens and spaces are converted to underscore."

msgstr "خط‌تیره‌ها و فاصله‌ها به زیرخط تبدیل می‌شوند."

msgid "Unregister a codec search function and clear the registry's cache. If the search function is not registered, do nothing."

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

msgid "While the builtin :func:`open` and the associated :mod:`io` module are the recommended approach for working with encoded text files, this module provides additional utility functions and classes that allow the use of a wider range of codecs when working with binary files:"

msgstr "اگرچه تابع توکار :func:`open` و ماژول مرتبط :mod:`io` رویکرد توصیه‌شده برای کار با پرونده‌های متنی کدگذاری‌شده هستند، این ماژول توابع و کلاس‌های کاربردی اضافی را فراهم می‌کند که امکان استفاده از طیف وسیع‌تری از کدک‌ها را هنگام کار با پرونده‌های دودویی می‌دهند:"

msgid "Open an encoded file using the given *mode* and return an instance of :class:`StreamReaderWriter`, providing transparent encoding/decoding. The default file mode is ``'r'``, meaning to open the file in read mode."

msgstr "یک پرونده کدگذاری‌شده را با استفاده از *mode* داده‌شده باز می‌کند، نمونه‌ای از :class:`StreamReaderWriter` برمی‌گرداند و کدگذاری/کدگشایی شفاف را فراهم می‌کند. حالت پیش‌فرض پرونده ``'r'`` است، به این معنا که پرونده در حالت خواندن باز می‌شود."

msgid "If *encoding* is not ``None``, then the underlying encoded files are always opened in binary mode. No automatic conversion of ``'\\n'`` is done on reading and writing. The *mode* argument may be any binary mode acceptable to the built-in :func:`open` function; the ``'b'`` is automatically added."

msgstr "اگر *encoding* برابر ``None`` نباشد، پرونده‌های کدگذاری‌شده‌ی زیربنایی همیشه در حالت دودویی باز می‌شوند. هیچ تبدیل خودکاری برای ``'\\n'`` هنگام خواندن و نوشتن انجام نمی‌شود. آرگومان *mode* می‌تواند هر حالت دودویی قابل‌قبول برای تابع توکار :func:`open` باشد؛ ``'b'`` به‌طور خودکار افزوده می‌شود."

msgid "*encoding* specifies the encoding which is to be used for the file. Any encoding that encodes to and decodes from bytes is allowed, and the data types supported by the file methods depend on the codec used."

msgstr "*encoding* کدگذاری مورد استفاده برای پرونده را مشخص می‌کند. هر کدگذاری که به بایت کدگذاری کند و از بایت کدگشایی کند مجاز است، و نوع‌های داده‌ای که متدهای پرونده از آن‌ها پشتیبانی می‌کنند به کدک استفاده‌شده بستگی دارند."

msgid "*errors* may be given to define the error handling. It defaults to ``'strict'`` which causes a :exc:`ValueError` to be raised in case an encoding error occurs."

msgstr "می‌توان *errors* را برای تعریف مدیریت خطا مشخص کرد. مقدار پیش‌فرض آن ``'strict'`` است که باعث می‌شود در صورت وقوع خطای کدگذاری، یک :exc:`ValueError` پرتاب شود."

msgid "*buffering* has the same meaning as for the built-in :func:`open` function. It defaults to -1 which means that the default buffer size will be used."

msgstr "*buffering* همان معنایی را دارد که در تابع توکار :func:`open` دارد. مقدار پیش‌فرض آن -1 است، به این معنا که از اندازه پیش‌فرض بافر استفاده می‌شود."

msgid "The ``'U'`` mode has been removed."

msgstr "حالت ``'U'`` حذف شده است."

msgid ":func:`codecs.open` has been superseded by :func:`open`."

msgstr ":func:`codecs.open` با :func:`open` جایگزین شده است."

msgid "Return a :class:`StreamRecoder` instance, a wrapped version of *file* which provides transparent transcoding. The original file is closed when the wrapped version is closed."

msgstr "یک نمونه از :class:`StreamRecoder` برمی‌گرداند، نسخه‌ای پوششی از *file* که بازکدگذاری شفاف (transcoding) را فراهم می‌کند. پرونده اصلی هنگامی که نسخه پوششی بسته شود، بسته می‌شود."

msgid "Data written to the wrapped file is decoded according to the given *data_encoding* and then written to the original file as bytes using *file_encoding*. Bytes read from the original file are decoded according to *file_encoding*, and the result is encoded using *data_encoding*."

msgstr "داده‌های نوشته‌شده در پرونده دربرگرفته‌شده، بر اساس *data_encoding* داده‌شده کدگشایی می‌شوند و سپس به‌صورت بایت با استفاده از *file_encoding* در پرونده اصلی نوشته می‌شوند. بایت‌های خوانده‌شده از پرونده اصلی، بر اساس *file_encoding* کدگشایی می‌شوند و نتیجه با استفاده از *data_encoding* کدگذاری می‌شود."

msgid "If *file_encoding* is not given, it defaults to *data_encoding*."

msgstr "اگر *file_encoding* داده نشود، مقدار پیش‌فرض آن *data_encoding* خواهد بود."

msgid "*errors* may be given to define the error handling. It defaults to ``'strict'``, which causes :exc:`ValueError` to be raised in case an encoding error occurs."

msgstr "می‌توان *errors* را برای تعریف مدیریت خطا مشخص کرد. مقدار پیش‌فرض آن ``'strict'`` است، که باعث می‌شود در صورت بروز خطای کدگذاری، :exc:`ValueError` پرتاب شود."

msgid "Uses an incremental encoder to iteratively encode the input provided by *iterator*. *iterator* must yield :class:`str` objects. This function is a :term:`generator`. The *errors* argument (as well as any other keyword argument) is passed through to the incremental encoder."

msgstr "از یک کدگذار افزایشی استفاده می‌کند تا ورودی ارائه‌شده توسط *iterator* را به‌صورت تکراری کدگذاری کند. *iterator* باید اشیای :class:`str` را yield کند. این تابع یک :term:`تولیدگر <generator>` است. آرگومان *errors* (و همچنین هر آرگومان کلیدواژه‌ای دیگر) به کدگذار افزایشی منتقل می‌شود."

msgid "This function requires that the codec accept text :class:`str` objects to encode. Therefore it does not support bytes-to-bytes encoders such as ``base64_codec``."

msgstr "این تابع نیاز دارد که کدک، اشیاء متنی :class:`str` را برای کدگذاری بپذیرد. بنابراین از کدگذارهای بایت‌به‌بایت مانند ``base64_codec`` پشتیبانی نمی‌کند."

msgid "Uses an incremental decoder to iteratively decode the input provided by *iterator*. *iterator* must yield :class:`bytes` objects. This function is a :term:`generator`. The *errors* argument (as well as any other keyword argument) is passed through to the incremental decoder."

msgstr "از یک کدگشای افزایشی استفاده می‌کند تا ورودی ارائه‌شده توسط *iterator* را به‌صورت تکراری کدگشایی کند. *iterator* باید اشیای :class:`bytes` را تولید کند. این تابع یک :term:`تولیدگر <generator>` است. آرگومان *errors* (و همچنین هر آرگومان کلیدواژه‌ای دیگر) به کدگشای افزایشی منتقل می‌شود."

msgid "This function requires that the codec accept :class:`bytes` objects to decode. Therefore it does not support text-to-text encoders such as ``rot_13``, although ``rot_13`` may be used equivalently with :func:`iterencode`."

msgstr "این تابع نیاز دارد که کدک اشیای :class:`bytes` را برای کدگشایی بپذیرد. بنابراین از کدگذارهای متن‌به‌متن مانند ``rot_13`` پشتیبانی نمی‌کند، هرچند می‌توان از ``rot_13`` به‌طور معادل همراه با :func:`iterencode` استفاده کرد."

msgid "Return a :class:`tuple` containing the raw bytes of *buffer*, a :ref:`buffer-compatible object <bufferobjects>` or :class:`str` (encoded to UTF-8 before processing), and their length in bytes."

msgstr "یک :class:`tuple` شامل بایت‌های خام *buffer*، یک :ref:`شیء سازگار با بافر <bufferobjects>` یا :class:`str` (که پیش از پردازش به UTF-8 کدگذاری‌شده است)، و طول آن‌ها بر حسب بایت را برمی‌گرداند."

msgid "The *errors* argument is ignored."

msgstr "آرگومان *errors* نادیده گرفته می‌شود."

msgid ""

msgstr ""

msgid "The module also provides the following constants which are useful for reading and writing to platform dependent files:"

msgstr "این ماژول همچنین ثابت‌های زیر را فراهم می‌کند که برای خواندن و نوشتن در پرونده‌های وابسته به پلتفرم مفید هستند:"

msgid "These constants define various byte sequences, being Unicode byte order marks (BOMs) for several encodings. They are used in UTF-16 and UTF-32 data streams to indicate the byte order used, and in UTF-8 as a Unicode signature. :const:`BOM_UTF16` is either :const:`BOM_UTF16_BE` or :const:`BOM_UTF16_LE` depending on the platform's native byte order, :const:`BOM` is an alias for :const:`BOM_UTF16`, :const:`BOM_LE` for :const:`BOM_UTF16_LE` and :const:`BOM_BE` for :const:`BOM_UTF16_BE`. The others represent the BOM in UTF-8 and UTF-32 encodings."

msgstr "این ثابت‌ها دنباله‌های بایت مختلفی را تعریف می‌کنند که نشانگرهای ترتیب بایت یونیکد (BOM) برای چندین کدگذاری هستند. آن‌ها در جریان‌های داده UTF-16 و UTF-32 برای نشان دادن ترتیب بایت استفاده‌شده و در UTF-8 به‌عنوان امضای یونیکد به کار می‌روند. :const:`BOM_UTF16` بسته به ترتیب بایت بومی سکو، :const:`BOM_UTF16_BE` یا :const:`BOM_UTF16_LE` است، :const:`BOM` نام مستعاری برای :const:`BOM_UTF16`، :const:`BOM_LE` برای :const:`BOM_UTF16_LE` و :const:`BOM_BE` برای :const:`BOM_UTF16_BE` است. سایر ثابت‌ها نشان‌دهنده‌ی BOM در کدگذاری‌های UTF-8 و UTF-32 هستند."

msgid "Codec Base Classes"

msgstr "کلاس‌های پایه کدک"

msgid "The :mod:`!codecs` module defines a set of base classes which define the interfaces for working with codec objects, and can also be used as the basis for custom codec implementations."

msgstr "ماژول :mod:`!codecs` مجموعه‌ای از کلاس‌های پایه را تعریف می‌کند که رابط‌هایی برای کار با اشیای کدک تعریف می‌کنند و همچنین می‌توانند به‌عنوان مبنایی برای پیاده‌سازی‌های سفارشی کدک استفاده شوند."

msgid "Each codec has to define four interfaces to make it usable as codec in Python: stateless encoder, stateless decoder, stream reader and stream writer. The stream reader and writers typically reuse the stateless encoder/decoder to implement the file protocols. Codec authors also need to define how the codec will handle encoding and decoding errors."

msgstr "هر کدک باید چهار رابط را تعریف کند تا به‌عنوان یک کدک در پایتون قابل استفاده باشد: کدگذار بدون وضعیت، کدگشای بدون وضعیت، خواننده جریان و نویسنده جریان. خواننده و نویسندگان جریان معمولاً برای پیاده‌سازی پروتکل‌های پرونده، مجدداً از کدگذار/کدگشای بدون وضعیت استفاده می‌کنند. نویسندگان کدک همچنین باید تعریف کنند که کدک چگونه خطاهای کدگذاری و کدگشایی را مدیریت خواهد کرد."

msgid "Error Handlers"

msgstr "هندلرهای خطا"

msgid "To simplify and standardize error handling, codecs may implement different error handling schemes by accepting the *errors* string argument:"

msgstr "برای ساده‌سازی و استانداردسازی مدیریت خطا، ممکن است کدک‌ها روش‌های مختلف مدیریت خطا را با پذیرفتن آرگومان رشته‌ای *errors* پیاده‌سازی کنند:"

msgid "The following error handlers can be used with all Python :ref:`standard-encodings` codecs:"

msgstr "می‌توان از هندلرهای خطای زیر با تمام کدک‌های :ref:`standard-encodings` پایتون استفاده کرد:"

msgid "Value"

msgstr "مقدار"

msgid "Meaning"

msgstr "معنی"

msgid "``'strict'``"

msgstr "``'strict'``"

msgid "Raise :exc:`UnicodeError` (or a subclass), this is the default. Implemented in :func:`strict_errors`."

msgstr ":exc:`UnicodeError` (یا یک زیرکلاس) را پرتاب می‌کند؛ این پیش‌فرض است. در :func:`strict_errors` پیاده‌سازی شده است."

msgid "``'ignore'``"

msgstr "``'ignore'``"

msgid "Ignore the malformed data and continue without further notice. Implemented in :func:`ignore_errors`."

msgstr "داده‌های ناهنجار را نادیده می‌گیرد و بدون اعلان بیشتر ادامه می‌یابد. در :func:`ignore_errors` پیاده‌سازی شده است."

msgid "``'replace'``"

msgstr "``'replace'``"

msgid "Replace with a replacement marker. On encoding, use ``?`` (ASCII character). On decoding, use ``�`` (U+FFFD, the official REPLACEMENT CHARACTER). Implemented in :func:`replace_errors`."

msgstr "با یک نشانگر جایگزینی جایگزین می‌شود. هنگام کدگذاری، از ``?`` (نویسه‌ی ASCII) استفاده می‌شود. هنگام کدگشایی، از ``�`` (U+FFFD، نویسه جایگزین رسمی) استفاده می‌شود. در :func:`replace_errors` پیاده‌سازی شده است."

msgid "``'backslashreplace'``"

msgstr "``'backslashreplace'``"

msgid "Replace with backslashed escape sequences. On encoding, use hexadecimal form of Unicode code point with formats :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}` :samp:`\\\\U{xxxxxxxx}`. On decoding, use hexadecimal form of byte value with format :samp:`\\\\x{hh}`. Implemented in :func:`backslashreplace_errors`."

msgstr "با دنباله‌های خنثی‌سازی دارای بک‌اسلش جایگزین می‌کند. هنگام کدگذاری، از صورت مبنای شانزده نقطه‌کد یونیکد با قالب‌های :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}` :samp:`\\\\U{xxxxxxxx}` استفاده می‌کند. هنگام کدگشایی، از صورت مبنای شانزده مقدار بایت با قالب :samp:`\\\\x{hh}` استفاده می‌کند. در :func:`backslashreplace_errors` پیاده‌سازی شده است."

msgid "``'surrogateescape'``"

msgstr "``'surrogateescape'``"

msgid "On decoding, replace byte with individual surrogate code ranging from ``U+DC80`` to ``U+DCFF``. This code will then be turned back into the same byte when the ``'surrogateescape'`` error handler is used when encoding the data. (See :pep:`383` for more.)"

msgstr "در کدگشایی، بایت با یک کد جانشین منفرد در بازه‌ی ``U+DC80`` تا ``U+DCFF`` جایگزین می‌شود. سپس هرگاه برای کدگذاری داده از هندلر خطای ``'surrogateescape'`` استفاده شود، این کد دوباره به همان بایت تبدیل می‌شود. (برای اطلاعات بیشتر :pep:`383` را ببینید.)"

msgid "The following error handlers are only applicable to encoding (within :term:`text encodings <text encoding>`):"

msgstr "هندلرهای خطای زیر فقط برای کدگذاری کاربرد دارند (در :term:`کدگذاری‌های متن <text encoding>`):"

msgid "``'xmlcharrefreplace'``"

msgstr "``'xmlcharrefreplace'``"

msgid "Replace with XML/HTML numeric character reference, which is a decimal form of Unicode code point with format :samp:`&#{num};`. Implemented in :func:`xmlcharrefreplace_errors`."

msgstr "با ارجاع عددی نویسه XML/HTML جایگزین می‌شود، که نمایش مبنای ده نقطه کد یونیکد با قالب :samp:`&#{num};` است. در :func:`xmlcharrefreplace_errors` پیاده‌سازی شده است."

msgid "``'namereplace'``"

msgstr "``'namereplace'``"

msgid "Replace with ``\\N{...}`` escape sequences, what appears in the braces is the Name property from Unicode Character Database. Implemented in :func:`namereplace_errors`."

msgstr "با دنباله‌های خنثی‌سازی ``\\N{...}`` جایگزین می‌شود؛ آنچه داخل آکولادها قرار دارد، ویژگی Name از پایگاه داده‌ی نویسه‌های یونیکد است. در :func:`namereplace_errors` پیاده‌سازی شده است."

msgid "In addition, the following error handler is specific to the given codecs:"

msgstr "علاوه بر این، هندلر خطای زیر مختص کدک‌های داده‌شده است:"

msgid "Codecs"

msgstr "کدک‌ها"

msgid "``'surrogatepass'``"

msgstr "``'surrogatepass'``"

msgid "utf-8, utf-16, utf-32, utf-16-be, utf-16-le, utf-32-be, utf-32-le"

msgstr "utf-8, utf-16, utf-32, utf-16-be, utf-16-le, utf-32-be, utf-32-le"

msgid "Allow encoding and decoding surrogate code point (``U+D800`` - ``U+DFFF``) as normal code point. Otherwise these codecs treat the presence of surrogate code point in :class:`str` as an error."

msgstr "اجازه‌ی کدگذاری و کدگشایی نقطه‌کد جانشین (surrogate code point) (``U+D800`` - ``U+DFFF``) به‌عنوان نقطه‌کد عادی را می‌دهد. در غیر این صورت، این کدک‌ها وجود نقطه‌کد جانشین (surrogate code point) در :class:`str` را به‌عنوان خطا در نظر می‌گیرند."

msgid "The ``'surrogateescape'`` and ``'surrogatepass'`` error handlers."

msgstr "هندلرهای خطای ``'surrogateescape'`` و ``'surrogatepass'``."

msgid "The ``'surrogatepass'`` error handler now works with utf-16\\* and utf-32\\* codecs."

msgstr "هندلر خطای ``'surrogatepass'`` اکنون با کدک‌های utf-16\\* و utf-32\\* کار می‌کند."

msgid "The ``'namereplace'`` error handler."

msgstr "هندلر خطای ``'namereplace'``."

msgid "The ``'backslashreplace'`` error handler now works with decoding and translating."

msgstr "هندلر خطای ``'backslashreplace'`` اکنون با کدگشایی و ترجمه کار می‌کند."

msgid "The set of allowed values can be extended by registering a new named error handler:"

msgstr "مجموعه‌ی مقادیر مجاز را می‌توان با ثبت یک هندلر خطای نام‌گذاری‌شده جدید گسترش داد:"

msgid "Register the error handling function *error_handler* under the name *name*. The *error_handler* argument will be called during encoding and decoding in case of an error, when *name* is specified as the errors parameter."

msgstr "تابع مدیریت خطای *error_handler* را با نام *name* ثبت کنید. آرگومان *error_handler* در هنگام کدگذاری و کدگشایی در صورت بروز خطا، زمانی که *name* به‌عنوان پارامتر errors مشخص شده باشد، فراخوانی می‌شود."

msgid "For encoding, *error_handler* will be called with a :exc:`UnicodeEncodeError` instance, which contains information about the location of the error. The error handler must either raise this or a different exception, or return a tuple with a replacement for the unencodable part of the input and a position where encoding should continue. The replacement may be either :class:`str` or :class:`bytes`. If the replacement is bytes, the encoder will simply copy them into the output buffer. If the replacement is a string, the encoder will encode the replacement. Encoding continues on original input at the specified position. Negative position values will be treated as being relative to the end of the input string. If the resulting position is out of bound an :exc:`IndexError` will be raised."

msgstr "در کدگذاری، *error_handler* با نمونه‌ای از :exc:`UnicodeEncodeError` فراخوانی می‌شود که شامل اطلاعاتی درباره‌ی محل خطا است. هندلر خطا باید یا این استثنا یا استثنای دیگری را پرتاب کند، یا تاپلی برگرداند که شامل جایگزینی برای بخش غیرقابل کدگذاری ورودی و موقعیتی است که کدگذاری باید از آن ادامه یابد. جایگزین می‌تواند :class:`str` یا :class:`bytes` باشد. اگر جایگزین bytes باشد، کدگذار به‌سادگی آن‌ها را در بافر خروجی کپی می‌کند. اگر جایگزین یک رشته باشد، کدگذار جایگزین را کدگذاری می‌کند. کدگذاری روی ورودی اصلی در موقعیت مشخص‌شده ادامه می‌یابد. مقادیر منفی موقعیت نسبت به پایان رشته ورودی در نظر گرفته می‌شوند. اگر موقعیت حاصل خارج از محدوده باشد، یک :exc:`IndexError` پرتاب خواهد شد."

msgid "Decoding and translating works similarly, except :exc:`UnicodeDecodeError` or :exc:`UnicodeTranslateError` will be passed to the handler and that the replacement from the error handler will be put into the output directly."

msgstr "کدگشایی و ترجمه به‌صورت مشابه عمل می‌کنند، با این تفاوت که :exc:`UnicodeDecodeError` یا :exc:`UnicodeTranslateError` به هندلر ارسال می‌شود و مقدار جایگزین حاصل از هندلر خطا مستقیماً در خروجی قرار می‌گیرد."

msgid "Previously registered error handlers (including the standard error handlers) can be looked up by name:"

msgstr "هندلرهای خطای پیش‌تر ثبت‌شده (از جمله هندلرهای خطای استاندارد) را می‌توان با نام جست‌وجو کرد:"

msgid "Return the error handler previously registered under the name *name*."

msgstr "هندلر خطایی را که پیش‌تر با نام *name* ثبت شده است، برمی‌گرداند."

msgid "Raises a :exc:`LookupError` in case the handler cannot be found."

msgstr "در صورتی که هندلر یافت نشود، استثنای :exc:`LookupError` پرتاب می‌شود."

msgid "The following standard error handlers are also made available as module level functions:"

msgstr "هندلرهای خطای استاندارد زیر نیز به‌عنوان توابع سطح ماژول در دسترس قرار گرفته‌اند:"

msgid "Implements the ``'strict'`` error handling."

msgstr "مدیریت خطای ``'strict'`` را پیاده‌سازی می‌کند."

msgid "Each encoding or decoding error raises a :exc:`UnicodeError`."

msgstr "هر خطای کدگذاری یا کدگشایی یک :exc:`UnicodeError` پرتاب می‌کند."

msgid "Implements the ``'ignore'`` error handling."

msgstr "مدیریت خطای ``'ignore'`` را پیاده‌سازی می‌کند."

msgid "Malformed data is ignored; encoding or decoding is continued without further notice."

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

msgid "Implements the ``'replace'`` error handling."

msgstr "مدیریت خطای ``'replace'`` را پیاده‌سازی می‌کند."

msgid "Substitutes ``?`` (ASCII character) for encoding errors or ``�`` (U+FFFD, the official REPLACEMENT CHARACTER) for decoding errors."

msgstr "در خطاهای کدگذاری، ``?`` (نویسه ASCII) یا در خطاهای کدگشایی، ``�`` (U+FFFD، نویسه جایگزین رسمی) را جایگزین می‌کند."

msgid "Implements the ``'backslashreplace'`` error handling."

msgstr "مدیریت خطای ``'backslashreplace'`` را پیاده‌سازی می‌کند."

msgid "Malformed data is replaced by a backslashed escape sequence. On encoding, use the hexadecimal form of Unicode code point with formats :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}` :samp:`\\\\U{xxxxxxxx}`. On decoding, use the hexadecimal form of byte value with format :samp:`\\\\x{hh}`."

msgstr "داده‌های نامعتبر با یک دنباله خنثی‌سازی با بک‌اسلش جایگزین می‌شوند. هنگام کدگذاری، از صورت مبنای شانزدهِ نقطه کد Unicode با قالب‌های :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}` :samp:`\\\\U{xxxxxxxx}` استفاده می‌شود. هنگام کدگشایی، از صورت مبنای شانزدهِ مقدار بایت با قالب :samp:`\\\\x{hh}` استفاده می‌شود."

msgid "Works with decoding and translating."

msgstr "با کدگشایی و ترجمه کار می‌کند."

msgid "Implements the ``'xmlcharrefreplace'`` error handling (for encoding within :term:`text encoding` only)."

msgstr "مدیریت خطای ``'xmlcharrefreplace'`` را پیاده‌سازی می‌کند (فقط برای کدگذاری در :term:`text encoding`)."

msgid "The unencodable character is replaced by an appropriate XML/HTML numeric character reference, which is a decimal form of Unicode code point with format :samp:`&#{num};` ."

msgstr "نویسه‌ی غیرقابل کدگذاری با یک ارجاع عددی نویسه مناسب XML/HTML جایگزین می‌شود، که نمایش مبنای ده نقطه کد یونیکد در قالب :samp:`&#{num};` است."

msgid "Implements the ``'namereplace'`` error handling (for encoding within :term:`text encoding` only)."

msgstr "مدیریت خطای ``'namereplace'`` را پیاده‌سازی می‌کند (فقط برای کدگذاری درون :term:`text encoding`)."

msgid "The unencodable character is replaced by a ``\\N{...}`` escape sequence. The set of characters that appear in the braces is the Name property from Unicode Character Database. For example, the German lowercase letter ``'ß'`` will be converted to byte sequence ``\\N{LATIN SMALL LETTER SHARP S}`` ."

msgstr "نویسه غیرقابل کدگذاری با یک دنباله‌ی خنثی‌سازی ``\\N{...}`` جایگزین می‌شود. مجموعه‌ی نویسه‌هایی که بین آکولادها قرار دارند، ویژگی Name از پایگاه داده‌ی نویسه‌های یونیکد (Unicode Character Database) است. برای مثال، حرف کوچک آلمانی ``'ß'`` به دنباله‌ی بایت ``\\N{LATIN SMALL LETTER SHARP S}`` تبدیل می‌شود."

msgid "Stateless Encoding and Decoding"

msgstr "کدگذاری و کدگشایی بی‌وضعیت"

msgid "The base :class:`Codec` class defines these methods which also define the function interfaces of the stateless encoder and decoder:"

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

msgid "Encodes the object *input* and returns a tuple (output object, length consumed). For instance, :term:`text encoding` converts a string object to a bytes object using a particular character set encoding (e.g., ``cp1252`` or ``iso-8859-1``)."

msgstr "شیء *input* را کدگذاری می‌کند و یک تاپل (شیء خروجی، طول مصرف‌شده) برمی‌گرداند. برای مثال، :term:`کدگذاری متن <text encoding>` یک شیء رشته را با استفاده از یک کدگذاری مجموعه نویسه خاص به یک شیء bytes تبدیل می‌کند (مثلاً ``cp1252`` یا ``iso-8859-1``)."

msgid "The *errors* argument defines the error handling to apply. It defaults to ``'strict'`` handling."

msgstr "آرگومان *errors* مدیریت خطای قابل اعمال را تعریف می‌کند. مقدار پیش‌فرض آن مدیریت ``'strict'`` است."

msgid "The method may not store state in the :class:`Codec` instance. Use :class:`StreamWriter` for codecs which have to keep state in order to make encoding efficient."

msgstr "این متد نباید وضعیت را در نمونه‌ی :class:`Codec` ذخیره کند. برای کدک‌هایی که باید وضعیت را به‌منظور کارآمد کردن کدگذاری حفظ کنند، از :class:`StreamWriter` استفاده کنید."

msgid "The encoder must be able to handle zero length input and return an empty object of the output object type in this situation."

msgstr "کدگذار باید بتواند ورودی با طول صفر را مدیریت کند و در این شرایط، یک شیء خالی از نوع شیء خروجی را برگرداند."

msgid "Decodes the object *input* and returns a tuple (output object, length consumed). For instance, for a :term:`text encoding`, decoding converts a bytes object encoded using a particular character set encoding to a string object."

msgstr "شیء *input* را کدگشایی می‌کند و یک تاپل (شیء خروجی، طول مصرف‌شده) را برمی‌گرداند. برای مثال، برای یک :term:`کدگذاری متن <text encoding>`، کدگشایی یک شیء bytes را که با استفاده از یک کدگذاری مجموعه نویسه خاص کدگذاری شده است، به یک شیء رشته تبدیل می‌کند."

msgid "For text encodings and bytes-to-bytes codecs, *input* must be a bytes object or one which provides the read-only buffer interface -- for example, buffer objects and memory mapped files."

msgstr "برای کدگذاری‌های متنی و کدک‌های بایت‌به‌بایت (bytes-to-bytes)، *input* باید یک شیء bytes یا شیء‌ای باشد که رابط بافر فقط‌خواندنی را فراهم می‌کند -- برای مثال، اشیای بافر و پرونده‌های نگاشت‌شده به حافظه."

msgid "The method may not store state in the :class:`Codec` instance. Use :class:`StreamReader` for codecs which have to keep state in order to make decoding efficient."

msgstr "این متد نباید وضعیت را در نمونه‌ی :class:`Codec` ذخیره کند. برای کدک‌هایی که باید برای کارآمد کردن کدگشایی وضعیت را نگه دارند، از :class:`StreamReader` استفاده کنید."

msgid "The decoder must be able to handle zero length input and return an empty object of the output object type in this situation."

msgstr "کدگشا باید بتواند ورودی با طول صفر را مدیریت کند و در این شرایط، یک شیء خالی از نوع شیء خروجی را برگرداند."

msgid "Incremental Encoding and Decoding"

msgstr "کدگذاری و کدگشایی تدریجی"

msgid "The :class:`IncrementalEncoder` and :class:`IncrementalDecoder` classes provide the basic interface for incremental encoding and decoding. Encoding/decoding the input isn't done with one call to the stateless encoder/decoder function, but with multiple calls to the :meth:`~IncrementalEncoder.encode`/:meth:`~IncrementalDecoder.decode` method of the incremental encoder/decoder. The incremental encoder/decoder keeps track of the encoding/decoding process during method calls."

msgstr "کلاس‌های :class:`IncrementalEncoder` و :class:`IncrementalDecoder` رابط پایه را برای کدگذاری و کدگشایی افزایشی فراهم می‌کنند. کدگذاری/کدگشایی ورودی با یک فراخوانی تابع کدگذار/کدگشای بدون وضعیت انجام نمی‌شود، بلکه با چندین فراخوانی متد :meth:`~IncrementalEncoder.encode`/:meth:`~IncrementalDecoder.decode` از کدگذار/کدگشای افزایشی انجام می‌شود. کدگذار/کدگشای افزایشی فرایند کدگذاری/کدگشایی را در طول فراخوانی‌های متد پیگیری می‌کند."

msgid "The joined output of calls to the :meth:`~IncrementalEncoder.encode`/:meth:`~IncrementalDecoder.decode` method is the same as if all the single inputs were joined into one, and this input was encoded/decoded with the stateless encoder/decoder."

msgstr "خروجی به‌هم‌پیوسته‌ی فراخوانی‌های متد :meth:`~IncrementalEncoder.encode`/:meth:`~IncrementalDecoder.decode` همان است که گویی همه‌ی ورودی‌های منفرد به یک ورودی پیوسته شده باشند و این ورودی با کدگذار/کدگشای بی‌وضعیت کدگذاری/کدگشایی شده باشد."

msgid "IncrementalEncoder Objects"

msgstr "اشیاء IncrementalEncoder"

msgid "The :class:`IncrementalEncoder` class is used for encoding an input in multiple steps. It defines the following methods which every incremental encoder must define in order to be compatible with the Python codec registry."

msgstr "کلاس :class:`IncrementalEncoder` برای کدگذاری یک ورودی در چندین مرحله استفاده می‌شود. این کلاس متدهای زیر را تعریف می‌کند که هر کدگذار افزایشی باید برای سازگاری با رجیستری کدک پایتون (Python codec registry) آن‌ها را تعریف کند."

msgid "Constructor for an :class:`IncrementalEncoder` instance."

msgstr "سازنده برای یک نمونه از :class:`IncrementalEncoder`."

msgid "All incremental encoders must provide this constructor interface. They are free to add additional keyword arguments, but only the ones defined here are used by the Python codec registry."

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

msgid "The :class:`IncrementalEncoder` may implement different error handling schemes by providing the *errors* keyword argument. See :ref:`error-handlers` for possible values."

msgstr ":class:`IncrementalEncoder` می‌تواند با ارائه‌ی آرگومان کلیدواژه‌ای *errors*، روش‌های مختلف مدیریت خطا را پیاده‌سازی کند. برای مقادیر ممکن، :ref:`error-handlers` را ببینید."

msgid "The *errors* argument will be assigned to an attribute of the same name. Assigning to this attribute makes it possible to switch between different error handling strategies during the lifetime of the :class:`IncrementalEncoder` object."

msgstr "آرگومان *errors* به یک ویژگی هم‌نام اختصاص داده می‌شود. اختصاص دادن به این ویژگی، امکان جابه‌جایی بین راهبردهای مختلف مدیریت خطا را در طول عمر شیء :class:`IncrementalEncoder` فراهم می‌کند."

msgid "Encodes *object* (taking the current state of the encoder into account) and returns the resulting encoded object. If this is the last call to :meth:`encode` *final* must be true (the default is false)."

msgstr "*object* را کدگذاری می‌کند (با در نظر گرفتن وضعیت فعلی کدگذار) و شیء کدگذاری‌شده‌ی حاصل را بازمی‌گرداند. اگر این آخرین فراخوانی :meth:`encode` باشد، *final* باید true باشد (پیش‌فرض false است)."

msgid "Reset the encoder to the initial state. The output is discarded: call ``.encode(object, final=True)``, passing an empty byte or text string if necessary, to reset the encoder and to get the output."

msgstr "کدگذار را به وضعیت اولیه بازنشانی کنید. خروجی دور ریخته می‌شود: ``.encode(object, final=True)`` را فراخوانی کنید و در صورت نیاز، یک رشته بایتی یا متنی خالی را ارسال کنید تا کدگذار بازنشانی شود و خروجی دریافت شود."

msgid "Return the current state of the encoder which must be an integer. The implementation should make sure that ``0`` is the most common state. (States that are more complicated than integers can be converted into an integer by marshaling/pickling the state and encoding the bytes of the resulting string into an integer.)"

msgstr "وضعیت فعلی کدگذار را برمی‌گرداند که باید یک عدد صحیح باشد. پیاده‌سازی باید اطمینان حاصل کند که ``0`` رایج‌ترین وضعیت است. (وضعیت‌هایی که از اعداد صحیح پیچیده‌تر هستند، می‌توانند با مارشال/پیکل کردن (marshaling/pickling) وضعیت و کدگذاری بایت‌های رشته حاصل به یک عدد صحیح تبدیل شوند.)"

msgid "Set the state of the encoder to *state*. *state* must be an encoder state returned by :meth:`getstate`."

msgstr "وضعیت کدگذار را روی *state* تنظیم کنید. *state* باید یک وضعیت کدگذار باشد که توسط :meth:`getstate` برگردانده شده است."

msgid "IncrementalDecoder Objects"

msgstr "اشیاء IncrementalDecoder"

msgid "The :class:`IncrementalDecoder` class is used for decoding an input in multiple steps. It defines the following methods which every incremental decoder must define in order to be compatible with the Python codec registry."

msgstr "کلاس :class:`IncrementalDecoder` برای کدگشایی یک ورودی در چند مرحله استفاده می‌شود. این کلاس متدهای زیر را تعریف می‌کند که هر کدگشای افزایشی باید برای سازگاری با رجیستری کدک پایتون (Python codec registry) آن‌ها را تعریف کند."

msgid "Constructor for an :class:`IncrementalDecoder` instance."

msgstr "سازنده‌ی یک نمونه از :class:`IncrementalDecoder`."

msgid "All incremental decoders must provide this constructor interface. They are free to add additional keyword arguments, but only the ones defined here are used by the Python codec registry."

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

msgid "The :class:`IncrementalDecoder` may implement different error handling schemes by providing the *errors* keyword argument. See :ref:`error-handlers` for possible values."

msgstr ":class:`IncrementalDecoder` می‌تواند با ارائه آرگومان کلیدواژه‌ای *errors*، روش‌های مختلف مدیریت خطا را پیاده‌سازی کند. برای مقادیر ممکن، :ref:`error-handlers` را ببینید."

msgid "The *errors* argument will be assigned to an attribute of the same name. Assigning to this attribute makes it possible to switch between different error handling strategies during the lifetime of the :class:`IncrementalDecoder` object."

msgstr "آرگومان *errors* به ویژگی‌ای با همین نام اختصاص داده می‌شود. اختصاص دادن به این ویژگی امکان جابه‌جایی بین راهبردهای مختلف مدیریت خطا را در طول عمر شیء :class:`IncrementalDecoder` فراهم می‌کند."

msgid "Decodes *object* (taking the current state of the decoder into account) and returns the resulting decoded object. If this is the last call to :meth:`decode` *final* must be true (the default is false). If *final* is true the decoder must decode the input completely and must flush all buffers. If this isn't possible (e.g. because of incomplete byte sequences at the end of the input) it must initiate error handling just like in the stateless case (which might raise an exception)."

msgstr "*object* را کدگشایی می‌کند (وضعیت فعلی کدگشا را در نظر می‌گیرد) و شیء کدگشایی‌شده‌ی حاصل را برمی‌گرداند. اگر این آخرین فراخوانی :meth:`decode` باشد، *final* باید true باشد (پیش‌فرض false است). اگر *final* برابر true باشد، کدگشا باید ورودی را به‌طور کامل کدگشایی کند و تمام بافرها را تخلیه کند. اگر این کار ممکن نباشد (مثلاً به دلیل دنباله‌های ناقص بایت در پایان ورودی)، باید مدیریت خطا را دقیقاً مانند حالت بی‌وضعیت (stateless) آغاز کند (که ممکن است استثنایی را پرتاب کند)."

msgid "Reset the decoder to the initial state."

msgstr "کدگشا را به وضعیت اولیه بازنشانی کنید."

msgid "Return the current state of the decoder. This must be a tuple with two items, the first must be the buffer containing the still undecoded input. The second must be an integer and can be additional state info. (The implementation should make sure that ``0`` is the most common additional state info.) If this additional state info is ``0`` it must be possible to set the decoder to the state which has no input buffered and ``0`` as the additional state info, so that feeding the previously buffered input to the decoder returns it to the previous state without producing any output. (Additional state info that is more complicated than integers can be converted into an integer by marshaling/pickling the info and encoding the bytes of the resulting string into an integer.)"

msgstr "وضعیت کنونی کدگشا را برمی‌گرداند. این باید یک تاپل با دو آیتم باشد؛ نخستین آیتم باید بافر حاوی ورودی هنوز کدگشایی‌نشده باشد. دومین آیتم باید یک عدد صحیح باشد و می‌تواند اطلاعات وضعیت اضافی باشد. (پیاده‌سازی باید اطمینان حاصل کند که ``0`` رایج‌ترین اطلاعات وضعیت اضافی است.) اگر این اطلاعات وضعیت اضافی ``0`` باشد، باید بتوان کدگشا را در وضعیتی قرار داد که هیچ ورودی‌ای در بافر نداشته باشد و اطلاعات وضعیت اضافی آن ``0`` باشد، تا دادن ورودی از پیش در بافر قرار گرفته به کدگشا آن را بدون تولید هیچ خروجی به وضعیت پیشین بازگرداند. (اطلاعات وضعیت اضافی که پیچیده‌تر از اعداد صحیح باشد را می‌توان با مارشال‌کردن (marshaling) یا پیکل‌کردن اطلاعات و کدگذاری بایت‌های رشته حاصل به یک عدد صحیح، به یک عدد صحیح تبدیل کرد.)"

msgid "Set the state of the decoder to *state*. *state* must be a decoder state returned by :meth:`getstate`."

msgstr "وضعیت کدگشا را روی *state* تنظیم کنید. *state* باید یک وضعیت کدگشا باشد که :meth:`getstate` آن را برمی‌گرداند."

msgid "Stream Encoding and Decoding"

msgstr "کدگذاری و کدگشایی جریان"

msgid "The :class:`StreamWriter` and :class:`StreamReader` classes provide generic working interfaces which can be used to implement new encoding submodules very easily. See :mod:`!encodings.utf_8` for an example of how this is done."

msgstr "کلاس‌های :class:`StreamWriter` و :class:`StreamReader` رابط‌های کاری عامی فراهم می‌کنند که می‌توان از آن‌ها برای پیاده‌سازی زیرماژول‌های جدید کدگذاری به‌صورت بسیار آسان استفاده کرد. برای مشاهده نمونه‌ای از چگونگی انجام این کار، :mod:`!encodings.utf_8` را ببینید."

msgid "StreamWriter Objects"

msgstr "اشیای StreamWriter"

msgid "The :class:`StreamWriter` class is a subclass of :class:`Codec` and defines the following methods which every stream writer must define in order to be compatible with the Python codec registry."

msgstr "کلاس :class:`StreamWriter` یک زیرکلاس از :class:`Codec` است و متدهای زیر را تعریف می‌کند که هر نویسنده‌ی جریان (stream writer) باید آن‌ها را تعریف کند تا با رجیستری کدک پایتون (Python codec registry) سازگار باشد."

msgid "Constructor for a :class:`StreamWriter` instance."

msgstr "سازنده برای یک نمونه از :class:`StreamWriter`."

msgid "All stream writers must provide this constructor interface. They are free to add additional keyword arguments, but only the ones defined here are used by the Python codec registry."

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

msgid "The *stream* argument must be a file-like object open for writing text or binary data, as appropriate for the specific codec."

msgstr "آرگومان *stream* باید یک شیء شبه‌پرونده باشد که برای نوشتن متن یا داده‌های دودویی، متناسب با کدک مشخص، باز شده باشد."

msgid "The :class:`StreamWriter` may implement different error handling schemes by providing the *errors* keyword argument. See :ref:`error-handlers` for the standard error handlers the underlying stream codec may support."

msgstr ":class:`StreamWriter` می‌تواند با ارائه آرگومان کلیدواژه‌ای *errors*، روش‌های مختلفی برای مدیریت خطا را پیاده‌سازی کند. برای هندلرهای خطای استانداردی که کدک جریان زیرین ممکن است از آن‌ها پشتیبانی کند، :ref:`error-handlers` را ببینید."

msgid "The *errors* argument will be assigned to an attribute of the same name. Assigning to this attribute makes it possible to switch between different error handling strategies during the lifetime of the :class:`StreamWriter` object."

msgstr "آرگومان *errors* به ویژگی‌ای به همین نام منتسب می‌شود. انتساب به این ویژگی امکان جابه‌جایی بین شیوه‌های مختلف مدیریت خطا را در طول عمر شیء :class:`StreamWriter` فراهم می‌کند."

msgid "Writes the object's contents encoded to the stream."

msgstr "محتوای شیء را به‌صورت کدگذاری‌شده در جریان می‌نویسد."

msgid "Writes the concatenated iterable of strings to the stream (possibly by reusing the :meth:`write` method). Infinite or very large iterables are not supported. The standard bytes-to-bytes codecs do not support this method."

msgstr "رشته‌های به‌هم‌پیوسته‌ی یک پیمایش‌پذیر را در جریان می‌نویسد (احتمالاً با استفاده‌ی مجدد از متد :meth:`write`). پیمایش‌پذیرهای بی‌نهایت یا بسیار بزرگ پشتیبانی نمی‌شوند. کدک‌های استاندارد بایت-به-بایت از این متد پشتیبانی نمی‌کنند."

msgid "Resets the codec buffers used for keeping internal state."

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

msgid "Calling this method should ensure that the data on the output is put into a clean state that allows appending of new fresh data without having to rescan the whole stream to recover state."

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

msgid "In addition to the above methods, the :class:`StreamWriter` must also inherit all other methods and attributes from the underlying stream."

msgstr "علاوه بر متدهای فوق، :class:`StreamWriter` همچنین باید تمام متدها و ویژگی‌های دیگر را از جریان زیرین به ارث ببرد."

msgid "StreamReader Objects"

msgstr "اشیاء StreamReader"

msgid "The :class:`StreamReader` class is a subclass of :class:`Codec` and defines the following methods which every stream reader must define in order to be compatible with the Python codec registry."

msgstr "کلاس :class:`StreamReader` زیرکلاسی از :class:`Codec` است و متدهای زیر را تعریف می‌کند که هر خواننده جریانی (stream reader) باید آن‌ها را تعریف کند تا با رجیستری کدک پایتون (Python codec registry) سازگار باشد."

msgid "Constructor for a :class:`StreamReader` instance."

msgstr "سازنده‌ای برای یک نمونه از :class:`StreamReader`."

msgid "All stream readers must provide this constructor interface. They are free to add additional keyword arguments, but only the ones defined here are used by the Python codec registry."

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

msgid "The *stream* argument must be a file-like object open for reading text or binary data, as appropriate for the specific codec."

msgstr "آرگومان *stream* باید یک شیء شبه‌پرونده باشد که برای خواندن متن یا داده‌ی دودویی، متناسب با کدک مشخص، باز باشد."

msgid "The :class:`StreamReader` may implement different error handling schemes by providing the *errors* keyword argument. See :ref:`error-handlers` for the standard error handlers the underlying stream codec may support."

msgstr ":class:`StreamReader` ممکن است با ارائه آرگومان کلیدواژه‌ای *errors*، روش‌های مختلف مدیریت خطا را پیاده‌سازی کند. برای آشنایی با هندلرهای خطای استانداردی که کدک جریان زیرین ممکن است پشتیبانی کند، :ref:`error-handlers` را ببینید."

msgid "The *errors* argument will be assigned to an attribute of the same name. Assigning to this attribute makes it possible to switch between different error handling strategies during the lifetime of the :class:`StreamReader` object."

msgstr "آرگومان *errors* به ویژگی‌ای با همین نام اختصاص داده می‌شود. انتساب به این ویژگی امکان جابه‌جایی بین راهبردهای مختلف مدیریت خطا را در طول عمر شیء :class:`StreamReader` فراهم می‌کند."

msgid "The set of allowed values for the *errors* argument can be extended with :func:`register_error`."

msgstr "مجموعه مقادیر مجاز برای آرگومان *errors* را می‌توان با :func:`register_error` گسترش داد."

msgid "Decodes data from the stream and returns the resulting object."

msgstr "داده را از جریان کدگشایی می‌کند و شیء حاصل را برمی‌گرداند."

msgid "The *chars* argument indicates the number of decoded code points or bytes to return. The :func:`read` method will never return more data than requested, but it might return less, if there is not enough available."

msgstr "آرگومان *chars* تعداد نقاط کد کدگشایی‌شده یا بایت‌هایی را که باید بازگردانده شوند، نشان می‌دهد. متد :func:`read` هرگز داده‌ای بیشتر از مقدار درخواست‌شده برنمی‌گرداند، اما ممکن است در صورتی که به اندازه کافی داده در دسترس نباشد، کمتر برگرداند."

msgid "The *size* argument indicates the approximate maximum number of encoded bytes or code points to read for decoding. The decoder can modify this setting as appropriate. The default value -1 indicates to read and decode as much as possible. This parameter is intended to prevent having to decode huge files in one step."

msgstr "آرگومان *size* نشان‌دهنده‌ی حداکثر تعداد تقریبی بایت‌های کدگذاری‌شده یا نقاط کدی است که برای کدگشایی خوانده می‌شوند. کدگشا می‌تواند این تنظیم را به‌صورت مناسب تغییر دهد. مقدار پیش‌فرض -1 نشان می‌دهد که تا حد امکان خوانده و کدگشایی شود. این پارامتر برای جلوگیری از نیاز به کدگشایی پرونده‌های بسیار بزرگ در یک مرحله در نظر گرفته شده است."

msgid "The *firstline* flag indicates that it would be sufficient to only return the first line, if there are decoding errors on later lines."

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

msgid "The method should use a greedy read strategy meaning that it should read as much data as is allowed within the definition of the encoding and the given size, e.g. if optional encoding endings or state markers are available on the stream, these should be read too."

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

msgid "Read one line from the input stream and return the decoded data."

msgstr "یک خط از جریان ورودی می‌خواند و داده کدگشایی‌شده را برمی‌گرداند."

msgid "*size*, if given, is passed as size argument to the stream's :meth:`read` method."

msgstr "*size*، در صورت ارائه، به‌عنوان آرگومان size به متد :meth:`read` جریان ارسال می‌شود."

msgid "If *keepends* is false line-endings will be stripped from the lines returned."

msgstr "اگر *keepends* نادرست باشد، پایان‌سطرها از سطرهای برگردانده‌شده حذف می‌شوند."

msgid "Read all lines available on the input stream and return them as a list of lines."

msgstr "تمام سطرهای موجود در جریان ورودی را می‌خواند و آن‌ها را به‌صورت فهرستی از سطرها برمی‌گرداند."

msgid "Line-endings are implemented using the codec's :meth:`decode` method and are included in the list entries if *keepends* is true."

msgstr "پایان سطرها با استفاده از متد :meth:`decode` کدک پیاده‌سازی می‌شوند و در صورتی که *keepends* درست باشد، در آیتم‌های فهرست گنجانده می‌شوند."

msgid "*sizehint*, if given, is passed as the *size* argument to the stream's :meth:`read` method."

msgstr "*sizehint*، در صورت داده شدن، به‌عنوان آرگومان *size* به متد :meth:`read` جریان ارسال می‌شود."

msgid "Note that no stream repositioning should take place. This method is primarily intended to be able to recover from decoding errors."

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

msgid "In addition to the above methods, the :class:`StreamReader` must also inherit all other methods and attributes from the underlying stream."

msgstr "علاوه بر متدهای فوق، :class:`StreamReader` باید تمام متدها و ویژگی‌های دیگر را نیز از جریان زیرین به ارث ببرد."

msgid "StreamReaderWriter Objects"

msgstr "اشیای StreamReaderWriter"

msgid "The :class:`StreamReaderWriter` is a convenience class that allows wrapping streams which work in both read and write modes."

msgstr ":class:`StreamReaderWriter` کلاسی سهولت‌بخش است که به شما امکان می‌دهد جریان‌هایی را که در هر دو حالت خواندن و نوشتن کار می‌کنند، پوشش دهید."

msgid "The design is such that one can use the factory functions returned by the :func:`lookup` function to construct the instance."

msgstr "طراحی به گونه‌ای است که می‌توان از توابع کارخانه‌ای که توسط تابع :func:`lookup` برگردانده می‌شوند، برای ساخت نمونه استفاده کرد."

msgid "Creates a :class:`StreamReaderWriter` instance. *stream* must be a file-like object. *Reader* and *Writer* must be factory functions or classes providing the :class:`StreamReader` and :class:`StreamWriter` interface resp. Error handling is done in the same way as defined for the stream readers and writers."

msgstr "یک نمونه از :class:`StreamReaderWriter` ایجاد می‌کند. *stream* باید یک شیء شبه‌پرونده باشد. *Reader* و *Writer* باید توابع کارخانه‌ای یا کلاس‌هایی باشند که به‌ترتیب رابط‌های :class:`StreamReader` و :class:`StreamWriter` را ارائه می‌دهند. مدیریت خطا به همان روشی انجام می‌شود که برای خواننده‌ها و نویسنده‌های جریان تعریف شده است."

msgid ":class:`StreamReaderWriter` instances define the combined interfaces of :class:`StreamReader` and :class:`StreamWriter` classes. They inherit all other methods and attributes from the underlying stream."

msgstr "نمونه‌های :class:`StreamReaderWriter` رابط‌های ترکیب‌شده‌ی کلاس‌های :class:`StreamReader` و :class:`StreamWriter` را تعریف می‌کنند. آن‌ها تمام متدها و ویژگی‌های دیگر را از جریان زیربنایی به ارث می‌برند."

msgid "StreamRecoder Objects"

msgstr "اشیاء StreamRecoder"

msgid "The :class:`StreamRecoder` translates data from one encoding to another, which is sometimes useful when dealing with different encoding environments."

msgstr ":class:`StreamRecoder` داده‌ها را از یک کدگذاری به کدگذاری دیگر تبدیل می‌کند، که گاهی هنگام کار با محیط‌های کدگذاری مختلف مفید است."

msgid "Creates a :class:`StreamRecoder` instance which implements a two-way conversion: *encode* and *decode* work on the frontend — the data visible to code calling :meth:`~StreamReader.read` and :meth:`~StreamWriter.write`, while *Reader* and *Writer* work on the backend — the data in *stream*."

msgstr "نمونه‌ای از :class:`StreamRecoder` می‌سازد که یک تبدیل دوطرفه را پیاده‌سازی می‌کند: *encode* و *decode* در بخش جلویی (frontend) کار می‌کنند — داده‌هایی که برای کدی که :meth:`~StreamReader.read` و :meth:`~StreamWriter.write` را فراخوانی می‌کند قابل مشاهده است، در حالی که *Reader* و *Writer* در بخش بک‌اند کار می‌کنند — داده‌های موجود در *stream*."

msgid "You can use these objects to do transparent transcodings, e.g., from Latin-1 to UTF-8 and back."

msgstr "می‌توانید از این شیء‌ها برای انجام بازکدگذاری‌های شفاف (transcoding) استفاده کنید، برای مثال از Latin-1 به UTF-8 و برعکس."

msgid "The *stream* argument must be a file-like object."

msgstr "آرگومان *stream* باید یک شیء شبه‌پرونده باشد."

msgid "The *encode* and *decode* arguments must adhere to the :class:`Codec` interface. *Reader* and *Writer* must be factory functions or classes providing objects of the :class:`StreamReader` and :class:`StreamWriter` interface respectively."

msgstr "آرگومان‌های *encode* و *decode* باید از رابط :class:`Codec` پیروی کنند. *Reader* و *Writer* باید توابع یا کلاس‌های کارخانه‌ای باشند که به‌ترتیب شیءهایی از رابط‌های :class:`StreamReader` و :class:`StreamWriter` فراهم می‌کنند."

msgid "Error handling is done in the same way as defined for the stream readers and writers."

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

msgid ":class:`StreamRecoder` instances define the combined interfaces of :class:`StreamReader` and :class:`StreamWriter` classes. They inherit all other methods and attributes from the underlying stream."

msgstr "نمونه‌های :class:`StreamRecoder` رابط‌های ترکیبی کلاس‌های :class:`StreamReader` و :class:`StreamWriter` را تعریف می‌کنند. آن‌ها تمام متدها و ویژگی‌های دیگر را از جریان زیربنایی به ارث می‌برند."

msgid "Encodings and Unicode"

msgstr "کدگذاری‌ها و یونیکد"

msgid "Strings are stored internally as sequences of code points in range ``U+0000``--``U+10FFFF``. (See :pep:`393` for more details about the implementation.) Once a string object is used outside of CPU and memory, endianness and how these arrays are stored as bytes become an issue. As with other codecs, serialising a string into a sequence of bytes is known as *encoding*, and recreating the string from the sequence of bytes is known as *decoding*. There are a variety of different text serialisation codecs, which are collectivity referred to as :term:`text encodings <text encoding>`."

msgstr "رشته‌ها به‌صورت داخلی به‌عنوان دنباله‌هایی از نقاط کد (code points) در بازه‌ی ``U+0000``--``U+10FFFF`` ذخیره می‌شوند. (برای جزئیات بیشتر درباره‌ی پیاده‌سازی، :pep:`393` را ببینید.) هنگامی که از یک شیء رشته خارج از پردازنده و حافظه استفاده شود، ترتیب بایت‌ها (endianness) و چگونگی ذخیره‌ی این آرایه‌ها به‌صورت بایت به یک مسئله تبدیل می‌شوند. مانند سایر کدک‌ها، سریال‌سازی (serialising) یک رشته به دنباله‌ای از بایت‌ها به‌عنوان *کدگذاری* شناخته می‌شود، و بازسازی رشته از دنباله‌ای از بایت‌ها به‌عنوان *کدگشایی* شناخته می‌شود. کدک‌های سریال‌سازی متن گوناگونی وجود دارند که جمعاً به‌عنوان :term:`کدگذاری‌های متنی <text encoding>` شناخته می‌شوند."

msgid "The simplest text encoding (called ``'latin-1'`` or ``'iso-8859-1'``) maps the code points 0--255 to the bytes ``0x0``--``0xff``, which means that a string object that contains code points above ``U+00FF`` can't be encoded with this codec. Doing so will raise a :exc:`UnicodeEncodeError` that looks like the following (although the details of the error message may differ): ``UnicodeEncodeError: 'latin-1' codec can't encode character '\\u1234' in position 3: ordinal not in range(256)``."

msgstr "ساده‌ترین کدگذاری متن (که ``'latin-1'`` یا ``'iso-8859-1'`` نامیده می‌شود) نقاط کد ۰ تا ۲۵۵ را به بایت‌های ``0x0`` تا ``0xff`` نگاشت می‌کند؛ این بدان معناست که شیء رشته‌ای که شامل نقاط کد بالاتر از ``U+00FF`` باشد، با این کدک قابل کدگذاری نیست. این کار باعث پرتاب یک :exc:`UnicodeEncodeError` می‌شود که به شکل زیر است (اگرچه ممکن است جزئیات پیام خطا متفاوت باشد): ``UnicodeEncodeError: 'latin-1' codec can't encode character '\\u1234' in position 3: ordinal not in range(256)``."

msgid "There's another group of encodings (the so called charmap encodings) that choose a different subset of all Unicode code points and how these code points are mapped to the bytes ``0x0``--``0xff``. To see how this is done simply open e.g. :file:`encodings/cp1252.py` (which is an encoding that is used primarily on Windows). There's a string constant with 256 characters that shows you which character is mapped to which byte value."

msgstr "گروه دیگری از کدگذاری‌ها (کدگذاری‌های به‌اصطلاح charmap) وجود دارند که زیرمجموعه‌ای متفاوت از همه نقاط کد یونیکد و چگونگی نگاشت این نقاط کد به بایت‌های ``0x0``--``0xff`` را انتخاب می‌کنند. برای دیدن اینکه این کار چگونه انجام می‌شود، کافی است برای مثال :file:`encodings/cp1252.py` را باز کنید (که کدگذاری‌ای است که عمدتاً در ویندوز به کار می‌رود). یک ثابت رشته‌ای شامل ۲۵۶ نویسه وجود دارد که به شما نشان می‌دهد کدام نویسه به کدام مقدار بایت نگاشته شده است."

msgid "All of these encodings can only encode 256 of the 1114112 code points defined in Unicode. A simple and straightforward way that can store each Unicode code point, is to store each code point as four consecutive bytes. There are two possibilities: store the bytes in big endian or in little endian order. These two encodings are called ``UTF-32-BE`` and ``UTF-32-LE`` respectively. Their disadvantage is that if, for example, you use ``UTF-32-BE`` on a little endian machine you will always have to swap bytes on encoding and decoding. Python's ``UTF-16`` and ``UTF-32`` codecs avoid this problem by using the platform's native byte order when no BOM is present. Python follows prevailing platform practice, so native-endian data round-trips without redundant byte swapping, even though the Unicode Standard defaults to big-endian when the byte order is unspecified. When these bytes are read by a CPU with a different endianness, the bytes have to be swapped. To be able to detect the endianness of a ``UTF-16`` or ``UTF-32`` byte sequence, a BOM (\"Byte Order Mark\") is used. This is the Unicode character ``U+FEFF``. This character can be prepended to every ``UTF-16`` or ``UTF-32`` byte sequence. The byte swapped version of this character (``0xFFFE``) is an illegal character that may not appear in a Unicode text. When the first character of a ``UTF-16`` or ``UTF-32`` byte sequence is ``U+FFFE``, the bytes have to be swapped on decoding."

msgstr "تمام این کدگذاری‌ها تنها می‌توانند ۲۵۶ نقطه‌کد از میان ۱۱۱۴۱۱۲ نقطه‌کد تعریف‌شده در یونیکد را کدگذاری کنند. یک راه ساده و مستقیم که می‌تواند هر نقطه‌کد یونیکد را ذخیره کند، این است که هر نقطه‌کد به‌صورت چهار بایت متوالی ذخیره شود. دو حالت وجود دارد: بایت‌ها به ترتیب بزرگ‌اندیان (big endian) یا کوچک‌اندیان (little endian) ذخیره شوند. به این دو کدگذاری به‌ترتیب ``UTF-32-BE`` و ``UTF-32-LE`` گفته می‌شود. عیب آن‌ها این است که اگر، برای مثال، از ``UTF-32-BE`` روی یک ماشین کوچک‌اندیان استفاده کنید، همیشه باید بایت‌ها را در کدگذاری و کدگشایی جابه‌جا کنید. کدک‌های ``UTF-16`` و ``UTF-32`` پایتون با استفاده از ترتیب بایت بومی سکو در صورت نبود BOM، از این مشکل اجتناب می‌کنند. پایتون از رویه‌ی رایج سکو پیروی می‌کند، بنابراین رفت‌وبرگشت داده‌های با ترتیب بایت بومی بدون جابه‌جایی اضافی بایت‌ها انجام می‌شود، هرچند استاندارد یونیکد در صورت مشخص نبودن ترتیب بایت‌ها، به‌طور پیش‌فرض از بزرگ‌اندیان استفاده می‌کند. هنگامی که این بایت‌ها توسط یک CPU با ترتیب بایت متفاوت خوانده شوند، باید بایت‌ها جابه‌جا شوند. برای تشخیص ترتیب بایت یک دنباله‌ی بایتی ``UTF-16`` یا ``UTF-32``، از BOM («نشانگر ترتیب بایت») استفاده می‌شود. این نویسه‌ی یونیکد ``U+FEFF`` است. این نویسه می‌تواند به ابتدای هر دنباله‌ی بایتی ``UTF-16`` یا ``UTF-32`` افزوده شود. نسخه‌ی جابه‌جاشده‌ی بایت‌های این نویسه (``0xFFFE``) یک نویسه‌ی غیرمجاز است که نباید در متن یونیکد ظاهر شود. هنگامی که اولین نویسه‌ی یک دنباله‌ی بایتی ``UTF-16`` یا ``UTF-32`` برابر ``U+FFFE`` باشد، باید بایت‌ها در کدگشایی جابه‌جا شوند."

msgid "Unfortunately the character ``U+FEFF`` had a second purpose as a ``ZERO WIDTH NO-BREAK SPACE``: a character that has no width and doesn't allow a word to be split. It can e.g. be used to give hints to a ligature algorithm. With Unicode 4.0 using ``U+FEFF`` as a ``ZERO WIDTH NO-BREAK SPACE`` has been deprecated (with ``U+2060`` (``WORD JOINER``) assuming this role). Nevertheless Unicode software still must be able to handle ``U+FEFF`` in both roles: as a BOM it's a device to determine the storage layout of the encoded bytes, and vanishes once the byte sequence has been decoded into a string; as a ``ZERO WIDTH NO-BREAK SPACE`` it's a normal character that will be decoded like any other."

msgstr "متأسفانه نویسه‌ی ``U+FEFF`` کاربرد دومی به‌عنوان ``ZERO WIDTH NO-BREAK SPACE`` داشت: نویسه‌ای که عرضی ندارد و اجازه نمی‌دهد یک واژه شکسته شود. برای مثال، می‌توان از آن برای دادن سرنخ‌هایی به یک الگوریتم لیگاتور (ligature) استفاده کرد. از یونیکد 4.0، استفاده از ``U+FEFF`` به‌عنوان ``ZERO WIDTH NO-BREAK SPACE`` منسوخ شده است (و ``U+2060`` (``WORD JOINER``) این نقش را بر عهده گرفته است). با این حال، نرم‌افزارهای یونیکد همچنان باید بتوانند ``U+FEFF`` را در هر دو نقش پردازش کنند: در نقش BOM، ابزاری است برای تعیین چیدمان ذخیره‌سازی بایت‌های کدگذاری‌شده، و پس از اینکه دنباله‌ی بایت‌ها به یک رشته کدگشایی شد، ناپدید می‌شود؛ در نقش ``ZERO WIDTH NO-BREAK SPACE``، نویسه‌ای عادی است که مانند هر نویسه‌ی دیگری کدگشایی خواهد شد."

msgid "There's another encoding that is able to encode the full range of Unicode characters: UTF-8. UTF-8 is an 8-bit encoding, which means there are no issues with byte order in UTF-8. Each byte in a UTF-8 byte sequence consists of two parts: marker bits (the most significant bits) and payload bits. The marker bits are a sequence of zero to four ``1`` bits followed by a ``0`` bit. Unicode characters are encoded like this (with x being payload bits, which when concatenated give the Unicode character):"

msgstr "کدگذاری دیگری نیز وجود دارد که می‌تواند تمام بازه‌ی نویسه‌های یونیکد را کدگذاری کند: UTF-8. UTF-8 یک کدگذاری ۸ بیتی است، به این معنا که در UTF-8 هیچ مشکلی از بابت ترتیب بایت‌ها وجود ندارد. هر بایت در یک دنباله‌ی بایتی UTF-8 از دو بخش تشکیل شده است: بیت‌های نشانگر (بیت‌های پرارزش) و بیت‌های بار. بیت‌های نشانگر دنباله‌ای از صفر تا چهار بیت ``1`` هستند که پس از آن‌ها یک بیت ``0`` می‌آید. نویسه‌های یونیکد به این صورت کدگذاری می‌شوند (که در آن x نشان‌دهنده‌ی بیت‌های بار است و با الحاق آن‌ها، نویسه‌ی یونیکد به دست می‌آید):"

msgid "Range"

msgstr "بازه"

msgid "Encoding"

msgstr "کدگذاری"

msgid "``U-00000000`` ... ``U-0000007F``"

msgstr "``U-00000000`` ... ``U-0000007F``"

msgid "0xxxxxxx"

msgstr "0xxxxxxx"

msgid "``U-00000080`` ... ``U-000007FF``"

msgstr "``U-00000080`` ... ``U-000007FF``"

msgid "110xxxxx 10xxxxxx"

msgstr "110xxxxx 10xxxxxx"

msgid "``U-00000800`` ... ``U-0000FFFF``"

msgstr "``U-00000800`` ... ``U-0000FFFF``"

msgid "1110xxxx 10xxxxxx 10xxxxxx"

msgstr "1110xxxx 10xxxxxx 10xxxxxx"

msgid "``U-00010000`` ... ``U-0010FFFF``"

msgstr "``U-00010000`` ... ``U-0010FFFF``"

msgid "11110xxx 10xxxxxx 10xxxxxx 10xxxxxx"

msgstr "11110xxx 10xxxxxx 10xxxxxx 10xxxxxx"

msgid "The least significant bit of the Unicode character is the rightmost x bit."

msgstr "کم‌ارزش‌ترین بیت نویسه‌ی یونیکد، راست‌ترین بیت x است."

msgid "As UTF-8 is an 8-bit encoding no BOM is required and any ``U+FEFF`` character in the decoded string (even if it's the first character) is treated as a ``ZERO WIDTH NO-BREAK SPACE``."

msgstr "از آن‌جا که UTF-8 یک کدگذاری ۸-بیتی است، نیازی به نشانگر ترتیب بایت‌ها (BOM) نیست و هر نویسه‌ی ``U+FEFF`` در رشته‌ی کدگشایی‌شده (حتی اگر اولین نویسه باشد) به‌عنوان یک ``ZERO WIDTH NO-BREAK SPACE`` در نظر گرفته می‌شود."

msgid "Without external information it's impossible to reliably determine which encoding was used for encoding a string. Each charmap encoding can decode any random byte sequence. However that's not possible with UTF-8, as UTF-8 byte sequences have a structure that doesn't allow arbitrary byte sequences. To increase the reliability with which a UTF-8 encoding can be detected, Microsoft invented a variant of UTF-8 (that Python calls ``\"utf-8-sig\"``) for its Notepad program: Before any of the Unicode characters is written to the file, a UTF-8 encoded BOM (which looks like this as a byte sequence: ``0xef``, ``0xbb``, ``0xbf``) is written. As it's rather improbable that any charmap encoded file starts with these byte values (which would e.g. map to"

msgstr "بدون اطلاعات خارجی، نمی‌توان به‌طور قابل‌اطمینان تعیین کرد کدام کدگذاری برای کدگذاری یک رشته استفاده شده است. هر کدگذاری charmap می‌تواند هر دنباله بایت تصادفی را کدگشایی کند. اما این موضوع در مورد UTF-8 ممکن نیست، زیرا دنباله‌های بایت UTF-8 دارای ساختاری هستند که دنباله‌های بایت دلخواه را مجاز نمی‌داند. برای افزایش قابلیت اطمینانی که می‌توان با آن کدگذاری UTF-8 را تشخیص داد، مایکروسافت برای برنامه Notepad خود گونه‌ای از UTF-8 را ابداع کرد (که پایتون آن را ``\"utf-8-sig\"`` می‌نامد): پیش از آنکه هر یک از نویسه‌های Unicode به پرونده نوشته شود، یک BOM کدگذاری‌شده با UTF-8 (که به‌صورت یک دنباله بایت به این شکل به نظر می‌رسد: ``0xef``، ``0xbb``، ``0xbf``) نوشته می‌شود. از آنجا که نسبتاً بعید است هیچ پرونده کدگذاری‌شده با charmap با این مقادیر بایت شروع شود (که برای مثال نگاشت می‌شوند به"

msgid "LATIN SMALL LETTER I WITH DIAERESIS"

msgstr "نویسه‌ی کوچک لاتین I با دونقطه (DIAERESIS)"

msgid "RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK"

msgstr "علامت نقل‌قول زاویه‌ای دوتایی رو به راست"

msgid "INVERTED QUESTION MARK"

msgstr "علامت سؤال وارونه"

msgid "in iso-8859-1), this increases the probability that a ``utf-8-sig`` encoding can be correctly guessed from the byte sequence. So here the BOM is not used to be able to determine the byte order used for generating the byte sequence, but as a signature that helps in guessing the encoding. On encoding the utf-8-sig codec will write ``0xef``, ``0xbb``, ``0xbf`` as the first three bytes to the file. On decoding ``utf-8-sig`` will skip those three bytes if they appear as the first three bytes in the file. In UTF-8, the use of the BOM is discouraged and should generally be avoided."

msgstr "در iso-8859-1)، این موضوع احتمال اینکه کدگذاری ``utf-8-sig`` بتواند به‌درستی از روی دنباله‌ی بایت‌ها حدس زده شود را افزایش می‌دهد. بنابراین در اینجا نشانه‌ی ترتیب بایت‌ها (BOM) برای تعیین ترتیب بایت‌های استفاده‌شده برای تولید دنباله‌ی بایت‌ها استفاده نمی‌شود، بلکه به‌عنوان امضایی است که به حدس زدن کدگذاری کمک می‌کند. هنگام کدگذاری، کدک utf-8-sig ``0xef``، ``0xbb`` و ``0xbf`` را به‌عنوان سه بایت نخست در پرونده می‌نویسد. هنگام کدگشایی، ``utf-8-sig`` آن سه بایت را در صورتی که به‌عنوان سه بایت نخست در پرونده ظاهر شوند، نادیده می‌گیرد. در UTF-8، استفاده از BOM توصیه نمی‌شود و عموماً باید از آن اجتناب شود."

msgid "Standard Encodings"

msgstr "کدگذاری‌های استاندارد"

msgid "Python comes with a number of codecs built-in, either implemented as C functions or with dictionaries as mapping tables. The following table lists the codecs by name, together with a few common aliases, and the languages for which the encoding is likely used. Neither the list of aliases nor the list of languages is meant to be exhaustive. Notice that spelling alternatives that only differ in case or use a hyphen instead of an underscore are also valid aliases because they are equivalent when normalized by :func:`~encodings.normalize_encoding`. For example, ``'utf-8'`` is a valid alias for the ``'utf_8'`` codec."

msgstr "پایتون همراه با تعدادی کدک توکار است که یا به‌صورت توابع C یا با استفاده از دیکشنری‌ها به‌عنوان جداول نگاشت پیاده‌سازی شده‌اند. جدول زیر کدک‌ها را بر اساس نام، به‌همراه چند نام مستعار رایج و زبان‌هایی که احتمالاً کدگذاری برای آن‌ها استفاده می‌شود، فهرست می‌کند. هیچ‌یک از فهرست نام‌های مستعار و فهرست زبان‌ها برای جامع بودن در نظر گرفته نشده است. توجه داشته باشید که نوشتارهای جایگزینی که فقط از نظر بزرگی یا کوچکی حروف تفاوت دارند یا به‌جای زیرخط از خط تیره استفاده می‌کنند نیز نام‌های مستعار معتبر هستند، زیرا وقتی با :func:`~encodings.normalize_encoding` نرمال‌سازی شوند، معادل یکدیگر هستند. برای مثال، ``'utf-8'`` یک نام مستعار معتبر برای کدک ``'utf_8'`` است."

msgid "The below table lists the most common aliases, for a complete list refer to the source :source:`aliases.py <Lib/encodings/aliases.py>` file."

msgstr "جدول زیر رایج‌ترین نام‌های مستعار را فهرست می‌کند، برای فهرست کامل به پرونده منبع :source:`aliases.py <Lib/encodings/aliases.py>` مراجعه کنید."

msgid "On Windows, ``cpXXX`` codecs are available for all code pages. But only codecs listed in the following table are guarantead to exist on other platforms."

msgstr "در ویندوز، کدک‌های ``cpXXX`` برای تمام صفحه‌های کد در دسترس هستند. اما تضمین می‌شود که تنها کدک‌های فهرست‌شده در جدول زیر در سایر پلتفرم‌ها وجود داشته باشند."

msgid "Some common encodings can bypass the codecs lookup machinery to improve performance. These optimization opportunities are only recognized by CPython for a limited set of (case insensitive) aliases: utf-8, utf8, latin-1, latin1, iso-8859-1, iso8859-1, mbcs (Windows only), ascii, us-ascii, utf-16, utf16, utf-32, utf32, and the same using underscores instead of dashes. Using alternative aliases for these encodings may result in slower execution."

msgstr "برخی کدگذاری‌های رایج می‌توانند برای بهبود کارایی، سازوکار جست‌وجوی کدک‌ها را دور بزنند. این فرصت‌های بهینه‌سازی تنها برای مجموعه‌ای محدود از نام‌های مستعار (غیرحساس به بزرگی و کوچکی حروف) توسط CPython شناسایی می‌شوند: utf-8، utf8، latin-1، latin1، iso-8859-1، iso8859-1، mbcs (فقط ویندوز)، ascii، us-ascii، utf-16، utf16، utf-32، utf32، و همان موارد با استفاده از زیرسطرها به‌جای سطرهای تیره. استفاده از نام‌های مستعار جایگزین برای این کدگذاری‌ها ممکن است باعث اجرای کندتر شود."

msgid "Optimization opportunity recognized for us-ascii."

msgstr "فرصت بهینه‌سازی برای us-ascii شناسایی شد."

msgid "Many of the character sets support the same languages. They vary in individual characters (e.g. whether the EURO SIGN is supported or not), and in the assignment of characters to code positions. For the European languages in particular, the following variants typically exist:"

msgstr "بسیاری از مجموعه‌نویسه‌ها از زبان‌های یکسانی پشتیبانی می‌کنند. آن‌ها از نظر نویسه‌های منفرد (مثلاً اینکه آیا EURO SIGN پشتیبانی می‌شود یا نه) و از نظر تخصیص نویسه‌ها به موقعیت‌های کد تفاوت دارند. به‌ویژه برای زبان‌های اروپایی، معمولاً گونه‌های زیر وجود دارند:"

msgid "an ISO 8859 codeset"

msgstr "یک مجموعه‌کد ISO 8859"

msgid "a Microsoft Windows code page, which is typically derived from an 8859 codeset, but replaces control characters with additional graphic characters"

msgstr "یک صفحه کد (code page) مایکروسافت ویندوز، که به‌طور معمول از یک مجموعه کد (codeset) 8859 مشتق شده است، اما نویسه‌های کنترلی را با نویسه‌های گرافیکی اضافی جایگزین می‌کند"

msgid "an IBM EBCDIC code page"

msgstr "یک صفحه‌کد IBM EBCDIC"

msgid "an IBM PC code page, which is ASCII compatible"

msgstr "یک صفحه‌کد IBM PC که با ASCII سازگار است"

msgid "Codec"

msgstr "کدک"

msgid "Aliases"

msgstr "نام‌های مستعار"

msgid "Languages"

msgstr "زبان‌ها"

msgid "ascii"

msgstr "ascii"

msgid "646, us-ascii"

msgstr "646, us-ascii"

msgid "English"

msgstr "انگلیسی"

msgid "big5"

msgstr "big5"

msgid "big5-tw, csbig5"

msgstr "big5-tw, csbig5"

msgid "Traditional Chinese"

msgstr "چینی سنتی"

msgid "big5hkscs"

msgstr "big5hkscs"

msgid "big5-hkscs, hkscs"

msgstr "big5-hkscs, hkscs"

msgid "cp037"

msgstr "cp037"

msgid "IBM037, IBM039"

msgstr "IBM037, IBM039"

msgid "cp273"

msgstr "cp273"

msgid "273, IBM273, csIBM273"

msgstr "273, IBM273, csIBM273"

msgid "German"

msgstr "آلمانی"

msgid "cp424"

msgstr "cp424"

msgid "EBCDIC-CP-HE, IBM424"

msgstr "EBCDIC-CP-HE, IBM424"

msgid "Hebrew"

msgstr "عبری"

msgid "cp437"

msgstr "cp437"

msgid "437, IBM437"

msgstr "437, IBM437"

msgid "cp500"

msgstr "cp500"

msgid "EBCDIC-CP-BE, EBCDIC-CP-CH, IBM500"

msgstr "EBCDIC-CP-BE, EBCDIC-CP-CH, IBM500"

msgid "Western Europe"

msgstr "اروپای غربی"

msgid "cp720"

msgstr "cp720"

msgid "Arabic"

msgstr "عربی"

msgid "cp737"

msgstr "cp737"

msgid "Greek"

msgstr "یونانی"

msgid "cp775"

msgstr "cp775"

msgid "IBM775"

msgstr "IBM775"

msgid "Baltic languages"

msgstr "زبان‌های بالتیک"

msgid "cp850"

msgstr "cp850"

msgid "850, IBM850"

msgstr "850, IBM850"

msgid "cp852"

msgstr "cp852"

msgid "852, IBM852"

msgstr "852, IBM852"

msgid "Central and Eastern Europe"

msgstr "اروپای مرکزی و شرقی"

msgid "cp855"

msgstr "cp855"

msgid "855, IBM855"

msgstr "855, IBM855"

msgid "Belarusian, Bulgarian, Macedonian, Russian, Serbian"

msgstr "بلاروسی، بلغاری، مقدونی، روسی، صربی"

msgid "cp856"

msgstr "cp856"

msgid "cp857"

msgstr "cp857"

msgid "857, IBM857"

msgstr "857, IBM857"

msgid "Turkish"

msgstr "ترکی"

msgid "cp858"

msgstr "cp858"

msgid "858, IBM00858"

msgstr "858, IBM00858"

msgid "cp860"

msgstr "cp860"

msgid "860, IBM860"

msgstr "860, IBM860"

msgid "Portuguese"

msgstr "پرتغالی"

msgid "cp861"

msgstr "cp861"

msgid "861, CP-IS, IBM861"

msgstr "861, CP-IS, IBM861"

msgid "Icelandic"

msgstr "ایسلندی"

msgid "cp862"

msgstr "cp862"

msgid "862, IBM862"

msgstr "862, IBM862"

msgid "cp863"

msgstr "cp863"

msgid "863, IBM863"

msgstr "863, IBM863"

msgid "Canadian"

msgstr "کانادایی"

msgid "cp864"

msgstr "cp864"

msgid "IBM864"

msgstr "IBM864"

msgid "cp865"

msgstr "cp865"

msgid "865, IBM865"

msgstr "865, IBM865"

msgid "Danish, Norwegian"

msgstr "دانمارکی، نروژی"

msgid "cp866"

msgstr "cp866"

msgid "866, IBM866"

msgstr "866, IBM866"

msgid "Russian"

msgstr "روسی"

msgid "cp869"

msgstr "cp869"

msgid "869, CP-GR, IBM869"

msgstr "869, CP-GR, IBM869"

msgid "cp874"

msgstr "cp874"

msgid "Thai"

msgstr "تایلندی"

msgid "cp875"

msgstr "cp875"

msgid "cp932"

msgstr "cp932"

msgid "932, ms932, mskanji, ms-kanji, windows-31j"

msgstr "932, ms932, mskanji, ms-kanji, windows-31j"

msgid "Japanese"

msgstr "ژاپنی"

msgid "cp949"

msgstr "cp949"

msgid "949, ms949, uhc"

msgstr "949, ms949, uhc"

msgid "Korean"

msgstr "کره‌ای"

msgid "cp950"

msgstr "cp950"

msgid "950, ms950"

msgstr "950, ms950"

msgid "cp1006"

msgstr "cp1006"

msgid "Urdu"

msgstr "اردو"

msgid "cp1026"

msgstr "cp1026"

msgid "ibm1026"

msgstr "ibm1026"

msgid "cp1125"

msgstr "cp1125"

msgid "1125, ibm1125, cp866u, ruscii"

msgstr "1125, ibm1125, cp866u, ruscii"

msgid "Ukrainian"

msgstr "اوکراینی"

msgid "cp1140"

msgstr "cp1140"

msgid "IBM01140"

msgstr "IBM01140"

msgid "cp1250"

msgstr "cp1250"

msgid "windows-1250"

msgstr "windows-1250"

msgid "cp1251"

msgstr "cp1251"

msgid "windows-1251"

msgstr "windows-1251"

msgid "cp1252"

msgstr "cp1252"

msgid "windows-1252"

msgstr "windows-1252"

msgid "cp1253"

msgstr "cp1253"

msgid "windows-1253"

msgstr "windows-1253"

msgid "cp1254"

msgstr "cp1254"

msgid "windows-1254"

msgstr "windows-1254"

msgid "cp1255"

msgstr "cp1255"

msgid "windows-1255"

msgstr "windows-1255"

msgid "cp1256"

msgstr "cp1256"

msgid "windows-1256"

msgstr "windows-1256"

msgid "cp1257"

msgstr "cp1257"

msgid "windows-1257"

msgstr "windows-1257"

msgid "cp1258"

msgstr "cp1258"