// Define a custom metadata structure typedef struct array_metadata { size_t length; } ArrayMD; // Allocate an array with metadata int *numbers = mida_malloc(ArrayMD, sizeof(int), 5); // Access and set the metadata via the MIDA macro MIDA(ArrayMD, numbers)->length = 5; // Initialize data for (size_t i = 0; i < MIDA(ArrayMD, numbers)->length; i++) { numbers[i] = i + 1; } printf("Array length: %zu\n", MIDA(ArrayMD, numbers)->length); // 5 // Clean up mida_free(ArrayMD, numbers);

// Define a custom metadata structure typedef struct array_metadata { size_t length; } ArrayMD; // Allocate an array with metadata int data[5] = {0}; MIDA_BYTEMAP(ArrayMD, bytemap, sizeof(data)); int *numbers = mida_wrap(ArrayMD, data, bytemap); // Access and set the metadata via the MIDA macro MIDA(ArrayMD, numbers)->length = sizeof(data) / sizeof(data[0]); // Initialize data for (size_t i = 0; i < MIDA(ArrayMD, numbers)->length; i++) { numbers[i] = i + 1; } printf("Array length: %zu\n", MIDA(ArrayMD, numbers)->length); // 5

... // Previous code int data[5] = {0}; int *numbers = mida_wrap(ArrayMD, data, mida_bytemap(ArrayMD, sizeof(data))); ... // Continue with the rest of the code

// Define custom metadata with your own fields struct custom_metadata { int flags; char *owner; double timestamp; }; // Allocate data with custom metadata float *data = mida_malloc(struct custom_metadata, sizeof(float), 10); // Access the custom metadata MIDA(struct custom_metadata, data)->flags = 0x1; MIDA(struct custom_metadata, data)->owner = "example_user"; MIDA(struct custom_metadata, data)->timestamp = 1625000000.0; // Use the data normally for (size_t i = 0; i < 10; i++) { data[i] = (float)i * 1.5f; } // Clean up mida_free(struct custom_metadata, data);

// Define a metadata structure for strings typedef struct string_metadata { size_t length; } StrMD; // Create a string with metadata char *message = mida_string(StrMD, "Hello, World!"); // Set the length MIDA(StrMD, message)->length = strlen(message); // Access and use like a normal string printf("String length: %zu\n", MIDA(StrMD, message)->length); // 13 printf("Message: %s\n", message); printf("First character: %c\n", message[0]); // 'H' // Create strings with custom metadata typedef struct extended_string_metadata { size_t length; char *language; time_t created; } ExtendedStrMD; char *greeting = mida_string(ExtendedStrMD, "Good morning!"); // Access the custom metadata MIDA(ExtendedStrMD, greeting)->length = strlen(greeting); MIDA(ExtendedStrMD, greeting)->language = "English"; MIDA(ExtendedStrMD, greeting)->created = time(NULL); // String functions still work normally printf("Greeting length (standard): %zu\n", strlen(greeting)); printf("Greeting length (MIDA): %zu\n", MIDA(ExtendedStrMD, greeting)->length); // Fully compatible with standard C string functions if (strcmp(greeting, "Good morning!") == 0) { printf("Strings match!\n"); }

// Define custom metadata structure typedef struct file_metadata { char *filename; unsigned long permissions; time_t modified; } FileMD; // Create a struct with custom metadata using compound literals struct point { double x, y, z; }; struct point *location = mida_struct( FileMD, struct point, { .x = 10.5, .y = 20.3, .z = 5.7 } ); // Set custom metadata MIDA(FileMD, location)->filename = "point_data.bin"; MIDA(FileMD, location)->permissions = 0644; MIDA(FileMD, location)->modified = time(NULL); // Use the data as normal printf("Location: (%f, %f, %f)\n", location->x, location->y, location->z);

// Create a complex structure with metadata at multiple levels struct person { char *name; int *scores; struct person *manager; }; // Different metadata for different parts typedef struct name_meta { size_t length; const char *language; } NameMD; typedef struct scores_meta { size_t count; const char *subject; double average; } ScoresMD; typedef struct manager_meta { int department_id; } ManagerMD; // Create the structure with different metadata at each level struct person employee = { .name = mida_string(NameMD, "John Doe"), .scores = mida_array(ScoresMD, int, {85, 92, 78, 90}), .manager = mida_struct(ManagerMD, struct person, { .name = mida_string(NameMD, "Boss"), .scores = NULL, .manager = NULL }) }; // Access and set specific metadata for each component NameMD *name_info = MIDA(NameMD, employee.name); name_info->length = strlen(employee.name); name_info->language = "English"; ScoresMD *scores_info = MIDA(ScoresMD, employee.scores); scores_info->count = 4; scores_info->subject = "Computer Science"; scores_info->average = 86.25; ManagerMD *mgr_info = MIDA(ManagerMD, employee.manager); mgr_info->department_id = 42; // Use the data naturally printf("Employee: %s, Average: %.2f, Manager: %s, Dept: %d\n", employee.name, scores_info.average, employee.manager->name, mgr_info->department_id);

/* In every .c file that uses MIDA include only declarations: */ #define MIDA_HEADER #include "mida.h" /* Additionally, create one mida.c file for MIDA implementation: */ #include "mida.h"

#define MIDA_STATIC #include "mida.h"