array.h

Go to the documentation of this file.

#pragma once
 
/* ************************************************************************** */
/*      ____    _    _____ ____     _    _   _   _____ _  _   ____  ____      */
/*     / ___|  / \  |  ___|  _ \   / \  | \ | | |_   _| || | |  _ \/ ___|     */
/*     \___ \ / _ \ | |_  | |_) | / _ \ |  \| |   | | | || |_| | | \___ \     */
/*      ___) / ___ \|  _| |  _ < / ___ \| |\  |   | | |__   _| |_| |___) |    */
/*     |____/_/   \_|_|   |_| \_/_/   \_|_| \_|   |_|    |_| |____/|____/     */
/*                                                                            */
/* ************************************************************************** */
 
#include <stdbool.h> // bool
#include <stddef.h>  // size_t

typedef struct array
{
    void*  start;     
    size_t type_size; 
    size_t count;     
    size_t capacity;  
} array_t;

array_t array_new(size_t type_size);
void    array_clear(array_t* self);
void    array_clear_f(array_t* self, void (*cleanup)(void*));

#define ArrayNew(Type) array_new(sizeof(Type))

#define Array          __attribute__((cleanup(array_clear))) array_t

bool   array_push_back(array_t* self, const void* element);
bool   array_push_back_n(array_t* self, const void* elements, size_t count);
 
bool   array_pop_back(array_t* self, void* destination);
bool   array_pop_back_n(array_t* self, void* destination, size_t count);
 
bool   array_pop_front(array_t* self, void* destination);
bool   array_pop_front_n(array_t* self, void* destination, size_t count);

void*  array_first(const array_t* self);
void*  array_last(const array_t* self);
void*  array_get(const array_t* self, size_t index);
void*  array_end(const array_t* self);

bool   array_is_empty(const array_t* self);
 
size_t array_count(const array_t* self);
bool   array_reserve(array_t* self, size_t count);
bool   array_trim(array_t* self);

void   array_iter(const array_t* self, void (*function)(void*));

#define array_foreach(TYPE, ARRAY, ELEMENT) \
    for (char* _pointer = (char*)array_first(ARRAY); \
         _pointer <= (char*)array_last(ARRAY) && ((*(ELEMENT) = *(TYPE*)_pointer), true); \
         _pointer += (ARRAY)->type_size)

#define array_enumerate(TYPE, ARRAY, ELEMENT, INDEX) \
    for (*(INDEX) = 0; *(INDEX) < array_count(ARRAY) \
                       && ((*(ELEMENT) = *(TYPE*)array_get(ARRAY, *(INDEX))), true); \
         (*(INDEX))++)