bytes.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-21 11:59+0000\n"
"PO-Revision-Date: 2026-09-15 13:25+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 "Bytes Objects"
msgstr "اشیاء بایت"

msgid "These functions raise :exc:`TypeError` when expecting a bytes parameter and called with a non-bytes parameter."
msgstr "این توابع هنگامی که انتظار پارامتر bytes را دارند و با پارامتری غیر bytes فراخوانی می‌شوند، :exc:`TypeError` را raise می‌کنند."

msgid "The internal buffer of :c:type:`PyBytesObject` always includes an extra trailing null byte for compatibility with null terminated C strings. This extra byte is not counted in :c:func:`PyBytes_Size` nor in the various *length* and *size* arguments of the functions below."
msgstr "بافر داخلی :c:type:`PyBytesObject` همیشه یک بایت خالی (null) اضافی در پایان برای سازگاری با رشته‌های C خاتمه‌یافته‌به‌خالی (null terminated) شامل می‌شود. این بایت اضافی در :c:func:`PyBytes_Size` و نه در آرگومان‌های مختلف *length* و *size* توابع زیر شمارش می‌شود."

msgid "This subtype of :c:type:`PyObject` represents a Python bytes object."
msgstr "این زیرنوع از :c:type:`PyObject` یک شیء bytes پایتون را نمایش می‌دهد."

msgid "This instance of :c:type:`PyTypeObject` represents the Python bytes type; it is the same object as :class:`bytes` in the Python layer."
msgstr "این نمونه از :c:type:`PyTypeObject` نوع bytes پایتون را نمایندگی می‌کند؛ این همان شیء :class:`bytes` در لایه‌ی پایتون است."

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

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

msgid "Return a new bytes object with a copy of the string *v* as value on success, and ``NULL`` on failure.  The parameter *v* must not be ``NULL``; it will not be checked."
msgstr "در صورت موفقیت، شیء بایت جدیدی را برمی‌گرداند که مقدار آن کپی رشته *v* است، و در صورت شکست ``NULL`` برمی‌گرداند. پارامتر *v* نباید ``NULL`` باشد؛ بررسی نخواهد شد."

msgid "Return a new bytes object with a copy of the string *v* as value and length *len* on success, and ``NULL`` on failure.  If *v* is ``NULL``, the contents of the bytes object are uninitialized."
msgstr "در صورت موفقیت، شیء بایت جدیدی برمی‌گرداند که مقدار آن رونوشتی از رشته *v* و طول آن *len* است و در صورت شکست ``NULL`` برمی‌گرداند. اگر *v* برابر ``NULL`` باشد، محتویات شیء بایت مقداردهی‌نشده هستند."

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

msgid "Format Characters"
msgstr "نویسه‌های قالب"

msgid "Type"
msgstr "نوع"

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

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

msgid "*n/a*"
msgstr "*غیرقابل اعمال*"

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

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

msgid "int"
msgstr "int"

msgid "A single byte, represented as a C int."
msgstr "یک بایت منفرد که به‌صورت int در C بازنمایی می‌شود."

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

msgid "Equivalent to ``printf(\"%d\")``. [1]_"
msgstr "معادل ``printf(\"%d\")`` است. [1]_"

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

msgid "unsigned int"
msgstr "unsigned int"

msgid "Equivalent to ``printf(\"%u\")``. [1]_"
msgstr "معادل ``printf(\"%u\")`` است. [1]_"

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

msgid "long"
msgstr "long"

msgid "Equivalent to ``printf(\"%ld\")``. [1]_"
msgstr "معادل ``printf(\"%ld\")``. [1]_"

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

msgid "unsigned long"
msgstr "unsigned long"

msgid "Equivalent to ``printf(\"%lu\")``. [1]_"
msgstr "معادل ``printf(\"%lu\")``. [1]_"

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

msgid ":c:type:`\\ Py_ssize_t`"
msgstr ":c:type:`\\ Py_ssize_t`"

msgid "Equivalent to ``printf(\"%zd\")``. [1]_"
msgstr "معادل ``printf(\"%zd\")`` است. [1]_"

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

msgid "size_t"
msgstr "size_t"

msgid "Equivalent to ``printf(\"%zu\")``. [1]_"
msgstr "معادل ``printf(\"%zu\")`` است. [1]_"

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

msgid "Equivalent to ``printf(\"%i\")``. [1]_"
msgstr "معادل ``printf(\"%i\")`` است. [1]_"

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

msgid "Equivalent to ``printf(\"%x\")``. [1]_"
msgstr "معادل ``printf(\"%x\")`` است. [1]_"

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

msgid "const char\\*"
msgstr "const char\\*"

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

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

