objclass.h

Go to the documentation of this file.

#pragma once
 
 
#include <cx/obj/objiface.h>
#include <cx/container/hashtable.h>
#include <cx/thread/atomic.h>
#include <cx/utils/macros/unused.h>
#include <cx/thread/rwlock.h>
 
 
CX_C_BEGIN
 
typedef struct ObjClassInfo ObjClassInfo;
typedef struct ObjInst ObjInst;
typedef struct ObjClassInfo ObjClassInfo;
typedef struct ObjInst ObjInst;
 
typedef struct ObjClassInfo {
    // ----- Statically defined in class info instance by class implementer -----
    
    size_t instsize;            
    ObjClassInfo *parent;       
    ObjIface *classif;          
    ObjIface **ifimpl;          
 
    bool(*init)(void *_self);
 
    void(*destroy)(void *_self);
 
    bool _abstract;             
 
    // ----- Runtime use only, do not set manually! -----
    
    intptr (*_cmp)(void *self, void *other, uint32 flags);
    
    uint32 (*_hash)(void *self, uint32 flags);
    
    sa_ObjIface _impl;          
    hashtable _tmpl;            
} ObjClassInfo;
 
#define objClassInfoName(cname) cname##_clsinfo
 
typedef struct ObjInst {
    union {
        ObjIface *_classif;         
        void *_is_ObjInst;          
    };
    ObjClassInfo *_clsinfo;         
    atomic(uintptr) _ref;           
    atomic(ptr) _weakref;           
 
    // Class-specific data members follow in derived classes
} ObjInst;
 
typedef struct ObjInst_WeakRef
{
    union
    {
        ObjInst *_inst;             
        void *_is_ObjInst_WeakRef;  
    };
    atomic(uintptr) _ref;           
    RWLock _lock;                   
} ObjInst_WeakRef;
 
#define Weak(clsname) clsname##_WeakRef
 
#define ObjInst(inst) ((ObjInst*)(unused_noeval(&((inst)->_is_ObjInst)), (inst)))
 
#define ObjInst_WeakRef(ref) ((ObjInst_WeakRef*)(unused_noeval(&((ref)->_is_ObjInst_WeakRef)), (ref)))
 
#define objInstBase(inst) ObjInst(inst)
 
#define objWeakRefBase(ref) ObjInst_WeakRef(ref)
 
#define objClsInfo(inst) (inst->_clsinfo)
 
void _objDestroy(_Pre_notnull_ _Post_invalid_ ObjInst *inst);
 
_meta_inline void _objAcquire(_In_opt_ ObjInst *inst)
{
    if (inst)
        atomicFetchAdd(uintptr, &inst->_ref, 1, Relaxed);
}
 
#define objAcquire(inst) (_objAcquire(objInstBase(inst)), (inst))
 
_At_(*instp, _Pre_maybenull_ _Post_null_)
void _objRelease(_Inout_ ObjInst **instp);
 
#define objRelease(pinst) (unused_noeval(&((*(pinst))->_is_ObjInst)), _objRelease((ObjInst**)(pinst)))
 
_Ret_maybenull_ ObjIface *_objClassIf(_In_ ObjClassInfo *cls, _In_ ObjIface *iftmpl);
#define objClassIf(clsname, ifname) ((ifname*)_objClassIf(&objClassInfoName(clsname), objIfBase(&objIfTmplName(ifname))))
 
_Ret_maybenull_ ObjIface *_objInstIf(_In_opt_ ObjInst *inst, _In_ ObjIface *iftmpl);
#define objInstIf(inst, ifname) ((ifname*)_objInstIf(objInstBase(inst), objIfBase(&objIfTmplName(ifname))))
 
_Ret_valid_ ObjInst_WeakRef *_objGetWeak(_In_ ObjInst *inst);
#define objGetWeak(clsname, inst) ((Weak(clsname)*)_objGetWeak((ObjInst*)clsname(inst)))
 
_Ret_maybenull_ ObjInst_WeakRef *_objCloneWeak(_In_opt_ ObjInst_WeakRef *ref);
#define objCloneWeak(ref) (_objCloneWeak(objWeakRefBase(ref)))
 
void _objDestroyWeak(_Inout_ ObjInst_WeakRef **refp);
#define objDestroyWeak(pref) (unused_noeval(&((*(pref))->_is_ObjInst_WeakRef)), _objDestroyWeak((ObjInst_WeakRef**)(pref)))
 
_Ret_maybenull_ ObjInst *_objAcquireFromWeak(_In_opt_ ObjInst_WeakRef *ref);
#define objAcquireFromWeak(clsname, ref) ((clsname*)_objAcquireFromWeak((ObjInst_WeakRef*)Weak(clsname)(ref)))
 
_Ret_maybenull_ ObjInst *_objDynCast(_In_opt_ ObjInst *inst, _In_ ObjClassInfo *cls);
#define objDynCast(clsname, inst) ((clsname*)_objDynCast(objInstBase(inst), &objClassInfoName(clsname)))
 
_Ret_maybenull_ ObjInst *_objAcquireFromWeakDyn(_In_opt_ ObjInst_WeakRef *ref, _In_ ObjClassInfo *cls);
#define objAcquireFromWeakDyn(clsname, ref) ((clsname*)_objAcquireFromWeakDyn(objWeakRefBase(ref), &objClassInfoName(clsname)))
 
 
CX_C_END