9.2 メモリインタフェース

Python ヒープに対してメモリを確保したり解放したりするために、以下の関数セットが利用できます。これらの関数は ANSI C 標準に従ってモデル化されていますが、0 バイトの領域を要求した際の動作についても定義しています:

void* PyMem_Malloc( size_t n): n バイトをメモリ確保し、確保されたメモリを指す void* 型のポインタを返します。確保要求に失敗した場合には NULL を返します。 0 バイトをリクエストすると、可能ならば独立した非NULL のポインタを返します。このポインタは PyMem_Malloc(1) を代わりに呼んだときのようなメモリ領域を指しています。確保されたメモリ領域はいかなる初期化も行われていません。

void* PyMem_Realloc( void *p, size_t n): p が指しているメモリブロックを n バイトにサイズ変更します。メモリの内容のうち、新旧のサイズのうち小さい方までの領域は変更されません。p が NULLならば、この関数は PyMem_Malloc(n) と等価になります; それ以外の場合で、n がゼロに等しければ、メモリブロックはサイズ変更されますが、解放されず、非 NULLのポインタを返します。p の値をNULLにしないのなら、以前呼び出した PyMem_Malloc() や PyMem_Realloc() の返した値でなければなりません。

void PyMem_Free( void *p): p が指すメモリブロックを解放します。p は以前呼び出した PyMem_Malloc() や PyMem_Realloc() の返した値でなければなりません。それ以外の場合や、すでに PyMem_Free(p) を呼び出した後だった場合、未定義の動作になります。 p が NULLなら、何も行いません。

以下に挙げる型対象のマクロは利便性のために提供されているものです。 TYPE は任意の C の型を表します。

TYPE* PyMem_New( TYPE, size_t n): PyMem_Malloc() と同じですが、 (n * sizeof(TYPE)) バイトのメモリを確保します。 TYPE* に型キャストされたポインタを返します。メモリには何の初期化も行われていません。

TYPE* PyMem_Resize( void *p, TYPE, size_t n): PyMem_Realloc() と同じですが、 (n * sizeof(TYPE)) バイトにサイズ変更されたメモリを確保します。 TYPE* に型キャストされたポインタを返します。

上記に加えて、C API 関数を介することなく Python メモリ操作関数を直接呼び出すための以下のマクロセットが提供されています。ただし、これらのマクロは Python バージョン間でのバイナリ互換性を保てず、それゆえに拡張モジュールでは撤廃されているので注意してください。

PyMem_MALLOC()、 PyMem_REALLOC()、 PyMem_FREE()。

PyMem_NEW()、 PyMem_RESIZE()、 PyMem_DEL()。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。