对象协议¶
-
Py_RETURN_NOTIMPLEMENTED¶ C 函数内部应正确处理
Py_NotImplemented的返回过程（即增加 NotImplemented 的引用计数并返回之）。
-
int
PyObject_Print(PyObject *o, FILE *fp, int flags)¶ 将对象 o 写入到文件 fp。 出错时返回
-1。 旗标参数被用于启用特定的输出选项。 目前唯一支持的选项是Py_PRINT_RAW；如果给出该选项，则将写入对象的str()而不是repr()。
-
int
PyObject_HasAttr(PyObject *o, PyObject *attr_name)¶ 如果 o 带有属性 attr_name，则返回
1，否则返回0。这相当于 Python 表达式hasattr(o, attr_name)。 此函数总是成功。注意，在调用
__getattr__()和__getattribute__()方法时发生的异常将被抑制。若要获得错误报告，请换用PyObject_GetAttr()。
-
int
PyObject_HasAttrString(PyObject *o, const char *attr_name)¶ 如果 o 带有属性 attr_name，则返回
1，否则返回0。这相当于 Python 表达式hasattr(o, attr_name)。 此函数总是成功。注意，在调用
__getattr__()和__getattribute__()方法并创建一个临时字符串对象时，异常将被抑制。若要获得错误报告，请换用PyObject_GetAttrString()。
-
PyObject*
PyObject_GetAttr(PyObject *o, PyObject *attr_name)¶ - Return value: New reference.
从对象 o 中读取名为 attr_name 的属性。成功返回属性值，失败则返回
NULL。 这相当于 Python 表达式o.attr_name。
-
PyObject*
PyObject_GetAttrString(PyObject *o, const char *attr_name)¶ - Return value: New reference.
从对象 o 中读取一个名为 attr_name 的属性。成功时返回属性值，失败则返回
NULL。这相当于 Python 表达式o.attr_name。
-
PyObject*
PyObject_GenericGetAttr(PyObject *o, PyObject *name)¶ - Return value: New reference.
通用的属性获取函数，用于放入类型对象的
tp_getattro槽中。它在类的字典中（位于对象的 MRO 中）查找某个描述符，并在对象的__dict__中查找某个属性。正如 实现描述器 所述，数据描述符优先于实例属性，而非数据描述符则不优先。失败则会触发AttributeError。
-
int
PyObject_SetAttr(PyObject *o, PyObject *attr_name, PyObject *v)¶ 将对象 o 中名为 attr_name 的属性值设为 v 。失败时引发异常并返回
-1；成功时返 回0。这相当于 Python 语句o.attr_name = v。如果 v 为
NULL，该属性将被删除。 此行为已被弃用而应改用PyObject_DelAttr()，但目前还没有移除它的计划。
-
int
PyObject_SetAttrString(PyObject *o, const char *attr_name, PyObject *v)¶ 将对象 o 中名为 attr_name 的属性值设为 v 。失败时引发异常并返回
-1；成功时返 回0。这相当于 Python 语句o.attr_name = v。如果 v 为
NULL，该属性将被删除，但是此功能已被弃用而应改用PyObject_DelAttrString()。
-
int
PyObject_GenericSetAttr(PyObject *o, PyObject *name, PyObject *value)¶ 通用的属性设置和删除函数，用于放入类型对象的
tp_setattro槽。它在类的字典中（位于对象的MRO中）查找数据描述器，如果找到，则将比在实例字典中设置或删除属性优先执行。否则，该属性将在对象的__dict__中设置或删除。如果成功将返回0，否则将引发AttributeError并返回-1。
-
int
PyObject_DelAttr(PyObject *o, PyObject *attr_name)¶ 删除对象 o 中名为 attr_name 的属性。失败时返回
-1。这相当于 Python 语句del o.attr_name。
-
int
PyObject_DelAttrString(PyObject *o, const char *attr_name)¶ 删除对象 o 中名为 attr_name 的属性。失败时返回
-1。这相当于 Python 语句del o.attr_name。
-
PyObject*
PyObject_GenericGetDict(PyObject *o, void *context)¶ - Return value: New reference.
__dict__描述符的获取函数的一种通用实现。必要时会创建该字典。3.3 新版功能.
-
int
PyObject_GenericSetDict(PyObject *o, PyObject *value, void *context)¶ __dict__描述符设置函数的一种通用实现。这里不允许删除该字典。3.3 新版功能.
-
PyObject*
PyObject_RichCompare(PyObject *o1, PyObject *o2, int opid)¶ - Return value: New reference.
用 opid 指定的操作比较 o1 和 o2 的值，必须是
Py_LT、Py_LE、Py_EQ、Py_NE、Py_GT或Py_GE之一，分别对应于``<、``<=、==、!=、>或>=。这相当于 Python 表达式o1 op o2，其中op是对应于 opid 的操作符。成功时返回比较值，失败时返回NULL。
-
int
PyObject_RichCompareBool(PyObject *o1, PyObject *o2, int opid)¶ 用 opid 指定的操作比较 o1 和 o2 的值，必须是
Py_LT、Py_LE、Py_EQ、Py_NE、Py_GT或Py_GE之一，分别对应于<、<=、==、!=、>或>=。错误时返回-1，若结果为 false 则返回0，否则返回1。这相当于 Python 表达式o1 op o2，其中op是对应于 opid 的操作符。
注解
如果 o1 和 o2 是同一个对象，PyObject_RichCompareBool() 为 Py_EQ 则返回 1 ，为 Py_NE 则返回 0。
-
PyObject*
PyObject_Repr(PyObject *o)¶ - Return value: New reference.
计算对象 o 的字符串形式。 成功时返回字符串，失败时返回
NULL。 这相当于 Python 表达式repr(o)。 由内置函数repr()调用。在 3.4 版更改: 该函数现在包含一个调试断言，用以确保不会静默地丢弃活动的异常。
-
PyObject*
PyObject_ASCII(PyObject *o)¶ - Return value: New reference.
与
PyObject_Repr()一样，计算对象 o 的字符串形式，但在PyObject_Repr()返回的字符串中用\x、\u或\U转义非 ASCII 字符。这将生成一个类似于 Python 2 中由PyObject_Repr()返回的字符串。由内置函数ascii()调用。
-
PyObject*
PyObject_Str(PyObject *o)¶ - Return value: New reference.
计算对象 o 的字符串形式。 成功时返回字符串，失败时返回
NULL。 这相当于 Python 表达式str(o)。由内置函数str()调用，因此也由print()函数调用。在 3.4 版更改: 该函数现在包含一个调试断言，用以确保不会静默地丢弃活动的异常。
-
PyObject*
PyObject_Bytes(PyObject *o)¶ - Return value: New reference.
计算对象 o 的字节形式。失败时返回
NULL，成功时返回一个字节串对象。这相当于 o 不是整数时的 Python 表达式bytes(o)。与bytes(o)不同的是，当 o 是整数而不是初始为 0 的字节串对象时，会触发 TypeError。
-
int
PyObject_IsSubclass(PyObject *derived, PyObject *cls)¶ 如果 derived 类与 cls 类相同或为其派生类，则返回
1，否则返回0。 如果出错则返回-1。如果 cls 是元组，则会对 cls 进行逐项检测。如果至少有一次检测返回
1，结果将为1，否则将是0。正如 PEP 3119 所述，如果 cls 带有
__subclasscheck__()方法，将会被调用以确定子类的状态。 否则，如果 derived 是个直接或间接子类，即包含在cls.__mro__中，那么它就是 cls 的一个子类。通常只有类对象才会被视为类，即
type或派生类的实例。然而，对象可以通过拥有__bases__属性（必须是基类的元组）来覆盖这一点。
-
int
PyObject_IsInstance(PyObject *inst, PyObject *cls)¶ 如果 inst 是 cls 类或其子类的实例，则返回
1，如果不是则返回0。 如果出错则返回-1并设置一个异常。如果 cls 是元组，则会对 cls 进行逐项检测。如果至少有一次检测返回
1，结果将为1，否则将是0。正如 PEP 3119 所述，如果 cls 带有
__subclasscheck__()方法，将会被调用以确定子类的状态。 否则，如果 derived 是 cls 的子类，那么它就是 cls 的一个实例。实例 inst 可以通过
__class__属性来覆盖其所属类。对象 cls 是否被认作类，以及基类是什么，均可通过
__bases__属性（必须是基类的元组）进行覆盖。
-
Py_hash_t
PyObject_Hash(PyObject *o)¶ 计算并返回对象的哈希值 o。 失败时返回
-1。这相当于 Python 表达式hash(o)。在 3.2 版更改: 现在的返回类型是 Py_hash_t。 这是一个大小与
Py_ssize_t相同的有符号整数。
-
Py_hash_t
PyObject_HashNotImplemented(PyObject *o)¶ 设置一个
TypeError表示type(o)是不可哈希的，并返回-1。该函数保存在tp_hash槽中时会受到特别对待，允许某个类型向解释器显式表明它不可散列。
-
int
PyObject_IsTrue(PyObject *o)¶ 如果对象 o 被认为是 true，则返回
1，否则返回0。这相当于 Python 表达式not not o。 失败则返回-1。
-
PyObject*
PyObject_Type(PyObject *o)¶ - Return value: New reference.
当 o 不为
NULL时，返回一个与对象 o 的类型相对应的类型对象。 当失败时，将引发SystemError并返回NULL。 这等同于 Python 表达式type(o)。 该函数会增加返回值的引用计数。 实际上没有理由不去用普通的表达式Py_TYPE()函数而使用该函数，它将返回一个PyTypeObject*类型的指针，除非是需要增强引用计数的时候。
-
int
PyObject_TypeCheck(PyObject *o, PyTypeObject *type)¶ 如果对象 o 为 type 类型或 type 的子类型则返回真值。 两个参数都必须非
NULL。
-
Py_ssize_t
PyObject_Size(PyObject *o)¶ -
Py_ssize_t
PyObject_Length(PyObject *o)¶ 返回对象 o 的长度。 如果对象 o 支持序列和映射协议，则返回序列长度。 出错时返回
-1。这等同于 Python 表达式len(o)。
-
Py_ssize_t
PyObject_LengthHint(PyObject *o, Py_ssize_t defaultvalue)¶ 返回对象 o 的估计长度。首先尝试返回实际长度，然后用
__length_hint__()进行估计，最后返回默认值。出错时返回-1。这等同于 Python 表达式operator.length_hint(o, defaultvalue)。3.4 新版功能.
-
PyObject*
PyObject_GetItem(PyObject *o, PyObject *key)¶ - Return value: New reference.
返回对象 key 对应的 o 元素，或在失败时返回
NULL。这等同于 Python 表达式o[key]。
-
int
PyObject_SetItem(PyObject *o, PyObject *key, PyObject *v)¶ 将对象 key 映射到值 v。 失败时引发异常并返回
-1；成功时返回0。 这相当于 Python 语句o[key] = v。该函数 不会 偷取 v 的引用计数。
-
int
PyObject_DelItem(PyObject *o, PyObject *key)¶ 从对象 o 中移除对象 key 的映射。失败时返回
-1。 这相当于 Python 语句del o[key]。
-
PyObject*
PyObject_Dir(PyObject *o)¶ - Return value: New reference.
相当于 Python 表达式
dir(o)，返回一个（可能为空）适合对象参数的字符串列表，如果出错则返回NULL。 如果参数为NULL，类似 Python 的dir()，则返回当前 locals 的名字；这时如果没有活动的执行框架，则返回NULL，但PyErr_Occurred()将返回 false。