msgid "const void\\*"
msgstr "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\")`` است، با این تفاوت که شروع آن با مقدار لفظی ``0x`` تضمین شده است، صرف‌نظر از آنچه ``printf`` پلتفرم تولید می‌کند."

msgid "An unrecognized format character causes all the rest of the format string to be copied as-is to the result object, and any extra arguments discarded."
msgstr "نویسه قالب‌بندی ناشناخته باعث می‌شود تمام باقی‌مانده‌ی رشته قالب‌بندی عیناً در شیء نتیجه کپی شود و هر آرگومان اضافی نیز دور ریخته شود."

msgid "For integer specifiers (d, u, ld, lu, zd, zu, i, x): the 0-conversion flag has effect even when a precision is given."
msgstr "برای مشخص‌کننده‌های عدد صحیح (d, u, ld, lu, zd, zu, i, x): پرچم تبدیل 0 حتی هنگامی که دقتی مشخص‌شده باشد، تأثیر دارد."

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

msgid "Return the bytes representation of object *o* that implements the buffer protocol."
msgstr "نمایش بایتی شیء *o* را که پروتکل بافر را پیاده‌سازی می‌کند، برمی‌گرداند."

msgid "If the object implements the buffer protocol, then the buffer must not be mutated while the bytes object is being created."
msgstr "اگر شیء پروتکل بافر را پیاده‌سازی کند، بافر نباید در حین ایجاد شدن شیء بایت تغییر داده شود."

msgid "Return the length of the bytes in bytes object *o*."
msgstr "طول بایت‌های شیء بایت *o* را برمی‌گرداند."

msgid "Similar to :c:func:`PyBytes_Size`, but without error checking."
msgstr "مشابه :c:func:`PyBytes_Size`، اما بدون بررسی خطا."

msgid "Return a pointer to the contents of *o*.  The pointer refers to the internal buffer of *o*, which consists of ``len(o) + 1`` bytes.  The last byte in the buffer is always null, regardless of whether there are any other null bytes.  The data must not be modified in any way, unless the object was just created using ``PyBytes_FromStringAndSize(NULL, size)``. It must not be deallocated.  If *o* is not a bytes object at all, :c:func:`PyBytes_AsString` returns ``NULL`` and raises :exc:`TypeError`."
msgstr "اشاره‌گری به محتویات *o* را برمی‌گرداند. این اشاره‌گر به بافر داخلی *o* اشاره می‌کند که از ``len(o) + 1`` بایت تشکیل شده است. آخرین بایت در بافر همیشه تهی است، صرف‌نظر از اینکه بایت‌های تهی دیگری وجود دارند یا نه. این داده نباید به هیچ شکلی تغییر داده شود، مگر اینکه شیء تازه با استفاده از ``PyBytes_FromStringAndSize(NULL, size)`` ایجاد شده باشد. نباید آزادسازی شود. اگر *o* اصلاً یک شیء بایت نباشد، :c:func:`PyBytes_AsString` مقدار ``NULL`` را برمی‌گرداند و استثنای :exc:`TypeError` را ایجاد می‌کند."

msgid "Similar to :c:func:`PyBytes_AsString`, but without error checking."
msgstr "مشابه :c:func:`PyBytes_AsString`، اما بدون بررسی خطا."

msgid "Return the null-terminated contents of the object *obj* through the output variables *buffer* and *length*. Returns ``0`` on success."
msgstr "محتوای شیء *obj* را که با تهی پایان یافته است، از طریق متغیرهای خروجی *buffer* و *length* برمی‌گرداند. در صورت موفقیت ``0`` را برمی‌گرداند."

msgid "If *length* is ``NULL``, the bytes object may not contain embedded null bytes; if it does, the function returns ``-1`` and a :exc:`ValueError` is raised."
msgstr "اگر *length* برابر ``NULL`` باشد، شیء بایت نباید شامل بایت‌های تهی تعبیه‌شده باشد؛ در غیر این صورت، تابع ``-1`` را برمی‌گرداند و استثنای :exc:`ValueError` به‌وجود می‌آید."

msgid "The buffer refers to an internal buffer of *obj*, which includes an additional null byte at the end (not counted in *length*).  The data must not be modified in any way, unless the object was just created using ``PyBytes_FromStringAndSize(NULL, size)``.  It must not be deallocated.  If *obj* is not a bytes object at all, :c:func:`PyBytes_AsStringAndSize` returns ``-1`` and raises :exc:`TypeError`."
msgstr "بافر به بافر داخلی *obj* اشاره می‌کند که شامل یک بایت تهی اضافی در انتها است (که در *length* شمرده نمی‌شود). داده‌ها نباید به هیچ شکلی تغییر داده شوند، مگر آنکه شیء به‌تازگی با استفاده از ``PyBytes_FromStringAndSize(NULL, size)`` ایجاد شده باشد. این بافر نباید آزاد شود. اگر *obj* اصلاً یک شیء بایت نباشد، :c:func:`PyBytes_AsStringAndSize` مقدار ``-1`` را برمی‌گرداند و استثنای :exc:`TypeError` را ایجاد می‌کند."

