iter.po

# Copyright (C) 2001-2020, Python Software Foundation
# This file is distributed under the same license as the Python package.
# Maintained by the python-doc-es workteam.
# docs-es@python.org /
# https://mail.python.org/mailman3/lists/docs-es.python.org/
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
# get the list of volunteers
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-02-26 18:44-0300\n"
"PO-Revision-Date: 2025-04-10 23:48+0200\n"
"Last-Translator: Mariana Garcia\n"
"Language: es\n"
"Language-Team: python-doc-es\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: ../Doc/c-api/iter.rst:6
msgid "Iterator Protocol"
msgstr "Protocolo iterador"

#: ../Doc/c-api/iter.rst:8
msgid "There are two functions specifically for working with iterators."
msgstr "Hay dos funciones específicas para trabajar con iteradores."

#: ../Doc/c-api/iter.rst:12
#, fuzzy
msgid ""
"Return non-zero if the object *o* can be safely passed to :c:func:"
"`PyIter_NextItem` and ``0`` otherwise. This function always succeeds."
msgstr ""
"Retorna un valor distinto de cero si el objeto *o* puede pasarse de manera "
"segura a :c:func:`PyIter_Next`, y ``0`` en caso contrario. Esta función "
"siempre tiene éxito."

#: ../Doc/c-api/iter.rst:18
msgid ""
"Return non-zero if the object *o* provides the :class:`AsyncIterator` "
"protocol, and ``0`` otherwise.  This function always succeeds."
msgstr ""
"Retorna un valor distinto de cero si el objeto *o* proporciona el protocolo :"
"class:`AsyncIterator`, y ``0`` en caso contrario. Esta función siempre tiene "
"éxito."

#: ../Doc/c-api/iter.rst:25
msgid ""
"Return ``1`` and set *item* to a :term:`strong reference` of the next value "
"of the iterator *iter* on success. Return ``0`` and set *item* to ``NULL`` "
"if there are no remaining values. Return ``-1``, set *item* to ``NULL`` and "
"set an exception on error."
msgstr ""
"Retorna ``1`` y establece *item* en una :term:`referencia fuerte` del siguiente "
"valor del iterador *iter* en caso de éxito. Retorna ``0`` y establece *item* en ``NULL`` "
"si no hay valores restantes. Retorna ``-1``, establece *item* en ``NULL`` y "
"establece una excepción en caso de error."

#: ../Doc/c-api/iter.rst:34
msgid ""
"This is an older version of :c:func:`!PyIter_NextItem`, which is retained "
"for backwards compatibility. Prefer :c:func:`PyIter_NextItem`."
msgstr ""
"Esta es una versión anterior de :c:func:`!PyIter_NextItem`, que se mantiene "
"para compatibilidad hacia atrás. Prefiere :c:func:`PyIter_NextItem`."

#: ../Doc/c-api/iter.rst:38
msgid ""
"Return the next value from the iterator *o*.  The object must be an iterator "
"according to :c:func:`PyIter_Check` (it is up to the caller to check this). "
"If there are no remaining values, returns ``NULL`` with no exception set. If "
"an error occurs while retrieving the item, returns ``NULL`` and passes along "
"the exception."
msgstr ""
"Retorna el siguiente valor del iterador *o*. El objeto debe ser un iterador "
"según :c:func:`PyIter_Check` (depende del llamador verificar esto). Si no "
"hay valores restantes, retorna ``NULL`` sin establecer una excepción. Si "
"ocurre un error al recuperar el elemento, devuelve ``NULL`` y envía la "
"excepción."

#: ../Doc/c-api/iter.rst:46
msgid ""
"The enum value used to represent different results of :c:func:`PyIter_Send`."
msgstr ""
"El valor de enumeración utilizado para representar diferentes resultados de :"
"c:func:`PyIter_Send`."

#: ../Doc/c-api/iter.rst:53
msgid "Sends the *arg* value into the iterator *iter*. Returns:"
msgstr "Envía el valor *arg* al iterador *iter*. Retorna:"

#: ../Doc/c-api/iter.rst:55
msgid ""
"``PYGEN_RETURN`` if iterator returns. Return value is returned via *presult*."
msgstr ""
"``PYGEN_RETURN`` si el iterador regresa. El valor de retorno se retorna a "
"través de *presult*."

#: ../Doc/c-api/iter.rst:56
msgid ""
"``PYGEN_NEXT`` if iterator yields. Yielded value is returned via *presult*."
msgstr ""
"``PYGEN_NEXT`` si el iterador cede. El valor cedido se retorna a través de "
"*presult*."

#: ../Doc/c-api/iter.rst:57
msgid ""
"``PYGEN_ERROR`` if iterator has raised and exception. *presult* is set to "
"``NULL``."
msgstr ""
"``PYGEN_ERROR`` si el iterador ha lanzado una excepción. *presult* se "
"establece en ``NULL``."

#~ msgid ""
#~ "To write a loop which iterates over an iterator, the C code should look "
#~ "something like this::"
#~ msgstr ""
#~ "Para escribir un bucle que itera sobre un iterador, el código en C "
#~ "debería verse así::"

#~ msgid ""
#~ "PyObject *iterator = PyObject_GetIter(obj);\n"
#~ "PyObject *item;\n"
#~ "\n"
#~ "if (iterator == NULL) {\n"
#~ "    /* propagate error */\n"
#~ "}\n"
#~ "\n"
#~ "while ((item = PyIter_Next(iterator))) {\n"
#~ "    /* do something with item */\n"
#~ "    ...\n"
#~ "    /* release reference when done */\n"
#~ "    Py_DECREF(item);\n"
#~ "}\n"
#~ "\n"
#~ "Py_DECREF(iterator);\n"
#~ "\n"
#~ "if (PyErr_Occurred()) {\n"
#~ "    /* propagate error */\n"
#~ "}\n"
#~ "else {\n"
#~ "    /* continue doing useful work */\n"
#~ "}"
#~ msgstr ""
#~ "PyObject *iterator = PyObject_GetIter(obj);\n"
#~ "PyObject *item;\n"
#~ "\n"
#~ "if (iterator == NULL) {\n"
#~ "    /* propagate error */\n"
#~ "}\n"
#~ "\n"
#~ "while ((item = PyIter_Next(iterator))) {\n"
#~ "    /* do something with item */\n"
#~ "    ...\n"
#~ "    /* release reference when done */\n"
#~ "    Py_DECREF(item);\n"
#~ "}\n"
#~ "\n"
#~ "Py_DECREF(iterator);\n"
#~ "\n"
#~ "if (PyErr_Occurred()) {\n"
#~ "    /* propagate error */\n"
#~ "}\n"
#~ "else {\n"
#~ "    /* continue doing useful work */\n"
#~ "}"