slice.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:
# Revisto <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2021-06-28 00:50+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/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"

msgid "Slice Objects"
msgstr "اشیاء اسلایس"

msgid "The type object for slice objects.  This is the same as :class:`slice` in the Python layer."
msgstr "شیء نوع برای اشیاء اسلایس. این همان :class:`slice` در لایه‌ی پایتون است."

msgid "Return true if *ob* is a slice object; *ob* must not be ``NULL``.  This function always succeeds."
msgstr "اگر *ob* یک شیء اسلایس باشد، مقدار درست را برمی‌گرداند؛ *ob* نباید ``NULL`` باشد. این تابع همیشه با موفقیت انجام می‌شود."

msgid "Return a new slice object with the given values.  The *start*, *stop*, and *step* parameters are used as the values of the slice object attributes of the same names.  Any of the values may be ``NULL``, in which case the ``None`` will be used for the corresponding attribute."
msgstr "یک شیء اسلایس جدید با مقادیر داده‌شده برمی‌گرداند. پارامترهای *start*، *stop* و *step* به‌عنوان مقادیر ویژگی‌های هم‌نام شیء اسلایس استفاده می‌شوند. هر یک از مقادیر می‌تواند ``NULL`` باشد، که در این صورت ``None`` برای ویژگی مربوطه استفاده خواهد شد."

msgid "Return ``NULL`` with an exception set if the new object could not be allocated."
msgstr "اگر نتوان شیء جدید را تخصیص داد، ``NULL`` به‌همراه یک استثنا تنظیم‌شده بازگردانید."

msgid "Retrieve the start, stop and step indices from the slice object *slice*, assuming a sequence of length *length*. Treats indices greater than *length* as errors."
msgstr "اندیس‌های شروع، توقف و گام را از شیء اسلایس *slice*، با فرض دنباله‌ای به طول *length*، بازیابی می‌کند. اندیس‌های بزرگ‌تر از *length* را به‌عنوان خطا در نظر می‌گیرد."

msgid "Returns ``0`` on success and ``-1`` on error with no exception set (unless one of the indices was not ``None`` and failed to be converted to an integer, in which case ``-1`` is returned with an exception set)."
msgstr "در صورت موفقیت ``0`` و در صورت خطا ``-1`` را بدون تنظیم استثنا برمی‌گرداند (مگر آنکه یکی از اندیس‌ها ``None`` نباشد و نتوان آن را به عدد صحیح تبدیل کرد، که در این حالت ``-1`` همراه با استثنای تنظیم‌شده برگردانده می‌شود)."

msgid "You probably do not want to use this function."
msgstr "احتمالاً نمی‌خواهید از این تابع استفاده کنید."

msgid "The parameter type for the *slice* parameter was ``PySliceObject*`` before."
msgstr "نوع پارامتر *slice* قبلاً ``PySliceObject*`` بود."

msgid "Usable replacement for :c:func:`PySlice_GetIndices`.  Retrieve the start, stop, and step indices from the slice object *slice* assuming a sequence of length *length*, and store the length of the slice in *slicelength*.  Out of bounds indices are clipped in a manner consistent with the handling of normal slices."
msgstr "جایگزین قابل استفاده برای :c:func:`PySlice_GetIndices`. اندیس‌های شروع، توقف و گام را از شیء اسلایس *slice* با فرض دنباله‌ای به طول *length* بازیابی می‌کند و طول اسلایس را در *slicelength* ذخیره می‌کند. اندیس‌های خارج از محدوده به شکلی سازگار با نحوه‌ی برخورد با اسلایس‌های معمولی محدود می‌شوند."

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

msgid "This function is considered not safe for resizable sequences. Its invocation should be replaced by a combination of :c:func:`PySlice_Unpack` and :c:func:`PySlice_AdjustIndices` where ::"
msgstr "این تابع برای دنباله‌های با اندازه‌ی قابل تغییر، ایمن در نظر گرفته نمی‌شود. فراخوانی آن باید با ترکیبی از :c:func:`PySlice_Unpack` و :c:func:`PySlice_AdjustIndices` جایگزین شود که در آن ::"

msgid ""
"if (PySlice_GetIndicesEx(slice, length, &start, &stop, &step, &slicelength) < 0) {\n"
"    // return error\n"
"}"
msgstr ""
"if (PySlice_GetIndicesEx(slice, length, &start, &stop, &step, &slicelength) < 0) {\n"
"    // return error\n"
"}"

msgid "is replaced by ::"
msgstr "جایگزین می‌شود با ::"

