/**
* =========================================================================
* File        : mem.h
* Project     : 0 A.D.
* Description : wrapper that treats memory as a "resource", i.e.
*             : guarantees its lifetime and automatic release.
* =========================================================================
*/

// license: GPL; see lib/license.txt

#ifndef INCLUDED_MEM
#define INCLUDED_MEM

#include "handle.h"


typedef void (*MEM_DTOR)(void* p, size_t size, uintptr_t ctx);

// mem_alloc flags
enum
{
    // RES_*

    MEM_ZERO = 0x1000
};

extern void* mem_alloc(size_t size, size_t align = 1, uint flags = 0, Handle* ph = 0);

#define mem_free(p) mem_free_p((void*&)p)
extern LibError mem_free_p(void*& p);

extern LibError mem_free_h(Handle& hm);

// returns 0 if the handle is invalid
extern void* mem_get_ptr(Handle h, size_t* size = 0);

extern LibError mem_get(Handle hm, u8** pp, size_t* psize);


extern Handle mem_wrap(void* p, size_t size, uint flags, void* raw_p, size_t raw_size, MEM_DTOR dtor, uintptr_t ctx, void* owner);

// exception to normal resource shutdown: must not be called before
// h_mgr_shutdown! (this is because h_mgr calls us to free memory, which
// requires the pointer -> Handle index still be in place)
extern void mem_shutdown(void);



#endif  // #ifndef INCLUDED_MEM