msgid "Previously, :exc:`TypeError` was raised when embedded null bytes were encountered in the bytes object."
msgstr "پیش‌تر، هنگامی که به بایت‌های تهی تعبیه‌شده در شیء بایت برخورد می‌شد، :exc:`TypeError` رخ می‌داد."

msgid "Create a new bytes object in *\\*bytes* containing the contents of *newpart* appended to *bytes*; the caller will own the new reference. The reference to the old value of *bytes* will be \":term:`stolen <steal>`\". If the new object cannot be created, the old reference to *bytes* will still be \"stolen\", the value of *\\*bytes* will be set to ``NULL``, and the appropriate exception will be set."
msgstr "یک شیء بایت جدید در *\\*bytes* ایجاد می‌کند که شامل محتوای *newpart* الحاق‌شده به *bytes* است؛ فراخوان‌کننده مالک ارجاع جدید خواهد بود. ارجاع به مقدار قبلی *bytes* «:term:`دزدیده‌شده (stolen) <steal>`» خواهد بود. اگر نتوان شیء جدید را ایجاد کرد، ارجاع قبلی به *bytes* همچنان «دزدیده‌شده» خواهد بود، مقدار *\\*bytes* برابر ``NULL`` قرار خواهد گرفت و استثنای مناسب تنظیم خواهد شد."

msgid "If *newpart* implements the buffer protocol, then the buffer must not be mutated while the new bytes object is being created."
msgstr "اگر *newpart* پروتکل بافر را پیاده‌سازی کرده باشد، بافر نباید در حین ایجاد شدن شیء بایت جدید تغییر کند."

msgid "Create a new bytes object in *\\*bytes* containing the contents of *newpart* appended to *bytes*.  This version releases the :term:`strong reference` to *newpart* (i.e. decrements its reference count)."
msgstr "یک شیء بایت جدید در *\\*bytes* ایجاد می‌کند که محتوای *newpart* الحاق‌شده به *bytes* را در بر دارد.  این نسخه :term:`ارجاع قوی <strong reference>` به *newpart* را آزاد می‌کند (یعنی شمارش ارجاع آن را کاهش می‌دهد)."

msgid "Similar to ``sep.join(iterable)`` in Python."
msgstr "مشابه ``sep.join(iterable)`` در پایتون."

msgid "*sep* must be Python :class:`bytes` object. (Note that :c:func:`PyUnicode_Join` accepts ``NULL`` separator and treats it as a space, whereas :c:func:`PyBytes_Join` doesn't accept ``NULL`` separator.)"
msgstr "*sep* باید یک شیء :class:`bytes` پایتون باشد. (توجه داشته باشید که :c:func:`PyUnicode_Join` جداکننده ``NULL`` را می‌پذیرد و آن را به‌عنوان یک فاصله در نظر می‌گیرد، در حالی که :c:func:`PyBytes_Join` جداکننده ``NULL`` را نمی‌پذیرد.)"

msgid "*iterable* must be an iterable object yielding objects that implement the :ref:`buffer protocol <bufferobjects>`."
msgstr "*iterable* باید یک شیء پیمایش‌پذیر باشد که اشیایی را تولید می‌کند که :ref:`پروتکل بافر <bufferobjects>` را پیاده‌سازی کرده باشند."

msgid "On success, return a new :class:`bytes` object. On error, set an exception and return ``NULL``."
msgstr "در صورت موفقیت، یک شیء :class:`bytes` جدید برمی‌گرداند. در صورت خطا، یک استثنا تنظیم کرده و ``NULL`` برمی‌گرداند."

msgid "If *iterable* objects implement the buffer protocol, then the buffers must not be mutated while the new bytes object is being created."
msgstr "اگر اشیاء *iterable* پروتکل بافر را پیاده‌سازی کنند، بافرها نباید در حین ایجاد شیء بایت جدید تغییر داده شوند."

