icalmemory.h

Go to the documentation of this file.

/*======================================================================
 FILE: icalmemory.h
 CREATOR: eric 30 June 1999

 SPDX-FileCopyrightText: 2000, Eric Busboom <eric@civicknowledge.com>
 SPDX-License-Identifier: LGPL-2.1-only OR MPL-2.0

 The Initial Developer of the Original Code is Eric Busboom
======================================================================*/

#ifndef ICALMEMORY_H
#define ICALMEMORY_H

#include "libical_ical_export.h"

#include <stddef.h>

LIBICAL_ICAL_EXPORT void *icalmemory_tmp_buffer(size_t size);

LIBICAL_ICAL_EXPORT char *icalmemory_tmp_copy(const char *str);

LIBICAL_ICAL_EXPORT void icalmemory_add_tmp_buffer(void *buf);

LIBICAL_ICAL_EXPORT void icalmemory_free_ring(void);

typedef void *(*icalmemory_malloc_f)(size_t);
typedef void *(*icalmemory_realloc_f)(void *, size_t);
typedef void (*icalmemory_free_f)(void *);

LIBICAL_ICAL_EXPORT void icalmemory_set_mem_alloc_funcs(icalmemory_malloc_f f_malloc,
                                                        icalmemory_realloc_f f_realloc,
                                                        icalmemory_free_f f_free);

LIBICAL_ICAL_EXPORT void icalmemory_get_mem_alloc_funcs(icalmemory_malloc_f *f_malloc,
                                                        icalmemory_realloc_f *f_realloc, icalmemory_free_f *f_free);

LIBICAL_ICAL_EXPORT void *icalmemory_new_buffer(size_t size);

LIBICAL_ICAL_EXPORT void *icalmemory_resize_buffer(void *buf, size_t size);

LIBICAL_ICAL_EXPORT void icalmemory_free_buffer(void *buf);

/* THESE ROUTINES CAN NOT BE USED ON TMP BUFFERS. Only use them on
   normally allocated memory, or on buffers created from
   icalmemory_new_buffer, never with buffers created by
   icalmemory_tmp_buffer. If icalmemory_append_string has to resize a
   buffer on the ring, the ring will loose track of it and you will
   have memory problems. */

LIBICAL_ICAL_EXPORT void icalmemory_append_string(char **buf, char **pos, size_t *buf_size,
                                                  const char *string);

LIBICAL_ICAL_EXPORT void icalmemory_append_char(char **buf, char **pos, size_t *buf_size, char ch);

LIBICAL_ICAL_EXPORT char *icalmemory_strdup(const char *s);

LIBICAL_ICAL_EXPORT void icalmemory_append_encoded_string(char **buf, char **pos,
                                                          size_t *buf_size,
                                                          const char *string);
LIBICAL_ICAL_EXPORT void icalmemory_append_decoded_string(char **buf, char **pos,
                                                          size_t *buf_size,
                                                          const char *string);

#endif /* !ICALMEMORY_H */