| 1 | /* The PyMem_ family: low-level memory allocation interfaces.
|
|---|
| 2 | See objimpl.h for the PyObject_ memory family.
|
|---|
| 3 | */
|
|---|
| 4 |
|
|---|
| 5 | #ifndef Py_PYMEM_H
|
|---|
| 6 | #define Py_PYMEM_H
|
|---|
| 7 |
|
|---|
| 8 | #include "pyport.h"
|
|---|
| 9 |
|
|---|
| 10 | #ifdef __cplusplus
|
|---|
| 11 | extern "C" {
|
|---|
| 12 | #endif
|
|---|
| 13 |
|
|---|
| 14 | /* BEWARE:
|
|---|
| 15 |
|
|---|
| 16 | Each interface exports both functions and macros. Extension modules should
|
|---|
| 17 | use the functions, to ensure binary compatibility across Python versions.
|
|---|
| 18 | Because the Python implementation is free to change internal details, and
|
|---|
| 19 | the macros may (or may not) expose details for speed, if you do use the
|
|---|
| 20 | macros you must recompile your extensions with each Python release.
|
|---|
| 21 |
|
|---|
| 22 | Never mix calls to PyMem_ with calls to the platform malloc/realloc/
|
|---|
| 23 | calloc/free. For example, on Windows different DLLs may end up using
|
|---|
| 24 | different heaps, and if you use PyMem_Malloc you'll get the memory from the
|
|---|
| 25 | heap used by the Python DLL; it could be a disaster if you free()'ed that
|
|---|
| 26 | directly in your own extension. Using PyMem_Free instead ensures Python
|
|---|
| 27 | can return the memory to the proper heap. As another example, in
|
|---|
| 28 | PYMALLOC_DEBUG mode, Python wraps all calls to all PyMem_ and PyObject_
|
|---|
| 29 | memory functions in special debugging wrappers that add additional
|
|---|
| 30 | debugging info to dynamic memory blocks. The system routines have no idea
|
|---|
| 31 | what to do with that stuff, and the Python wrappers have no idea what to do
|
|---|
| 32 | with raw blocks obtained directly by the system routines then.
|
|---|
| 33 | */
|
|---|
| 34 |
|
|---|
| 35 | /*
|
|---|
| 36 | * Raw memory interface
|
|---|
| 37 | * ====================
|
|---|
| 38 | */
|
|---|
| 39 |
|
|---|
| 40 | /* Functions
|
|---|
| 41 |
|
|---|
| 42 | Functions supplying platform-independent semantics for malloc/realloc/
|
|---|
| 43 | free. These functions make sure that allocating 0 bytes returns a distinct
|
|---|
| 44 | non-NULL pointer (whenever possible -- if we're flat out of memory, NULL
|
|---|
| 45 | may be returned), even if the platform malloc and realloc don't.
|
|---|
| 46 | Returned pointers must be checked for NULL explicitly. No action is
|
|---|
| 47 | performed on failure (no exception is set, no warning is printed, etc).
|
|---|
| 48 | */
|
|---|
| 49 |
|
|---|
| 50 | PyAPI_FUNC(void *) PyMem_Malloc(size_t);
|
|---|
| 51 | PyAPI_FUNC(void *) PyMem_Realloc(void *, size_t);
|
|---|
| 52 | PyAPI_FUNC(void) PyMem_Free(void *);
|
|---|
| 53 |
|
|---|
| 54 | /* Starting from Python 1.6, the wrappers Py_{Malloc,Realloc,Free} are
|
|---|
|
|---|
