MemoryBlock

bool isfree_memblock( const  memblock_t  * mblock )

Returns true if mblock equals memblock_FREE.

bool isvalid_memblock( const  memblock_t  * mblock )

Returns true if mblock->addr != 0 and block->size != 0.  This functions returns true for a memblock_t which is initialized to memblock_FREE.

uint8_t * addr_memblock( const  memblock_t  * mblock )

Returns start (lowest) address of memory block. in case of the value null the block is in a freed state.

size_t size_memblock( const  memblock_t  * mblock )

Returns size of memory block.  The size can also be 0.

void clear_memblock( memblock_t  * mblock )

Sets the content of the memory block to 0.

int shrinkleft_memblock( memblock_t  * mblock, size_t  addr_increment )

Shrinks the memory block by incr its addr and decr its size.  The start address memblock_t.addr is incremented by addr_increment and the size of the block memblock_t.size is decremented by the same amount.

╭───────────────╮        ╭┈┈┈┈┬──────────╮
│<--- size ---->│    ==> │    │<- size'->│ addr' == addr + addr_increment
├───────────────┤        ╰┈┈┈┈├──────────┤ size' == size - addr_increment
└- addr         └- addr+size  └- addr'   └- addr+size == addr'+size'

int shrinkright_memblock( memblock_t  * mblock, size_t  size_decrement )

Shrinks the memory block by decrementing only its size.  The start address memblock_t.addr is not changed but the size of the block memblock_t.size is decremented by size_decrement.

╭───────────────╮            ╭─────────┬┈┈┈┈┈╮
│<--- size ---->│    ==>     │<-size'->│<-D->│ D     == size_decrement
├───────────────┤            ╰─────────├┈┈┈┈┈┤ size' == size - D
└- addr         └- addr+size └- addr   └- addr+size'

int growleft_memblock( memblock_t  * mblock, size_t  addr_decrement )

Grows the memory block by decr its addr and incr its size..  The start address memblock_t.addr is decremented by addr_decrement and the size of the block memblock_t.size is incremented by the same amount.

╭────────────╮            ╭┈┈┈┈┈──────────╮
│<-- size -->│        ==> │<--- size' --->│ addr' == addr - addr_decrement
├────────────┤            ├┈┈┈┈┈──────────┤ size' == size + addr_decrement
└- addr      └- addr+size └- addr'        └- addr'+size'

int growright_memblock( memblock_t  * mblock, size_t  size_increment )

Grows the memory block by incrementing only its size.  The start address memblock_t.addr is not changed but the size of the block memblock_t.size is incremented by size_increment.

╭────────────╮            ╭┈┈┈┈┈──────────╮
│<-- size -->│        ==> │<--- size' --->│
├────────────┤            ├┈┈┈┈┈──────────┤ size' == size + size_increment
└- addr      └- addr+size └- addr         └- addr+size'

memblock_t * genericcast_memblock( void  * obj, IDNAME  nameprefix )

Casts a pointer to generic object into pointer to memblock_t.  The object must have two members nameprefix##addr and nameprefix##size of the same type as memblock_t and in the same order.