|
|
|
|
|
|
Defines | |
| #define | CSTRING_F_TYPE_MASK (0x003f) |
| #define | CSTRING_F_MEMORY_IS_INTERNAL_HEAP (0x0000) |
| #define | CSTRING_F_MEMORY_IS_BORROWED (0x0001) |
| #define | CSTRING_F_MEMORY_IS_FIXED (0x0002) |
| #define | CSTRING_F_MEMORY_IS_READONLY (0x0004) |
| #define | CSTRING_F_MEMORY_IS_CONST CSTRING_F_MEMORY_IS_READONLY |
| #define | CSTRING_F_MEMORY_IS_OFFSET (0x0040) |
| #define | CSTRING_F_MEMORY_CAN_GROW_TO_HEAP (0x0080) |
| #define | CSTRING_F_ARENA_MASK (0xff00) |
| #define | CSTRING_F_USE_REALLOC (0x0000) |
| #define | CSTRING_F_USE_WINDOWS_GLOBAL_MEMORY (0x0100) |
| #define | CSTRING_F_USE_WINDOWS_PROCESSHEAP_MEMORY (0x0200) |
| #define | CSTRING_F_USE_WINDOWS_COM_TASK_MEMORY (0x0400) |
| #define | CSTRING_F_USE_CUSTOMARENAFUNCTIONS (0x2000) |
| #define | CSTRING_F_CUSTOMARENA_CC_CDECL (0x0000) |
| #define | CSTRING_F_CUSTOMARENA_CC_STDCALL (0x0040) |
| #define CSTRING_F_ARENA_MASK (0xff00) |
| #define CSTRING_F_CUSTOMARENA_CC_CDECL (0x0000) |
Treats the externally supplied allocator function as having CDecl calling convention (de-)allocation (NOT CURRENTLY SUPPORTED)
| #define CSTRING_F_CUSTOMARENA_CC_STDCALL (0x0040) |
Treats the externally supplied allocator function as having StdCall calling convention (de-)allocation (NOT CURRENTLY SUPPORTED)
| #define CSTRING_F_MEMORY_CAN_GROW_TO_HEAP (0x0080) |
Allows borrowed strings to move their contents to the heap and continue to grow when their borrowed capacity would be exceeded: note that they do not subsequently return to use the borrowed capacity if the size subsequently shrinks to within capacity.
| #define CSTRING_F_MEMORY_IS_BORROWED (0x0001) |
Memory is supplied external to the API, and may not be deallocated, moved or expanded.
| #define CSTRING_F_MEMORY_IS_CONST CSTRING_F_MEMORY_IS_READONLY |
[DEPRECATED] Equivalent to CSTRING_F_MEMORY_IS_READONLY
| #define CSTRING_F_MEMORY_IS_FIXED (0x0002) |
Memory is of fixed size, and any operation that requires expansion will fail
| #define CSTRING_F_MEMORY_IS_INTERNAL_HEAP (0x0000) |
Memory is allocated by the heap function, and is owned by the cstring instance
| #define CSTRING_F_MEMORY_IS_OFFSET (0x0040) |
cstring instance may not be modified. This flag cannot be set by client code.
| #define CSTRING_F_MEMORY_IS_READONLY (0x0004) |
cstring instance may not be modified
| #define CSTRING_F_TYPE_MASK (0x003f) |
| #define CSTRING_F_USE_CUSTOMARENAFUNCTIONS (0x2000) |
Uses an externally supplied allocator function for all memory (de-)allocation (NOT CURRENTLY SUPPORTED)
| #define CSTRING_F_USE_REALLOC (0x0000) |
Uses C standard library function realloc() for all memory (de-)allocation
| #define CSTRING_F_USE_WINDOWS_COM_TASK_MEMORY (0x0400) |
Uses COM Task Allocator for all memory (de-)allocation (Windows only); arena parameter is ignored.
| #define CSTRING_F_USE_WINDOWS_GLOBAL_MEMORY (0x0100) |
Uses Win32 Global Memory API for all memory (de-)allocation (Windows only); arena parameter is ignored.
| #define CSTRING_F_USE_WINDOWS_PROCESSHEAP_MEMORY (0x0200) |
Uses Win32 Process Heap for all memory (de-)allocation (Windows only); arena parameter is ignored.
|
|
| cstring Library documentation (c) Matthew Wilson and Synesis Software Pty Ltd, 1994-2009 |