Arrays

Macros
#define	NEW_ARR_F(type, nelts)
	Creates a flexible array.
#define	NEW_ARR_FZ(type, nelts)
	Create a flexible array and null its contents.
#define	DUP_ARR_F(type, arr)
	Duplicates an array and returns the new flexible one.
#define	NEW_ARR_D(type, obstack, nelts)
	Creates a dynamic array on an obstack.
#define	NEW_ARR_DZ(type, obstack, nelts)
	Create a dynamic array on an obstack and null its contents.
#define	DUP_ARR_D(type, obstack, arr)
	Duplicates an array and returns the new dynamic one.
#define	ARR_RESIZE(type, arr, n)
	Resize a flexible array, allocate more data if needed but do NOT reduce.
#define	ARR_SETLEN(type, arr, n)
	Resize a flexible array, always reallocate data.
#define	ARR_EXTEND(type, arr, delta)
	Resize a flexible array by growing it by delta elements.
#define	ARR_EXTO(type, arr, n)
	Resize a flexible array to hold n elements only if it is currently shorter than n.
#define	ARR_APP1(type, arr, elt)
	Append one element to a flexible array.

Functions
void	DEL_ARR_F (void *arr)
	Delete a flexible array.
static size_t	ARR_LEN (void const *const arr)
	Returns the length of an array.

Detailed Description

Macro Definition Documentation

ARR_APP1

#define ARR_APP1	(		type,
			arr,
			elt )

Value:

  (ARR_EXTEND(type, (arr), 1), (arr)[ARR_LEN((arr))-1] = (elt))

Append one element to a flexible array.

Parameters

type	The element type of the array.
arr	The array, which must be an lvalue.
elt	The new element, must be of type (type).

Definition at line 276 of file array.h.

ARR_EXTEND

#define ARR_EXTEND	(		type,
			arr,
			delta )

Value:

  ARR_RESIZE(type, (arr), ARR_LEN((arr)) + (delta))

Resize a flexible array by growing it by delta elements.

Parameters

type	The element type of the array.
arr	The array, which must be an lvalue.
delta	The delta number of elements.

Remarks

This macro may change arr, so update all references!

Definition at line 251 of file array.h.

ARR_EXTO

#define ARR_EXTO	(		type,
			arr,
			n )

Value:

    do { \
        if ((n) >= ARR_LEN(arr)) { ARR_RESIZE(type, arr, (n)+1); } \
    } while(0)

Resize a flexible array to hold n elements only if it is currently shorter than n.

Parameters

type	The element type of the array.
arr	The array, which must be an lvalue.
n	The new size of the array.

Remarks

This macro may change arr, so update all references!

Definition at line 264 of file array.h.

ARR_RESIZE

#define ARR_RESIZE	(		type,
			arr,
			n )

Value:

  ((arr) = (type*) ir_arr_resize((void *)(arr), (n), sizeof(type)))

Resize a flexible array, allocate more data if needed but do NOT reduce.

Parameters

type	The element type of the array.
arr	The array, which must be an lvalue.
n	The new size of the array.

Remarks

This macro may change arr, so update all references!

Definition at line 227 of file array.h.

ARR_SETLEN

#define ARR_SETLEN	(		type,
			arr,
			n )

Value:

  ((arr) = (type*) ir_arr_setlen((void *)(arr), (n), sizeof(type) * (n)))

Resize a flexible array, always reallocate data.

Parameters

type	The element type of the array.
arr	The array, which must be an lvalue.
n	The new size of the array.

Remarks

This macro may change arr, so update all references!

Definition at line 239 of file array.h.

DUP_ARR_D

#define DUP_ARR_D	(		type,
			obstack,
			arr )

Value:

  ((type*)memcpy(NEW_ARR_D(type, (obstack), ARR_LEN((arr))), (arr), sizeof(type) * ARR_LEN ((arr))))

Duplicates an array and returns the new dynamic one.

Parameters

type	The element type of the new array.
obstack	An struct obstack * were the data will be allocated
arr	An array from which the elements will be duplicated

This macro creates a dynamic array of a given type at runtime. The size of the array cannot be changed later.

Returns

A pointer to the dynamic array (can be used as a pointer to the first element of this array).

Definition at line 201 of file array.h.

DUP_ARR_F

#define DUP_ARR_F	(		type,
			arr )

Value:

  ((type*)memcpy(NEW_ARR_F(type, ARR_LEN((arr))), (arr), sizeof(type) * ARR_LEN((arr))))

Duplicates an array and returns the new flexible one.

Parameters

type	The element type of the new array.
arr	An array from which the elements will be duplicated

This macro creates a flexible array of a given type at runtime. The size of the array can be changed later.

Returns

A pointer to the flexible array (can be used as a pointer to the first element of this array).

Definition at line 155 of file array.h.

NEW_ARR_D

#define NEW_ARR_D	(		type,
			obstack,
			nelts )

Value:

  (  nelts                                                              \
   ? (type *)ir_new_arr_d((obstack), (nelts), sizeof(type) * (nelts))   \
   : (type *)arr_mt_descr.elts)

Creates a dynamic array on an obstack.

Parameters

type	The element type of the new array.
obstack	A struct obstack * were the data will be allocated
nelts	A size_t expression evaluating to the number of elements

This macro creates a dynamic array of a given type at runtime. The size of the array cannot be changed later.

Returns

A pointer to the dynamic array (can be used as a pointer to the first element of this array).

Definition at line 177 of file array.h.

NEW_ARR_DZ

#define NEW_ARR_DZ	(		type,
			obstack,
			nelts )

Value:

    ((type*)memset(NEW_ARR_D(type, (obstack), (nelts)), 0, sizeof(type) * (nelts)))

Create a dynamic array on an obstack and null its contents.

Definition at line 185 of file array.h.

NEW_ARR_F

#define NEW_ARR_F	(		type,
			nelts )

Value:

  ((type *)ir_new_arr_f((nelts), sizeof(type) * (nelts)))

Creates a flexible array.

Parameters

type	The element type of the new array.
nelts	a size_t expression evaluating to the number of elements

This macro creates a flexible array of a given type at runtime. The size of the array can be changed later.

Returns

A pointer to the flexible array (can be used as a pointer to the first element of this array).

Definition at line 134 of file array.h.

NEW_ARR_FZ

#define NEW_ARR_FZ	(		type,
			nelts )

Value:

    ((type*)memset(NEW_ARR_F(type, (nelts)), 0, sizeof(type) * (nelts)))

Create a flexible array and null its contents.

Definition at line 140 of file array.h.

Function Documentation

ARR_LEN()

static size_t ARR_LEN ( void const *const arr )

inlinestatic

Returns the length of an array.

Parameters

arr	a flexible, dynamic, automatic or static array.

Definition at line 209 of file array.h.

DEL_ARR_F()

void DEL_ARR_F

(

void *

arr

)

Delete a flexible array.

Parameters

arr	The flexible array.