Website hosting service by Active-Venture.com
  

 Back to Index

6.3 Sequence Protocol

 
int PySequence_Check( PyObject *o)
Return 1 if the object provides sequence protocol, and 0 otherwise. This function always succeeds.
 
int PySequence_Size( PyObject *o)
Returns the number of objects in sequence o on success, and -1 on failure. For objects that do not provide sequence protocol, this is equivalent to the Python expression "len(o)".
 
int PySequence_Length( PyObject *o)
Alternate name for PySequence_Size().
 
PyObject* PySequence_Concat( PyObject *o1, PyObject *o2)
Return value: New reference.
Return the concatenation of o1 and o2 on success, and NULL on failure. This is the equivalent of the Python expression "o1 + o2".
 
PyObject* PySequence_Repeat( PyObject *o, int count)
Return value: New reference.
Return the result of repeating sequence object o count times, or NULL on failure. This is the equivalent of the Python expression "o * count".
 
PyObject* PySequence_InPlaceConcat( PyObject *o1, PyObject *o2)
Return value: New reference.
Return the concatenation of o1 and o2 on success, and NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python expression "o1 += o2".
 
PyObject* PySequence_InPlaceRepeat( PyObject *o, int count)
Return value: New reference.
Return the result of repeating sequence object o count times, or NULL on failure. The operation is done in-place when o supports it. This is the equivalent of the Python expression "o *= count".
 
PyObject* PySequence_GetItem( PyObject *o, int i)
Return value: New reference.
Return the ith element of o, or NULL on failure. This is the equivalent of the Python expression "o[i]".
 
PyObject* PySequence_GetSlice( PyObject *o, int i1, int i2)
Return value: New reference.
Return the slice of sequence object o between i1 and i2, or NULL on failure. This is the equivalent of the Python expression "o[i1:i2]".
 
int PySequence_SetItem( PyObject *o, int i, PyObject *v)
Assign object v to the ith element of o. Returns -1 on failure. This is the equivalent of the Python statement "o[i] = v". This function does not steal a reference to v.
 
int PySequence_DelItem( PyObject *o, int i)
Delete the ith element of object o. Returns -1 on failure. This is the equivalent of the Python statement "del o[i]".
 
int PySequence_SetSlice( PyObject *o, int i1, int i2, PyObject *v)
Assign the sequence object v to the slice in sequence object o from i1 to i2. This is the equivalent of the Python statement "o[i1:i2] = v".
 
int PySequence_DelSlice( PyObject *o, int i1, int i2)
Delete the slice in sequence object o from i1 to i2. Returns -1 on failure. This is the equivalent of the Python statement "del o[i1:i2]".
 
PyObject* PySequence_Tuple( PyObject *o)
Return value: New reference.
Returns the o as a tuple on success, and NULL on failure. This is equivalent to the Python expression "tuple(o)".
 
int PySequence_Count( PyObject *o, PyObject *value)
Return the number of occurrences of value in o, that is, return the number of keys for which o[key] == value. On failure, return -1. This is equivalent to the Python expression "o.count(value)".
 
int PySequence_Contains( PyObject *o, PyObject *value)
Determine if o contains value. If an item in o is equal to value, return 1, otherwise return 0. On error, return -1. This is equivalent to the Python expression "value in o".
 
int PySequence_Index( PyObject *o, PyObject *value)
Return the first index i for which o[i] == value. On error, return -1. This is equivalent to the Python expression "o.index(value)".
 
PyObject* PySequence_List( PyObject *o)
Return value: New reference.
Return a list object with the same contents as the arbitrary sequence o. The returned list is guaranteed to be new.
 
PyObject* PySequence_Tuple( PyObject *o)
Return value: New reference.
Return a tuple object with the same contents as the arbitrary sequence o. If o is a tuple, a new reference will be returned, otherwise a tuple will be constructed with the appropriate contents.
 
PyObject* PySequence_Fast( PyObject *o, const char *m)
Return value: New reference.
Returns the sequence o as a tuple, unless it is already a tuple or list, in which case o is returned. Use PySequence_Fast_GET_ITEM() to access the members of the result. Returns NULL on failure. If the object is not a sequence, raises TypeError with m as the message text.
 
PyObject* PySequence_Fast_GET_ITEM( PyObject *o, int i)
Return value: Borrowed reference.
Return the ith element of o, assuming that o was returned by PySequence_Fast(), o is not NULL, and that i is within bounds.
 
PyObject* PySequence_ITEM( PyObject *o, int i)
Return value: New reference.
Return the ith element of o or NULL on failure. Macro form of PySequence_GetItem() but without checking that PySequence_Check(o) is true and without adjustment for negative indices. New in version 2.3.
 
int PySequence_Fast_GET_SIZE( PyObject *o)
Returns the length of o, assuming that o was returned by PySequence_Fast() and that o is not NULL. The size can also be gotten by calling PySequence_Size() on o, but PySequence_Fast_GET_SIZE() is faster because it can assume o is a list or tuple.

 

   

2002-2004 Active-Venture.com Web Hosting Service

 

Disclaimer: This documentation is provided only for the benefits of our hosting customers.
For authoritative source of the documentation, please refer to http://python.org/doc/

  

Domain name registration - Domain registration and domain name transfer
with comprehensive free services

Cheap domain name registration -
Register domain name and
domain transfer from $7.95/year only