对象协议 ¶

int PyObject_Print ( PyObject *o , FILE *fp , int flags ) ¶

int PyObject_HasAttr ( PyObject *o , PyObject *attr_name ) ¶

int PyObject_HasAttrString ( PyObject *o , const char *attr_name ) ¶

PyObject * PyObject_GetAttr ( PyObject *o , PyObject *attr_name ) ¶: 返回值：新引用。
Retrieve an attribute named attr_name from object o . Returns the attribute value on success, or NULL on failure. This is the equivalent of the Python expression o.attr_name .

PyObject * PyObject_GetAttrString ( PyObject *o , const char *attr_name ) ¶: 返回值：新引用。
Retrieve an attribute named attr_name from object o . Returns the attribute value on success, or NULL on failure. This is the equivalent of the Python expression o.attr_name .

PyObject * PyObject_GenericGetAttr ( PyObject *o , PyObject *name ) ¶

int PyObject_SetAttr ( PyObject *o , PyObject *attr_name , PyObject *v ) ¶

int PyObject_SetAttrString ( PyObject *o , const char *attr_name , PyObject *v ) ¶

int PyObject_GenericSetAttr ( PyObject *o , PyObject *name , PyObject *value ) ¶

int PyObject_DelAttr ( PyObject *o , PyObject *attr_name ) ¶

int PyObject_DelAttrString ( PyObject *o , const char *attr_name ) ¶

PyObject * PyObject_RichCompare ( PyObject *o1 , PyObject *o2 , int opid ) ¶: 返回值：新引用。
Compare the values of o1 and o2 using the operation specified by opid , which must be one of Py_LT , Py_LE , Py_EQ , Py_NE , Py_GT ，或 Py_GE , corresponding to < , <= , == , != , > ，或 >= respectively. This is the equivalent of the Python expression o1 op o2 ，其中 op is the operator corresponding to opid . Returns the value of the comparison on success, or NULL 当故障时。

int PyObject_RichCompareBool ( PyObject *o1 , PyObject *o2 , int opid ) ¶

注意

若 o1 and o2 are the same object, PyObject_RichCompareBool() will always return 1 for Py_EQ and 0 for Py_NE .

int PyObject_Cmp ( PyObject *o1 , PyObject *o2 , int *result ) ¶: Compare the values of o1 and o2 using a routine provided by o1 , if one exists, otherwise with a routine provided by o2 . The result of the comparison is returned in result 。返回 -1 on failure. This is the equivalent of the Python statement result = cmp(o1, o2) .

int PyObject_Compare ( PyObject *o1 , PyObject *o2 ) ¶: Compare the values of o1 and o2 using a routine provided by o1 , if one exists, otherwise with a routine provided by o2 . Returns the result of the comparison on success. On error, the value returned is undefined; use PyErr_Occurred() to detect an error. This is equivalent to the Python expression cmp(o1, o2) .

PyObject * PyObject_Repr ( PyObject *o ) ¶: 返回值：新引用。
Compute a string representation of object o . Returns the string representation on success, NULL on failure. This is the equivalent of the Python expression repr(o) . Called by the repr() built-in function and by reverse quotes.

PyObject * PyObject_Str ( PyObject *o ) ¶: 返回值：新引用。
Compute a string representation of object o . Returns the string representation on success, NULL on failure. This is the equivalent of the Python expression str(o) . Called by the str() built-in function and by the print 语句。

PyObject * PyObject_Bytes ( PyObject *o ) ¶: Compute a bytes representation of object o . In 2.x, this is just an alias for PyObject_Str() .

PyObject * PyObject_Unicode ( PyObject *o ) ¶: 返回值：新引用。
Compute a Unicode string representation of object o . Returns the Unicode string representation on success, NULL on failure. This is the equivalent of the Python expression unicode(o) . Called by the unicode() 内置函数。

int PyObject_IsInstance ( PyObject *inst , PyObject *cls ) ¶

Subclass determination is done in a fairly straightforward way, but includes a wrinkle that implementors of extensions to the class system may want to be aware of. If A and B are class objects, B 是子类化的 A if it inherits from A either directly or indirectly. If either is not a class object, a more general mechanism is used to determine the class relationship of the two objects. When testing if B 是子类化的 A ，若 A is B , PyObject_IsSubclass() returns true. If A and B are different objects, B ’s __bases__ attribute is searched in a depth-first fashion for A — the presence of the __bases__ attribute is considered sufficient for this determination.

int PyObject_IsSubclass ( PyObject *derived , PyObject *cls ) ¶

int PyCallable_Check ( PyObject *o ) ¶

PyObject * PyObject_Call ( PyObject *callable_object , PyObject *args , PyObject *kw ) ¶

返回值：新引用。

