Serious-Engine/Sources/Engine/Base/Relations.h
Ryan C. Gordon 24cb244d43 First attempt to hand-merge Ryan's Linux and Mac OS X port.
This was a _ton_ of changes, made 15 years ago, so there are probably some
problems to work out still.

Among others: Engine/Base/Stream.* was mostly abandoned and will need to be
re-ported.

Still, this is a pretty good start, and probably holds a world record for
lines of changes or something.  :)
2016-03-28 23:46:13 -04:00

83 lines
2.9 KiB
C++

/* Copyright (c) 2002-2012 Croteam Ltd. All rights reserved. */
#ifndef SE_INCL_RELATIONS_H
#define SE_INCL_RELATIONS_H
#ifdef PRAGMA_ONCE
#pragma once
#endif
#include <Engine/Base/Lists.h>
// Object representing a link at the member of relation domain.
class CRelationSrc : public CListHead {
public:
// implementation:
// interface:
// Construction/destruction.
ENGINE_API CRelationSrc(void);
ENGINE_API ~CRelationSrc(void);
void Clear(void);
};
// Object representing a link at the member of relation codomain.
class CRelationDst : public CListHead {
public:
// implementation:
// interface:
// Construction/destruction.
ENGINE_API CRelationDst(void);
ENGINE_API ~CRelationDst(void);
void Clear(void);
};
// Object representing a link between a domain member and a codomain member.
class CRelationLnk {
public:
// implementation:
CRelationSrc *rl_prsSrc; // domain member
CRelationDst *rl_prdDst; // codomain member
CListNode rl_lnSrc; // node in list of links in domain member
CListNode rl_lnDst; // node in list of links in codomain member
// interface:
// Construction/destruction.
CRelationLnk(void);
~CRelationLnk(void);
// Get the domain member of this pair.
ENGINE_API CRelationSrc &GetSrc(void);
// Get the codomain member of this pair.
ENGINE_API CRelationDst &GetDst(void);
};
// Global functions for creating relations.
void ENGINE_API AddRelationPair(CRelationSrc &rsSrc, CRelationDst &rdDst);
void ENGINE_API AddRelationPairTailTail(CRelationSrc &rsSrc, CRelationDst &rdDst);
void ENGINE_API AddRelationPairHeadHead(CRelationSrc &rsSrc, CRelationDst &rdDst);
// make 'for' construct for walking a list in domain member
#define FOREACHSRCLINK(head, iter) \
for ( LISTITER(CRelationLnk, rl_lnSrc) iter(head); !iter.IsPastEnd(); iter.MoveToNext() )
// make 'for' construct for walking a list in codomain member
#define FOREACHDSTLINK(head, iter) \
for ( LISTITER(CRelationLnk, rl_lnDst) iter(head); !iter.IsPastEnd(); iter.MoveToNext() )
// get a domain member related to a codomain member through a link
#define DST(plink, dstclass, dstmember) \
( (dstclass *) ( ((UBYTE *)(&(plink->GetDst()))) - _offsetof(dstclass, dstmember) ) )
// get a codomain member that a domain member is related to through a link
#define SRC(plink, srcclass, srcmember) \
( (srcclass *) ( ((UBYTE *)(&(plink->GetSrc()))) - _offsetof(srcclass, srcmember) ) )
// make 'for' construct for walking all codomain members related to a domain member
#define FOREACHDSTOFSRC(srchead, dstclass, dstmember, pdst) \
FOREACHSRCLINK(srchead, pdst##_iter) { \
dstclass *pdst = DST(pdst##_iter, dstclass, dstmember);
// make 'for' construct for walking all domain members related to a codomain member
#define FOREACHSRCOFDST(dsthead, srcclass, srcmember, psrc) \
FOREACHDSTLINK(dsthead, psrc##_iter) { \
srcclass *psrc = SRC(psrc##_iter, srcclass, srcmember);
#define ENDFOR }
#endif /* include-once check. */