mapping.md

1> **Источник:** https://python-all.ru/3.5/c-api/mapping.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Протокол отображения89#### `int PyMapping_Check(PyObject *o)`1011Возвращает `1`, если объект поддерживает протокол отображения, и `0` в противном случае. Эта функция всегда завершается успешно.1213#### `Py_ssize_t PyMapping_Size(PyObject *o)`1415#### `Py_ssize_t PyMapping_Length(PyObject *o)`1617Возвращает количество ключей в объекте *o* при успехе и `-1` при неудаче. Для объектов, не поддерживающих протокол отображения, это эквивалентно выражению Python `len(o)`.1819#### `int PyMapping_DelItemString(PyObject *o, const char *key)`2021Удаляет отображение для объекта *key* из объекта *o*. Возвращает `-1` при неудаче. Это эквивалентно оператору Python `del o[key]`.2223#### `int PyMapping_DelItem(PyObject *o, PyObject *key)`2425Удаляет отображение для объекта *key* из объекта *o*. Возвращает `-1` при неудаче. Это эквивалентно оператору Python `del o[key]`.2627#### `int PyMapping_HasKeyString(PyObject *o, const char *key)`2829При успехе возвращает `1`, если объект отображения содержит ключ *key*, и `0` в противном случае. Это эквивалентно выражению Python `key in o`. Эта функция всегда завершается успешно.3031#### `int PyMapping_HasKey(PyObject *o, PyObject *key)`3233Возвращает `1`, если объект отображения содержит ключ *key*, и `0` в противном случае. Это эквивалентно выражению Python `key in o`. Эта функция всегда завершается успешно.3435#### `PyObject* PyMapping_Keys(PyObject *o)`3637*Возвращаемое значение: новая ссылка.*3839При успехе возвращает список или кортеж ключей объекта *o*. При ошибке возвращает *NULL*.4041#### `PyObject* PyMapping_Values(PyObject *o)`4243*Возвращаемое значение: новая ссылка.*4445При успехе возвращает список или кортеж значений объекта *o*. При ошибке возвращает *NULL*.4647#### `PyObject* PyMapping_Items(PyObject *o)`4849*Возвращаемое значение: новая ссылка.*5051При успехе возвращает список или кортеж элементов объекта *o*, где каждый элемент является кортежем, содержащим пару ключ-значение. При ошибке возвращает *NULL*.5253#### `PyObject* PyMapping_GetItemString(PyObject *o, const char *key)`5455*Возвращаемое значение: новая ссылка.*5657Возвращает элемент *o*, соответствующий объекту *key*, или *NULL* при неудаче. Это эквивалент выражения Python `o[key]`.5859#### `int PyMapping_SetItemString(PyObject *o, const char *key, PyObject *v)`6061Отображает объект *key* на значение *v* в объекте *o*. Возвращает `-1` при неудаче. Это эквивалентно оператору Python `o[key] = v`.62