struct.h

#pragma once
 
#include <cx/container/hashtable.h>
#include <cx/container/sarray.h>
#include <cx/container/stype_hashtable.h>
#include <cx/container/stype_sarray.h>
#include <cx/string.h>
#include <cx/stype/stype.h>
#include "stype_struct.h"
 
CX_C_BEGIN
 
 
enum StructMemberFlagsEnum {
    STRUCT_NoDestroy   = 1 << 0,   
    STRUCT_NoCopy      = 1 << 1,   
    STRUCT_NoSerialize = 1 << 2,   
 
    STRUCT_Ignore = STRUCT_NoDestroy | STRUCT_NoSerialize | STRUCT_NoCopy,
};
 
typedef struct StructSet StructSet;
 
typedef struct StructMemberDesc {
    strref name;     // Name on the wire; empty for a [noserialize] member
    size_t offset;   // Offset within the struct
 
    const STypeInfoExt* schema;   // Declared type, including nested/nominal type info
 
    uint32 flags;     // Member flags (StructMemberFlagsEnum)
    uint32 cflags;    // Creation flags (e.g. for arrays, hashtables, etc.)
    uint32 arrsize;   // Fixed-size C arrays: element count (0 = scalar)
} StructMemberDesc;
 
typedef struct StructInfo {
    strref name;                       // Name of the struct
    size_t structsize;                 // Size in bytes of the struct
    int nmembers;                      // Number of struct members
    const void* defaults;              // Default struct to copy (if any)
    stype type;                        // Runtime type descriptor for this struct
 
    void (*init)(void* _struct);       // Optional: called after zero-fill to set defaults
    void (*destroy)(void* _struct);    // Optional: called before members are destroyed
 
    const StructMemberDesc members[];   // Array of struct member descriptors
} StructInfo;
 
// A named list of struct types, used for a member that can hold any one of them.
typedef struct StructSet {
    int nentries;
    const StructInfo* entries[];   // sorted by name, for binary search
} StructSet;
 
_Ret_maybenull_ const StructInfo* structSetFind(_In_ const StructSet* ss, _In_opt_ strref name);
 
typedef struct StructBase {
    union {
        const StructInfo* structinfo;   
        void* _is_struct;               // compile-time marker; not for direct use
    };
 
    // Struct-specific data members follow
} StructBase;
 
#define structInfoName(sname)     sname##_structinfo
#define structDefaultsName(sname) sname##_structdefaults
 
#define STRUCTBASE(s)    (unused_noeval(&((s)->_is_struct)), (StructBase*)(s))
#define STRUCTHANDLE(sp) (unused_noeval(&((*sp)->_is_struct)), (StructBase**)(sp))
 
void _structInitMany(_Out_ StructBase* base, _In_ const StructInfo* info, int number);
 
#define structInitMany(structname, s, n) \
    _structInitMany(STRUCTBASE(s), &structInfoName(structname), n)
 
#define structInit(structname, s) _structInitMany(STRUCTBASE(s), &structInfoName(structname), 1)
 
_Ret_notnull_ StructBase* _structAlloc(_In_ const StructInfo* info);
 
#define structCreate(structname) ((structname*)_structAlloc(&structInfoName(structname)))
 
// Destroy one member of one struct instance, including every element if it is a fixed
// C array. Exposed for the struct traverser; ordinary code goes through the macros below.
void _structDestroyMember(_In_ const StructMemberDesc* member, _Inout_ StructBase* s);
 
void _structDestroyMembersMany(_Pre_notnull_ _Post_invalid_ StructBase* base, int number);
 
#define structDestroyMembersMany(s, n) _structDestroyMembersMany(STRUCTBASE(s), n)
 
#define structDestroyMembers(s) _structDestroyMembersMany(STRUCTBASE(s), 1)
 
_At_(*pbase, _Pre_maybenull_ _Post_null_) void _structDestroy(StructBase** pbase);
 
#define structDestroy(ps) _structDestroy(STRUCTHANDLE(ps))
 
 
CX_C_END