msgid "Resize a bytes object. *newsize* will be the new length of the bytes object. You can think of it as creating a new bytes object and destroying the old one, only more efficiently. Pass the address of an existing bytes object as an lvalue (it may be written into), and the new size desired.  On success, *\\*bytes* holds the resized bytes object and ``0`` is returned; the address in *\\*bytes* may differ from its input value.  If the reallocation fails, the original bytes object at *\\*bytes* is deallocated, *\\*bytes* is set to ``NULL``, :exc:`MemoryError` is set, and ``-1`` is returned."
msgstr "اندازه یک شیء بایت را تغییر می‌دهد. *newsize* طول جدید شیء بایت خواهد بود. می‌توانید آن را به‌صورت ایجاد یک شیء بایت جدید و نابود کردن شیء قدیمی تصور کنید، فقط با کارایی بیشتر. آدرس یک شیء بایت موجود را به‌عنوان یک چپ‌مقدار (lvalue) (که ممکن است در آن نوشته شود) به همراه اندازه جدید موردنظر ارسال کنید. در صورت موفقیت، *\\*bytes* حاوی شیء بایت با اندازه جدید است و ``0`` بازگردانده می‌شود؛ آدرس موجود در *\\*bytes* ممکن است با مقدار ورودی آن متفاوت باشد. اگر تخصیص مجدد شکست بخورد، شیء بایت اصلی موجود در *\\*bytes* آزاد می‌شود، *\\*bytes* برابر ``NULL`` قرار می‌گیرد، :exc:`MemoryError` تنظیم می‌شود و ``-1`` بازگردانده می‌شود."

msgid "Get the string representation of *bytes*. This function is currently used to implement :meth:`!bytes.__repr__` in Python."
msgstr "بازنمایی رشته‌ای *bytes* را برمی‌گرداند. این تابع در حال حاضر برای پیاده‌سازی :meth:`!bytes.__repr__` در پایتون استفاده می‌شود."

msgid "This function does not do type checking; it is undefined behavior to pass *bytes* as a non-bytes object or ``NULL``."
msgstr "این تابع بررسی نوع انجام نمی‌دهد؛ گذراندن *bytes* به‌عنوان یک شیء غیربایتی یا ``NULL`` رفتار تعریف‌نشده است."

msgid "If *smartquotes* is true, the representation will use a double-quoted string instead of single-quoted string when single-quotes are present in *bytes*. For example, the byte string ``'Python'`` would be represented as ``b\"'Python'\"`` when *smartquotes* is true, or ``b'\\'Python\\''`` when it is false."
msgstr "اگر *smartquotes* درست باشد، نمایش در صورت وجود علامت‌های نقل‌قول تکی در *bytes*، به‌جای رشته‌ی محصور در علامت نقل‌قول تکی از رشته‌ی محصور در علامت نقل‌قول دوتایی استفاده خواهد کرد. برای مثال، رشته‌ی بایتی ``'Python'`` هنگامی که *smartquotes* درست باشد به‌صورت ``b\"'Python'\"`` و هنگامی که نادرست باشد به‌صورت ``b'\\'Python\\''`` نمایش داده می‌شود."

msgid "On success, this function returns a :term:`strong reference` to a :class:`str` object containing the representation. On failure, this returns ``NULL`` with an exception set."
msgstr "در صورت موفقیت، این تابع یک :term:`ارجاع قوی <strong reference>` به یک شیء :class:`str` حاوی نمایش را برمی‌گرداند. در صورت شکست، این تابع ``NULL`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند."

msgid "Unescape a backslash-escaped string *s*. *s* must not be ``NULL``. *len* must be the size of *s*."
msgstr "رشته‌ی خنثی‌شده با بک‌اسلش *s* را بازگشایی (unescape) کنید. *s* نباید ``NULL`` باشد. *len* باید اندازه‌ی *s* باشد."

msgid "*errors* must be one of ``\"strict\"``, ``\"replace\"``, or ``\"ignore\"``. If *errors* is ``NULL``, then ``\"strict\"`` is used by default."
msgstr "*errors* باید یکی از ``\"strict\"``، ``\"replace\"`` یا ``\"ignore\"`` باشد. اگر *errors* برابر ``NULL`` باشد، به‌طور پیش‌فرض از ``\"strict\"`` استفاده می‌شود."

msgid "On success, this function returns a :term:`strong reference` to a Python :class:`bytes` object containing the unescaped string. On failure, this function returns ``NULL`` with an exception set."
msgstr "در صورت موفقیت، این تابع یک :term:`ارجاع قوی <strong reference>` به یک شیء :class:`bytes` پایتونی حاوی رشته‌ی گریز‌زدایی‌شده (unescaped) را برمی‌گرداند. در صورت شکست، این تابع ``NULL`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند."

msgid "*unicode* and *recode_encoding* are now unused."
msgstr "*unicode* و *recode_encoding* اکنون استفاده نمی‌شوند."

msgid "object"
msgstr "شیء"

msgid "bytes"
msgstr "bytes"