매핑 프로토콜¶
PyObject_GetItem(), PyObject_SetItem() 및 PyObject_DelItem()도 참조하십시오.
-
int PyMapping_Check(PyObject *o)¶
- 상의 안정 ABI.
객체가 매핑 프로토콜을 제공하거나 슬라이싱을 지원하면
1을 반환하고, 그렇지 않으면0을 반환합니다.__getitem__()메서드가 있는 파이썬 클래스의 경우1을 반환한다는 점에 유의하십시오; 일반적으로 클래스가 지원하는 키 형을 판단할 수 없기 때문입니다. 이 함수는 항상 성공합니다.
-
Py_ssize_t PyMapping_Size(PyObject *o)¶
-
Py_ssize_t PyMapping_Length(PyObject *o)¶
- 상의 안정 ABI.
성공 시 객체 o의 키 수를 반환하고, 실패하면
-1을 반환합니다. 이는 파이썬 표현식len(o)와 동등합니다.
-
PyObject *PyMapping_GetItemString(PyObject *o, const char *key)¶
- 반환값: 새 참조. 상의 안정 ABI.
이것은
PyObject_GetItem()\와 같지만, key\가 PyObject*\가 아닌 const char* UTF-8로 인코딩된 바이트 문자열로 지정됩니다.
-
int PyMapping_GetOptionalItem(PyObject *obj, PyObject *key, PyObject **result)¶
- 상의 안정 ABI 버전 3.13 이후로.
키가 발견되지 않은 경우 :exc:`KeyError`를 발생시키지 않는 :c:func:`PyObject_GetItem`의 변형입니다.
키가 발견되면,
1을 반환하고 *result \를 해당 값에 대한 새로운 strong reference 로 설정합니다. 키가 발견되지 않으면,0을 반환하고 *result \를NULL로 설정합니다. 이때KeyError는 무시됩니다.KeyError이외의 다른 오류가 발생하면,-1을 반환하고 *result \를NULL로 설정합니다.Added in version 3.13.
-
int PyMapping_GetOptionalItemString(PyObject *obj, const char *key, PyObject **result)¶
- 상의 안정 ABI 버전 3.13 이후로.
이것은
PyMapping_GetOptionalItem()\와 같지만, key\가 PyObject*\가 아닌 const char* UTF-8로 인코딩된 바이트 문자열로 지정됩니다.Added in version 3.13.
-
int PyMapping_SetItemString(PyObject *o, const char *key, PyObject *v)¶
- 상의 안정 ABI.
이것은
PyObject_SetItem()\와 같지만, key\가 PyObject*\가 아닌 const char* UTF-8로 인코딩된 바이트 문자열로 지정됩니다.
-
int PyMapping_DelItem(PyObject *o, PyObject *key)¶
이것은
PyObject_DelItem()의 별칭입니다.
-
int PyMapping_DelItemString(PyObject *o, const char *key)¶
이것은
PyObject_DelItem()\와 같지만, key\가 PyObject*\가 아닌 const char* UTF-8로 인코딩된 바이트 문자열로 지정됩니다.
-
int PyMapping_HasKeyWithError(PyObject *o, PyObject *key)¶
- 상의 안정 ABI 버전 3.13 이후로.
매핑 객체에 key 키가 있으면
1을 반환하고, 그렇지 않으면0을 반환합니다. 이는 파이썬 표현식key in o와 동등합니다. 실패하면-1을 반환합니다.Added in version 3.13.
-
int PyMapping_HasKeyStringWithError(PyObject *o, const char *key)¶
- 상의 안정 ABI 버전 3.13 이후로.
``
PyMapping_HasKeyWithError()와 동일하지만, key 가 const char* UTF-8 인코딩 바이트 문자열로 지정되며, PyObject* 가 아닙니다.Added in version 3.13.
-
int PyMapping_HasKey(PyObject *o, PyObject *key)¶
- 상의 안정 ABI.
매핑 객체에 key 키가 있으면
1을 반환하고, 그렇지 않으면0을 반환합니다. 이는 파이썬 표현식key in o와 동등합니다. 이 함수는 항상 성공합니다.참고
이 함수가
__getitem__()메서드를 호출하는 동안 발생하는 예외는 조용히 무시됩니다. 적절한 오류 처리를 위해서는 대신PyMapping_HasKeyWithError(),PyMapping_GetOptionalItem()또는PyObject_GetItem()을 사용하십시오.
-
int PyMapping_HasKeyString(PyObject *o, const char *key)¶
- 상의 안정 ABI.
이 함수는
PyMapping_HasKey()와 동일하지만, key 가 const char* UTF-8 인코딩 바이트 문자열로 지정되며, PyObject* 가 아닙니다.참고
이 함수가
__getitem__()메서드를 호출하거나 임시str객체를 생성하는 동안 발생하는 예외는 조용히 무시됩니다. 적절한 오류 처리를 위해서는 대신PyMapping_HasKeyStringWithError(),PyMapping_GetOptionalItemString()또는PyMapping_GetItemString()을 사용하십시오.
-
PyObject *PyMapping_Keys(PyObject *o)¶
- 반환값: 새 참조. 상의 안정 ABI.
성공하면, 객체 o의 키 리스트를 반환합니다. 실패하면,
NULL을 반환합니다.버전 3.7에서 변경: 이전에는 함수가 리스트나 튜플을 반환했습니다.