objclass.h

Go to the documentation of this file.

#pragma once
 
 
#include <cx/container/hashtable.h>
#include <cx/obj/objiface.h>
#include <cx/thread/atomic.h>
#include <cx/thread/rwlock.h>
#include <cx/utils/macros/unused.h>
 
 
CX_C_BEGIN
 
typedef struct ObjClassInfo ObjClassInfo;
typedef struct ObjInst ObjInst;
typedef struct StructMemberDesc StructMemberDesc;
typedef struct SerWriter SerWriter;
typedef struct SerReader SerReader;
 
typedef struct ObjClassInfo {
    size_t instsize;        
    ObjClassInfo* parent;   
    ObjIface* classif;      
    ObjIface** ifimpl;      
 
    bool (*init)(void* _self);
 
    void (*destroy)(void* _self);
 
    // ----- Statically defined in class info instance by class implementer -----
 
    strref name;
 
    const StructMemberDesc* sermembers;
    int32 nsermembers;   
 
    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 ClassSet {
    int nentries;
    ObjClassInfo* entries[];   
} ClassSet;
 
_Ret_maybenull_ ObjClassInfo* classSetFind(_In_ const ClassSet* cs, _In_opt_ strref name);
 
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