1

#ifndef OBJECT_H

     2

#define OBJECT_H

     3

     4

/**

     5

 * @file

     6

 *

     7

 * The thing feared by every C-programmer - calling C structs "objects".

     8

 */

     9

#include <stdbool.h>

    10

    11

/**

    12

 * Basic object type info

    13

 */

    14

struct object_type {

    15

    /** Parent type for nested structs, NULL if the parent is object_type */

    16

    const struct object_type *parent;

    17

};

    18

    19

/**

    20

 * Basic object state

    21

 */

    22

struct object {

    23

    /** Object's type */

    24

    const struct object_type *type;

    25

};

    26

    27

/**

    28

 * Initialize an object to the given type.

    29

 */

    30

void object_init (struct object *obj, const struct object_type *type);

    31

    32

/**

    33

 * Check that the given object type is compatible with the given type.

    34

 */

    35

bool object_type_check (const struct object_type *obj_type, const struct object_type *type);

    36

    37

/**

    38

 * Check that the given object "implements" the given type.

    39

 */

    40

bool object_check (struct object *obj, const struct object_type *type);

    41

    42

/**

    43

 * Return the given object as a pointer suitable for casting to the struct for the given type.

    44

 *

    45

 * It is a bug to call this with an object that's not compatible with the given type.

    46

 */

    47

void* object_cast (struct object *obj, const struct object_type *type);

    48

    49

/**

    50

 * Return a pointer to the object's type that is compatible with the given type.

    51

 *

    52

 * It is a bug to call this with a object that's not compatible with the given type.

    53

 */

    54

const void* object_type (struct object *obj, const struct object_type *type);

    55

    56

#endif /* OBJECT_H */