Dynamic Array
[Base containers]

---

Detailed Description

A dynamic indexed array of VM data. The dynamic array grows automatically when set index is out of range. The get operation returns a nil value when index is out of range.

Data Structures
struct	_dynarray_t
Typedefs
typedef struct _dynarray_t *	dynarray_t
	An instance of a dynamic array of words.
typedef word_t	dynarray_index_t
	Type for dynarray indices.
typedef word_t	dynarray_value_t
	Type for dynarray values.
typedef dynarray_t	code_seg_t
	A code segment.
Functions
dynarray_t	dynarray_new ()
	Create a new array.
void	dynarray_init (dynarray_t)
	Init a newly allocated buffer.
void	dynarray_deinit (dynarray_t, void(*)(word_t))
	Deinit a dynamic array, after having executed the given callback on each element (callback may be NULL).
void	dynarray_del (dynarray_t)
	Delete a dynamic array.
void	dynarray_reserve (dynarray_t d, word_t new_size)
	Reserve new_size words for array d.
void	dynarray_set (dynarray_t, dynarray_index_t, dynarray_value_t)
	Set the value at given index.
dynarray_value_t	dynarray_get (dynarray_t, dynarray_index_t)
	Get the value at given index.
word_t	dynarray_size (dynarray_t)
	Get elements count.

---

Typedef Documentation

typedef struct _dynarray_t* dynarray_t

An instance of a dynamic array of words.

typedef word_t dynarray_index_t

Type for dynarray indices.

typedef word_t dynarray_value_t

Type for dynarray values.

typedef dynarray_t code_seg_t

A code segment.

---

Function Documentation

dynarray_t dynarray_new

(

)

Create a new array.

void dynarray_init

(

dynarray_t

)

Init a newly allocated buffer.

void dynarray_deinit	(	dynarray_t	,
		void(*)(word_t)
	)

Deinit a dynamic array, after having executed the given callback on each element (callback may be NULL).

void dynarray_del

(

dynarray_t

)

Delete a dynamic array.

void dynarray_reserve	(	dynarray_t	d,
		word_t	new_size
	)

Reserve new_size words for array d.

void dynarray_set	(	dynarray_t	,
		dynarray_index_t	,
		dynarray_value_t
	)

Set the value at given index.

Note:

Enlarges array as necessary.

dynarray_value_t dynarray_get	(	dynarray_t	,
		dynarray_index_t
	)

Get the value at given index.

word_t dynarray_size

(

dynarray_t

)

Get elements count.

---