1 /* Runtime types. 2 3 Copyright (C) 2015-2019, 2021, 2023 Paul Boddie <paul@boddie.org.uk> 4 5 This program is free software; you can redistribute it and/or modify it under 6 the terms of the GNU General Public License as published by the Free Software 7 Foundation; either version 3 of the License, or (at your option) any later 8 version. 9 10 This program is distributed in the hope that it will be useful, but WITHOUT 11 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 12 FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 13 details. 14 15 You should have received a copy of the GNU General Public License along with 16 this program. If not, see <http://www.gnu.org/licenses/>. 17 */ 18 19 #ifndef __TYPES_H__ 20 #define __TYPES_H__ 21 22 /* Define code and position types, populated by enum values defined for each 23 program specifically. */ 24 25 #include <stdint.h> 26 #include <stdlib.h> 27 28 /* Include the special instance position value. The pos member of __obj refers 29 to the special type attribute for classes, indicating which position holds 30 the attribute describing the class type. For instances, it is set to the same 31 attribute position as __class__ and is defined in the following file. */ 32 33 #include "instancepos.h" 34 35 typedef uint16_t __code; 36 typedef uint16_t __pos; 37 typedef uint16_t __pcode; 38 typedef uint16_t __ppos; 39 40 /* Attribute tables are lists of codes confirming the presence of attributes. */ 41 42 typedef struct __table 43 { 44 const __pos size; 45 const __code attrs[]; 46 } __table; 47 48 /* Parameter tables are lists of codes confirming the presence of parameters, as 49 well as the positions of those parameters in the list for a given function. 50 */ 51 52 typedef struct __param 53 { 54 __code code; 55 __pos pos; 56 } __param; 57 58 typedef struct __ptable 59 { 60 const __ppos min, max, size; 61 const __param params[]; 62 } __ptable; 63 64 /* Attributes are values referring to objects or encoding other information. 65 Objects are collections of attributes. 66 Object references are references to tables and collections of attributes. 67 Attribute references are references to single attributes. */ 68 69 typedef struct __obj __obj; 70 typedef struct __fragment __fragment; 71 typedef union __attr __attr; 72 typedef __obj * __ref; 73 74 /* Introduce an integer type that is interoperable with the size type. */ 75 76 typedef ssize_t __int; 77 78 /* Attribute value interpretations. */ 79 80 typedef union __attr 81 { 82 /* General attribute members. */ 83 84 __ref value; /* attribute value */ 85 __int intvalue; /* integer value data or object-specific size 86 (shifted value, tagged) */ 87 88 /* Special case attribute members. */ 89 90 const __ptable * ptable; /* parameter table */ 91 struct { 92 __pcode code; /* parameter table code for key */ 93 __ppos pos; /* parameter table position for key */ 94 }; 95 __attr (*fn)(); /* callable details */ 96 char * strvalue; /* string value */ 97 __fragment * seqvalue; /* sequence data */ 98 void * datavalue; /* object-specific data */ 99 } __attr; 100 101 typedef struct __obj 102 { 103 const __table * table; /* attribute table */ 104 __ppos pos; /* position of attribute indicating class */ 105 __attr attrs[]; /* attributes */ 106 107 /* Specialisations of this type may add other members. 108 See generator.py for type generation, progops.h for definitions, and 109 the generated progtypes.h for the final details. */ 110 111 } __obj; 112 113 /* Fragments are simple collections of attributes employed by sequence types. 114 They provide the basis of lists and tuples. */ 115 116 typedef struct __fragment 117 { 118 __int size, capacity; 119 __attr attrs[]; 120 } __fragment; 121 122 #define __FRAGMENT_SIZE(NUMBER) ((NUMBER) * sizeof(__attr) + 2 * sizeof(__int)) 123 124 /* Attribute interpretation. */ 125 126 #define __NUM_TAG_BITS 2 127 #define __TAG_INT 0b01 128 #define __TAG_MASK 0b11 129 #define __INTEGER(ATTR) (((ATTR).intvalue & __TAG_MASK) == __TAG_INT) 130 131 /* Attribute value setting. */ 132 133 #define __ATTRVALUE(VALUE) ((__attr) {.value=(__ref) VALUE}) 134 #define __NULL __ATTRVALUE(0) 135 #define __SETNULL(ATTR) ((ATTR).value = 0) 136 137 /* Attribute as instance value. */ 138 139 #define __FROMINT(VALUE) ((((__int) VALUE) << __NUM_TAG_BITS) | __TAG_INT) 140 #define __INTVALUE(VALUE) ((__attr) {.intvalue=__FROMINT(VALUE)}) 141 #define __TOINT(ATTR) ((ATTR).intvalue >> __NUM_TAG_BITS) 142 #define __MAXINT ((((__int) 1) << ((sizeof(__int) * 8) - 1 - __NUM_TAG_BITS)) - 1) 143 #define __MININT (-(((__int) 1) << ((sizeof(__int) * 8) - 1 - __NUM_TAG_BITS))) 144 145 /* Argument lists. */ 146 147 #define __ARGS(...) ((__attr[]) {__VA_ARGS__}) 148 #define __KWARGS(...) ((__param[]) {__VA_ARGS__}) 149 150 /* Attribute codes and positions for attribute names. */ 151 152 #define __ATTRCODE(ATTRNAME) __code_##ATTRNAME 153 #define __ATTRPOS(ATTRNAME) __pos_##ATTRNAME 154 #define __PARAMCODE(PARAMNAME) __pcode_##PARAMNAME 155 #define __PARAMPOS(PARAMNAME) __ppos_##PARAMNAME 156 157 #endif /* __TYPES_H__ */