v4/apidocs/icalarray_8h_source.html

/*======================================================================

 FILE: icalarray.h

 CREATOR: Damon Chaplin 07 March 2001


 SPDX-FileCopyrightText: 2001, Ximian, Inc.

 SPDX-License-Identifier: LGPL-2.1-only OR MPL-2.0

======================================================================*/


#ifndef ICALARRAY_H

#define ICALARRAY_H


#include "libical_ical_export.h"


#include <stddef.h>


typedef struct _icalarray icalarray;


struct _icalarray {

    size_t element_size;

    size_t increment_size;

    size_t num_elements;

    size_t space_allocated;

    void **chunks;

};


LIBICAL_ICAL_EXPORT icalarray *icalarray_new(size_t element_size, size_t increment_size);


LIBICAL_ICAL_EXPORT icalarray *icalarray_copy(const icalarray *array);


LIBICAL_ICAL_EXPORT void icalarray_free(icalarray *array);


LIBICAL_ICAL_EXPORT void icalarray_append(icalarray *array, const void *element);


LIBICAL_ICAL_EXPORT void icalarray_remove_element_at(icalarray *array, size_t position);


LIBICAL_ICAL_EXPORT void *icalarray_element_at(icalarray *array, size_t position);


LIBICAL_ICAL_EXPORT void icalarray_set_element_at(icalarray *array, const void *element, size_t position);


LIBICAL_ICAL_EXPORT void icalarray_sort(icalarray *array,

                                        int (*compare)(const void *, const void *));


#endif /* ICALARRAY_H */

icalarray
struct _icalarray icalarray
A struct representing an icalarray object.
Definition icalarray.h:26

icalarray_copy
icalarray * icalarray_copy(const icalarray *array)
Copies an existing icalarray and its elements, creating a new one.
Definition icalarray.c:60

icalarray_element_at
void * icalarray_element_at(icalarray *array, size_t position)
Access an array element.
Definition icalarray.c:126

icalarray_free
void icalarray_free(icalarray *array)
Frees an array object and everything that it contains.
Definition icalarray.c:95

icalarray_sort
void icalarray_sort(icalarray *array, int(*compare)(const void *, const void *))
Sorts the elements of an icalarray using the given comparison function.
Definition icalarray.c:173

icalarray_append
void icalarray_append(icalarray *array, const void *element)
Appends an element to an array.
Definition icalarray.c:110

icalarray_set_element_at
void icalarray_set_element_at(icalarray *array, const void *element, size_t position)
Overwrites an existing element in an array with a new value.
Definition icalarray.c:134

icalarray_new
icalarray * icalarray_new(size_t element_size, size_t increment_size)
Creates a new icalarray object.
Definition icalarray.c:27

icalarray_remove_element_at
void icalarray_remove_element_at(icalarray *array, size_t position)
Removes a given element from an array.
Definition icalarray.c:139

_icalarray
Definition icalarray.h:27