اشیاء پیمایش‌گر¶

پایتون دو شیء پیمایش‌گر همه‌منظوره فراهم می‌کند. اولی یک پیمایش‌گر دنباله است که با هر دنباله دلخواهی که از متد __getitem__() پشتیبانی می‌کند کار می‌کند. دومی با یک شیء فراخوانی‌پذیر و یک مقدار نشانگر کار می‌کند؛ فراخوانی‌پذیر برای هر آیتم در دنباله فراخوانی می‌شود و پیمایش هنگامی که مقدار نشانگر بازگردانده شود پایان می‌یابد.

PyTypeObject PySeqIter_Type¶

قسمتی از ABI پایدار.

شیء نوع برای اشیاء پیمایش‌گری که توسط PySeqIter_New() و شکل تک‌آرگومانی تابع توکار iter() برای نوع‌های دنباله توکار بازگردانده می‌شوند.

int PySeqIter_Check(PyObject *op)¶

اگر نوع op برابر PySeqIter_Type باشد، مقدار true را برمی‌گرداند. این تابع همیشه با موفقیت انجام می‌شود.

PyObject *PySeqIter_New(PyObject *seq)¶

مقدار بازگشتی: مرجع جدید. قسمتی از ABI پایدار.

یک پیمایش‌گر برمی‌گرداند که با شیء دنباله‌ی عمومی، seq کار می‌کند. پیمایش زمانی پایان می‌یابد که دنباله هنگام عملیات زیرنویسی، استثنای IndexError را ایجاد کند.

PyTypeObject PyCallIter_Type¶

قسمتی از ABI پایدار.

شیء نوع برای اشیاء پیمایش‌گری که توسط PyCallIter_New() و شکل دوآرگومانی تابع توکار iter() بازگردانده می‌شوند.

int PyCallIter_Check(PyObject *op)¶

اگر نوع op برابر با PyCallIter_Type باشد، مقدار true را برمی‌گرداند. این تابع همیشه با موفقیت اجرا می‌شود.

PyObject *PyCallIter_New(PyObject *callable, PyObject *sentinel)¶

مقدار بازگشتی: مرجع جدید. قسمتی از ABI پایدار.

یک پیمایش‌گر جدید برگردانید. پارامتر اول، callable، می‌تواند هر شیء فراخوانی‌پذیر پایتونی باشد که بدون هیچ پارامتری می‌توان آن را فراخوانی کرد؛ هر فراخوانی آن باید آیتم بعدی در پیمایش را برگرداند. وقتی callable مقداری برابر با sentinel برگرداند، پیمایش خاتمه می‌یابد.