Call a callable Python object callable_object , with arguments given by the tuple args , and named arguments given by the dictionary kw . If no named arguments are needed, kw 可以是 NULL . args 不得为 NULL , use an empty tuple if no arguments are needed. Returns the result of the call on success, or NULL on failure. This is the equivalent of the Python expression apply(callable_object, args, kw) or callable_object(*args, **kw) .

2.2 版新增。

PyObject * PyObject_CallObject ( PyObject *callable_object , PyObject *args ) ¶: 返回值：新引用。
Call a callable Python object callable_object , with arguments given by the tuple args . If no arguments are needed, then args 可以是 NULL . Returns the result of the call on success, or NULL on failure. This is the equivalent of the Python expression apply(callable_object, args) or callable_object(*args) .

PyObject * PyObject_CallFunction ( PyObject *callable , char *format , ... ) ¶: 返回值：新引用。
Call a callable Python object callable , with a variable number of C arguments. The C arguments are described using a Py_BuildValue() style format string. The format may be NULL , indicating that no arguments are provided. Returns the result of the call on success, or NULL on failure. This is the equivalent of the Python expression apply(callable, args) or callable(*args) . Note that if you only pass PyObject * args, PyObject_CallFunctionObjArgs() is a faster alternative.

PyObject * PyObject_CallMethod ( PyObject *o , char *method , char *format , ... ) ¶: 返回值：新引用。
Call the method named 方法 of object o with a variable number of C arguments. The C arguments are described by a Py_BuildValue() format string that should produce a tuple. The format may be NULL , indicating that no arguments are provided. Returns the result of the call on success, or NULL on failure. This is the equivalent of the Python expression o.method(args) . Note that if you only pass PyObject * args, PyObject_CallMethodObjArgs() is a faster alternative.

PyObject * PyObject_CallFunctionObjArgs ( PyObject *callable , ..., NULL ) ¶

返回值：新引用。

Call a callable Python object callable , with a variable number of PyObject* arguments. The arguments are provided as a variable number of parameters followed by NULL . Returns the result of the call on success, or NULL 当故障时。

2.2 版新增。

PyObject * PyObject_CallMethodObjArgs ( PyObject *o , PyObject *name , ..., NULL ) ¶

返回值：新引用。

Calls a method of the object o , where the name of the method is given as a Python string object in name . It is called with a variable number of PyObject* arguments. The arguments are provided as a variable number of parameters followed by NULL . Returns the result of the call on success, or NULL 当故障时。

2.2 版新增。

long PyObject_Hash ( PyObject *o ) ¶: Compute and return the hash value of an object o . On failure, return -1 . This is the equivalent of the Python expression hash(o) .

long PyObject_HashNotImplemented ( PyObject *o ) ¶

int PyObject_IsTrue ( PyObject *o ) ¶

int PyObject_Not ( PyObject *o ) ¶

PyObject * PyObject_Type ( PyObject *o ) ¶: 返回值：新引用。
当 o 为非 NULL , returns a type object corresponding to the object type of object o . On failure, raises SystemError 并返回 NULL . This is equivalent to the Python expression type(o) . This function increments the reference count of the return value. There’s really no reason to use this function instead of the common expression o->ob_type , which returns a pointer of type PyTypeObject* , except when the incremented reference count is needed.

int PyObject_TypeCheck ( PyObject *o , PyTypeObject *type ) ¶

Py_ssize_t PyObject_Length ( PyObject *o ) ¶

Py_ssize_t PyObject_Size ( PyObject *o ) ¶

Return the length of object o . If the object o provides either the sequence and mapping protocols, the sequence length is returned. On error, -1 is returned. This is the equivalent to the Python expression len(o) .

Changed in version 2.5: These functions returned an int type. This might require changes in your code for properly supporting 64-bit systems.

PyObject * PyObject_GetItem ( PyObject *o , PyObject *key ) ¶: 返回值：新引用。
Return element of o corresponding to the object key or NULL on failure. This is the equivalent of the Python expression o[key] .

int PyObject_SetItem ( PyObject *o , PyObject *key , PyObject *v ) ¶

int PyObject_DelItem ( PyObject *o , PyObject *key ) ¶

int PyObject_AsFileDescriptor ( PyObject *o ) ¶

PyObject * PyObject_Dir ( PyObject *o ) ¶: 返回值：新引用。
This is equivalent to the Python expression dir(o) , returning a (possibly empty) list of strings appropriate for the object argument, or NULL if there was an error. If the argument is NULL , this is like the Python dir() , returning the names of the current locals; in this case, if no execution frame is active then NULL is returned but PyErr_Occurred() will return false.

PyObject * PyObject_GetIter ( PyObject *o ) ¶: 返回值：新引用。
This is equivalent to the Python expression iter(o) . It returns a new iterator for the object argument, or the object itself if the object is already an iterator. Raises TypeError 并返回 NULL if the object cannot be iterated.

对象协议 ¶

上一话题

下一话题

本页

快速搜索