オブジェクトをヒープ上にメモリ確保する¶
-
PyObject *_PyObject_New(PyTypeObject *type)¶
- 戻り値: 新しい参照。
-
PyVarObject *_PyObject_NewVar(PyTypeObject *type, Py_ssize_t size)¶
- 戻り値: 新しい参照。
-
PyObject *PyObject_Init(PyObject *op, PyTypeObject *type)¶
- 戻り値: 借用参照。 次に属します: Stable ABI.
Initialize a newly allocated object op with its type and initial reference. Returns the initialized object. Other fields of the object are not affected.
-
PyVarObject *PyObject_InitVar(PyVarObject *op, PyTypeObject *type, Py_ssize_t size)¶
- 戻り値: 借用参照。 次に属します: Stable ABI.
PyObject_Init()
の全ての処理を行い、可変サイズオブジェクトの場合には長さ情報も初期化します。
-
PyObject_New(TYPE, typeobj)¶
C の構造体型 TYPE と Python の型オブジェクト typeobj (
PyTypeObject*
) を用いて Python オブジェクトの領域を新規確保します。Python のオブジェクトヘッダに定義されていないフィールドは初期化されません。呼び出し元がオブジェクトへの唯一の参照を持ちます(つまり、参照カウントは1になります)。メモリ割り当ての大きさは型オブジェクトのtp_basicsize
フィールドによって定められます。
-
PyObject_NewVar(TYPE, typeobj, size)¶
C の構造体型 TYPE と Python の型オブジェクト typeobj (
PyTypeObject*
) を用いて Python オブジェクトの領域を新規確保します。Python のオブジェクトヘッダに定義されていないフィールドは初期化されません。確保されたメモリには、 TYPE 構造体に加え、 typeobj のtp_itemsize
フィールドによって定められた大きさのフィールドを size (Py_ssize_t
) 個分格納できます。これはタプルなどの、生成時に大きさを決定できるオブジェクトを実装する際に便利です。同じメモリ割当にフィールドの配列も埋め込むことで、メモリ割当の回数を減らし、メモリ管理効率を上げることができます。
-
void PyObject_Del(void *op)¶
PyObject_New
またはPyObject_NewVar
によって、オブジェクトのために確保されたメモリを解放します。これは通常オブジェクトの型に指定されているtp_dealloc
ハンドラから呼び出されます。これの呼び出し後のメモリは既に有効な Python オブジェクトではなくなっているため、オブジェクトのフィールドはアクセスされるべきではありません。
-
PyObject _Py_NoneStruct¶
Python からは
None
に見えるオブジェクトです。この値へのアクセスは、このオブジェクトへのポインタを評価するPy_None
マクロを使わなければなりません。
参考
PyModule_Create()
拡張モジュールのアロケートと生成。