python-docs-fa/c-api/list.po at add-scripts-and-ci · python/python-docs-fa

261 lines (223 loc) · 8.17 KB
# 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
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-07-25 12:59+0330\n"
"PO-Revision-Date: 2021-06-28 00:49+0000\n"
"Last-Translator: Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025\n"
"Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/"
"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"
#: ../../c-api/list.rst:6
msgid "List Objects"
#: ../../c-api/list.rst:13
msgid "This subtype of :c:type:`PyObject` represents a Python list object."
#: ../../c-api/list.rst:18
"This instance of :c:type:`PyTypeObject` represents the Python list type. "
"This is the same object as :class:`list` in the Python layer."
#: ../../c-api/list.rst:24
"Return true if *p* is a list object or an instance of a subtype of the list "
"type.  This function always succeeds."
#: ../../c-api/list.rst:30
"Return true if *p* is a list object, but not an instance of a subtype of the "
"list type.  This function always succeeds."
#: ../../c-api/list.rst:36
msgid "Return a new list of length *len* on success, or ``NULL`` on failure."
#: ../../c-api/list.rst:40
"If *len* is greater than zero, the returned list object's items are set to "
"``NULL``. Thus you cannot use abstract API functions such "
"as :c:func:`PySequence_SetItem` or expose the object to Python code before "
"setting all items to a real object with :c:func:`PyList_SetItem` "
"or :c:func:`PyList_SET_ITEM()`. The following APIs are safe APIs before the "
"list is fully initialized: :c:func:`PyList_SetItem()` "
"and :c:func:`PyList_SET_ITEM()`."
#: ../../c-api/list.rst:53
"Return the length of the list object in *list*; this is equivalent to "
"``len(list)`` on a list object."
#: ../../c-api/list.rst:59
msgid "Similar to :c:func:`PyList_Size`, but without error checking."
#: ../../c-api/list.rst:64
"Return the object at position *index* in the list pointed to by *list*.  The "
"position must be non-negative; indexing from the end of the list is not "
"supported.  If *index* is out of bounds (:code:`<0 or >=len(list)`), return "
"``NULL`` and set an :exc:`IndexError` exception."
#: ../../c-api/list.rst:74
"Like :c:func:`PyList_GetItemRef`, but returns a :term:`borrowed reference` "
"instead of a :term:`strong reference`."
#: ../../c-api/list.rst:79 ../../c-api/list.rst:91
"In the :term:`free-threaded build`, the returned :term:`borrowed reference` "
"may become invalid if another thread modifies the list concurrently. "
"Prefer :c:func:`PyList_GetItemRef`, which returns a :term:`strong reference`."
#: ../../c-api/list.rst:87
msgid "Similar to :c:func:`PyList_GetItem`, but without error checking."
#: ../../c-api/list.rst:99
"Set the item at index *index* in list to *item*.  Return ``0`` on success. "
"If *index* is out of bounds, return ``-1`` and set an :exc:`IndexError` "
"exception."
#: ../../c-api/list.rst:105
"This function \"steals\" a reference to *item* and discards a reference to "
"an item already in the list at the affected position."
#: ../../c-api/list.rst:111
"Macro form of :c:func:`PyList_SetItem` without error checking. This is "
"normally only used to fill in new lists where there is no previous content."
#: ../../c-api/list.rst:114
"Bounds checking is performed as an assertion if Python is built "
"in :ref:`debug mode <debug-build>` or :option:`with assertions <--with-"
"assertions>`."
#: ../../c-api/list.rst:120
"This macro \"steals\" a reference to *item*, and, "
"unlike :c:func:`PyList_SetItem`, does *not* discard a reference to any item "
"that is being replaced; any reference in *list* at position *i* will be "
#: ../../c-api/list.rst:127
"In the :term:`free-threaded build`, this macro has no internal "
"synchronization. It is normally only used to fill in new lists where no "
"other thread has a reference to the list. If the list may be shared, "
"use :c:func:`PyList_SetItem` instead, which uses a :term:`per-object lock`."
#: ../../c-api/list.rst:136
"Insert the item *item* into list *list* in front of index *index*.  Return "
"``0`` if successful; return ``-1`` and set an exception if unsuccessful. "
"Analogous to ``list.insert(index, item)``."
#: ../../c-api/list.rst:143
"Append the object *item* at the end of list *list*. Return ``0`` if "
"successful; return ``-1`` and set an exception if unsuccessful.  Analogous "
"to ``list.append(item)``."
#: ../../c-api/list.rst:150
"Return a list of the objects in *list* containing the objects *between* "
"*low* and *high*.  Return ``NULL`` and set an exception if unsuccessful.  "
"Analogous to ``list[low:high]``.  Indexing from the end of the list is not "
"supported."
#: ../../c-api/list.rst:157
"Set the slice of *list* between *low* and *high* to the contents of "
"*itemlist*.  Analogous to ``list[low:high] = itemlist``. The *itemlist* may "
"be ``NULL``, indicating the assignment of an empty list (slice deletion). "
"Return ``0`` on success, ``-1`` on failure.  Indexing from the end of the "
"list is not supported."
#: ../../c-api/list.rst:165
"In the :term:`free-threaded build`, when *itemlist* is a :class:`list`, both "
"*list* and *itemlist* are locked for the duration of the operation. For "
"other iterables (or ``NULL``), only *list* is locked."
#: ../../c-api/list.rst:172
"Extend *list* with the contents of *iterable*.  This is the same as "
"``PyList_SetSlice(list, PY_SSIZE_T_MAX, PY_SSIZE_T_MAX, iterable)`` and "
"analogous to ``list.extend(iterable)`` or ``list += iterable``."
#: ../../c-api/list.rst:176
"Raise an exception and return ``-1`` if *list* is not a :class:`list` "
"object. Return 0 on success."
#: ../../c-api/list.rst:183
"In the :term:`free-threaded build`, when *iterable* is "
"a :class:`list`, :class:`set`, :class:`dict`, or dict view, both *list* and "
"*iterable* (or its underlying dict) are locked for the duration of the "
"operation. For other iterables, only *list* is locked; *iterable* may be "
"concurrently modified by another thread."
#: ../../c-api/list.rst:192
"Remove all items from *list*.  This is the same as ``PyList_SetSlice(list, "
"0, PY_SSIZE_T_MAX, NULL)`` and analogous to ``list.clear()`` or ``del "
"list[:]``."
#: ../../c-api/list.rst:196
"Raise an exception and return ``-1`` if *list* is not a :class:`list` "
"object.  Return 0 on success."
#: ../../c-api/list.rst:204
"Sort the items of *list* in place.  Return ``0`` on success, ``-1`` on "
"failure.  This is equivalent to ``list.sort()``."
#: ../../c-api/list.rst:209
"In the :term:`free-threaded build`, element comparison "
"via :meth:`~object.__lt__` can execute arbitrary Python code, during which "
"the :term:`per-object lock` may be temporarily released. For built-in types "
"(:class:`str`, :class:`int`, :class:`float`), the lock is not released "
"during comparison."
#: ../../c-api/list.rst:218
"Reverse the items of *list* in place.  Return ``0`` on success, ``-1`` on "
"failure.  This is the equivalent of ``list.reverse()``."
#: ../../c-api/list.rst:226
"Return a new tuple object containing the contents of *list*; equivalent to "
"``tuple(list)``."
#: ../../c-api/list.rst:8
msgid "object"
#: ../../c-api/list.rst:8
msgid "list"
#: ../../c-api/list.rst:51 ../../c-api/list.rst:224
msgid "built-in function"
#: ../../c-api/list.rst:51
msgid "len"
#: ../../c-api/list.rst:224
msgid "tuple"
Navigation Menu

Uh oh!

Uh oh!

FilesExpand file tree

list.po

Latest commit

History

list.po

File metadata and controls
