Quelle  array.h

/* PipeWire */
/* SPDX-FileCopyrightText: Copyright © 2018 Wim Taymans */
/* SPDX-License-Identifier: MIT */

#ifndef PIPEWIRE_ARRAY_H
#define PIPEWIRE_ARRAY_H

#ifdef __cplusplus
extern "C" {
#endif

#include <errno.h>

#include <spa/utils/defs.h>

#ifndef PW_API_ARRAY
#define PW_API_ARRAY static inline
#endif


/** \defgroup pw_array Array
 *
 * \brief An array object
 *
 * The array is a dynamically resizable data structure that can
 * hold items of the same size.
 */

/**
 * \addtogroup pw_array
 * \{
 */
struct pw_array {
 void *data;  /**< pointer to array data */
 size_t size;  /**< length of array in bytes */
 size_t alloc;  /**< number of allocated memory in \a data */
 size_t extend;  /**< number of bytes to extend with, 0 when the
  *  data should not expand */
};

/** Initialize an array. The new array is empty. */
#define PW_ARRAY_INIT(extend) ((struct pw_array) { NULL, 0, 0, (extend) })

/** Return the length of an array. */
#define pw_array_get_len_s(a,s)   ((a)->size / (s))
#define pw_array_get_unchecked_s(a,idx,s,t) SPA_PTROFF((a)->data,(idx)*(s),t)
#define pw_array_check_index_s(a,idx,s)  ((idx) < pw_array_get_len_s(a,s))

/** Get the number of items of type \a t in array */
#define pw_array_get_len(a,t)   pw_array_get_len_s(a,sizeof(t))
/** Get the item with index \a idx and type \a t from array. No bounds check is done. */
#define pw_array_get_unchecked(a,idx,t)  pw_array_get_unchecked_s(a,idx,sizeof(t),t)
/** Check if an item with index \a idx and type \a t exist in array */
#define pw_array_check_index(a,idx,t)  pw_array_check_index_s(a,idx,sizeof(t))

#define pw_array_first(a) ((a)->data)
#define pw_array_end(a)  SPA_PTROFF((a)->data, (a)->size, void)
#define pw_array_check(a,p) (SPA_PTROFF(p,sizeof(*(p)),void) <= pw_array_end(a))

#define pw_array_for_each(pos, array)     \
 for ((pos) = (__typeof__(pos)) pw_array_first(array);  \
      pw_array_check(array, pos);    \
      (pos)++)

#define pw_array_consume(pos, array)     \
 for ((pos) = (__typeof__(pos)) pw_array_first(array);  \
      pw_array_check(array, pos);    \
      (pos) = (__typeof__(pos)) pw_array_first(array))

#define pw_array_remove(a,p)      \
({         \
 (a)->size -= sizeof(*(p));     \
 memmove(p, SPA_PTROFF((p), sizeof(*(p)), void),   \
                SPA_PTRDIFF(pw_array_end(a),(p)));   \
})

/** Initialize the array with given extend. Extend needs to be > 0 or else
 * the array will not be able to expand. */
PW_API_ARRAY void pw_array_init(struct pw_array *arr, size_t extend)
{
 arr->data = NULL;
 arr->size = arr->alloc = 0;
 arr->extend = extend;
}

/** Clear the array. This should be called when pw_array_init() was called.  */
PW_API_ARRAY void pw_array_clear(struct pw_array *arr)
{
 if (arr->extend > 0)
  free(arr->data);
 pw_array_init(arr, arr->extend);
}

/** Initialize a static array. */
PW_API_ARRAY void pw_array_init_static(struct pw_array *arr, void *data, size_t size)
{
 arr->data = data;
 arr->alloc = size;
 arr->size = arr->extend = 0;
}

/** Reset the array */
PW_API_ARRAY void pw_array_reset(struct pw_array *arr)
{
 arr->size = 0;
}

/** Make sure \a size bytes can be added to the array */
PW_API_ARRAY int pw_array_ensure_size(struct pw_array *arr, size_t size)
{
 size_t alloc, need;

 alloc = arr->alloc;
 need = arr->size + size;

 if (SPA_UNLIKELY(alloc < need)) {
  void *data;
  if (arr->extend == 0)
   return -ENOSPC;
  alloc = SPA_ROUND_UP(need, arr->extend);
  if (SPA_UNLIKELY((data = realloc(arr->data, alloc)) == NULL))
   return -errno;
  arr->data = data;
  arr->alloc = alloc;
 }
 return 0;
}

/** Add \a ref size bytes to \a arr. A pointer to memory that can
 * hold at least \a size bytes is returned or NULL when an error occurred
 * and errno will be set.*/
PW_API_ARRAY void *pw_array_add(struct pw_array *arr, size_t size)
{
 void *p;

 if (pw_array_ensure_size(arr, size) < 0)
  return NULL;

 p = SPA_PTROFF(arr->data, arr->size, void);
 arr->size += size;

 return p;
}

/** Add a pointer to array. Returns 0 on success and a negative errno style
 * error on failure. */
PW_API_ARRAY int pw_array_add_ptr(struct pw_array *arr, void *ptr)
{
 void **p = (void **)pw_array_add(arr, sizeof(void*));
 if (p == NULL)
  return -errno;
 *p = ptr;
 return 0;
}

/**
 * \}
 */

#ifdef __cplusplus
}  /* extern "C" */
#endif

#endif /* PIPEWIRE_ARRAY_H */