diff options
author | Tim Peters <tim.peters@gmail.com> | 2006-03-02 21:04:08 +0000 |
---|---|---|
committer | Tim Peters <tim.peters@gmail.com> | 2006-03-02 21:04:08 +0000 |
commit | 01b09d41b5a3df1815cb73b20ae90f4754336368 (patch) | |
tree | 1f474ba9bd3d72dcd15c636dd37363d0c2c57c3d | |
parent | 188564707de8ab7ce84693772624ed8fe3779689 (diff) | |
download | cpython-01b09d41b5a3df1815cb73b20ae90f4754336368.tar.gz |
Beefed up description of what this does; new XXX.
-rw-r--r-- | Include/pyarena.h | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/Include/pyarena.h b/Include/pyarena.h index 16365563ad..f5e9eb4b2c 100644 --- a/Include/pyarena.h +++ b/Include/pyarena.h @@ -12,8 +12,16 @@ extern "C" { /* PyArena_New() and PyArena_Free() create a new arena and free it, respectively. Once an arena has been created, it can be used - to allocate memory. Once it is freed, all the memory it allocated - is freed and none of its pointers are valid. + to allocate memory via PyArena_Malloc(). Pointers to PyObject can + also be registered with the arena via PyArena_AddPyObject(), and the + arena will ensure that the PyObjects stay alive at least until + PyArena_Free() is called. When an arena is freed, all the memory it + allocated is freed, the arena releases internal references to registered + PyObject*, and none of its pointers are valid. + XXX (tim) What does "none of its pointers are valid" mean? Does it + XXX mean that pointers previously obtained via PyArena_Malloc() are + XXX no longer valid? (That's clearly true, but not sure that's what + XXX the text is trying to say.) PyArena_New() returns an arena pointer. On error, it returns a negative number and sets an exception. |