msgid ""
"if (PySlice_Unpack(slice, &start, &stop, &step) < 0) {\n"
"    // return error\n"
"}\n"
"slicelength = PySlice_AdjustIndices(length, &start, &stop, step);"
msgstr ""
"if (PySlice_Unpack(slice, &start, &stop, &step) < 0) {\n"
"    // return error\n"
"}\n"
"slicelength = PySlice_AdjustIndices(length, &start, &stop, step);"

msgid "If ``Py_LIMITED_API`` is not set or set to the value between ``0x03050400`` and ``0x03060000`` (not including) or ``0x03060100`` or higher :c:func:`!PySlice_GetIndicesEx` is implemented as a macro using :c:func:`!PySlice_Unpack` and :c:func:`!PySlice_AdjustIndices`. Arguments *start*, *stop* and *step* are evaluated more than once."
msgstr "اگر ``Py_LIMITED_API`` تنظیم نشده باشد یا روی مقداری بین ``0x03050400`` و ``0x03060000`` (شامل نمی‌شود) یا ``0x03060100`` یا بالاتر تنظیم شده باشد، :c:func:`!PySlice_GetIndicesEx` به‌صورت یک ماکرو با استفاده از :c:func:`!PySlice_Unpack` و :c:func:`!PySlice_AdjustIndices` پیاده‌سازی شده است. آرگومان‌های *start*، *stop* و *step* بیش از یک بار ارزیابی می‌شوند."

msgid "If ``Py_LIMITED_API`` is set to the value less than ``0x03050400`` or between ``0x03060000`` and ``0x03060100`` (not including) :c:func:`!PySlice_GetIndicesEx` is a deprecated function."
msgstr "اگر ``Py_LIMITED_API`` به مقداری کمتر از ``0x03050400`` یا به مقداری بین ``0x03060000`` و ``0x03060100`` (شامل نمی‌شود) تنظیم‌شده باشد، :c:func:`!PySlice_GetIndicesEx` تابعی منسوخ است."

msgid "Extract the start, stop and step data members from a slice object as C integers.  Silently reduce values larger than ``PY_SSIZE_T_MAX`` to ``PY_SSIZE_T_MAX``, silently boost the start and stop values less than ``PY_SSIZE_T_MIN`` to ``PY_SSIZE_T_MIN``, and silently boost the step values less than ``-PY_SSIZE_T_MAX`` to ``-PY_SSIZE_T_MAX``."
msgstr "اعضای داده‌ی آغاز، پایان و گام را از یک شیء اسلایس به‌صورت اعداد صحیح C استخراج می‌کند. مقادیر بزرگ‌تر از ``PY_SSIZE_T_MAX`` را بی‌صدا به ``PY_SSIZE_T_MAX`` کاهش می‌دهد، مقادیر کمتر از ``PY_SSIZE_T_MIN`` برای آغاز و پایان را بی‌صدا به ``PY_SSIZE_T_MIN`` افزایش می‌دهد و مقادیر کمتر از ``-PY_SSIZE_T_MAX`` برای گام را بی‌صدا به ``-PY_SSIZE_T_MAX`` افزایش می‌دهد."

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

msgid "Adjust start/end slice indices assuming a sequence of the specified length. Out of bounds indices are clipped in a manner consistent with the handling of normal slices."
msgstr "اندیس‌های شروع/پایان اسلایس را با فرض دنباله‌ای به طول مشخص‌شده تنظیم می‌کند. اندیس‌های خارج از محدوده به شکلی سازگار با نحوه‌ی برخورد با اسلایس‌های معمولی محدود می‌شوند."

msgid "Return the length of the slice.  Always successful.  Doesn't call Python code."
msgstr "طول اسلایس را برمی‌گرداند.  همیشه موفق است.  کد پایتون را فراخوانی نمی‌کند."

msgid "Ellipsis Object"
msgstr "شیء Ellipsis"

msgid "The type of Python :const:`Ellipsis` object.  Same as :class:`types.EllipsisType` in the Python layer."
msgstr "نوع شیء :const:`Ellipsis` پایتون.  همانند :class:`types.EllipsisType` در لایه‌ی پایتون است."

msgid "The Python ``Ellipsis`` object.  This object has no methods.  Like :c:data:`Py_None`, it is an :term:`immortal` singleton object."
msgstr "شیء ``Ellipsis`` پایتون. این شیء هیچ متدی ندارد. مانند :c:data:`Py_None`، این یک شیء تک‌نمونه‌ی :term:`نامیرا <immortal>` است."

msgid ":c:data:`Py_Ellipsis` is immortal."
msgstr ":c:data:`Py_Ellipsis` نامیرا است."