ccl-array.h

Go to the documentation of this file.

/*
 * ccl-array.h -- A kind of template for dynamic arrays
 * 
 * This file is a part of the C Common Library (CCL) project. 
 * 
 * Copyright (C) 2010 CNRS UMR 5800 & Université Bordeaux I (see AUTHORS file).
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the AltaRica Public License that comes with this
 * package.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
 */

#ifndef __CCL_ARRAY_H__
# define __CCL_ARRAY_H__

# include <ccl/ccl-common.h>
# include <ccl/ccl-memory.h>

BEGIN_C_DECLS

# define CCL_ARRAY(_t_) \
  struct {              \
    int size;           \
    _t_ *data; \
  }

# define ccl_array_init(_a_) \
  ccl_array_init_with_size(_a_, 0)


# define ccl_array_init_with_size(_a_,_sz_)  \
  do {                                       \
    (_a_).size = 0; (_a_).data = NULL;       \
    ccl_array_ensure_size (_a_, _sz_); \
  } while(0)

# define ccl_array_add(_a_,_el_)                        \
  do {                                                  \
    ccl_array_ensure_size (_a_, (_a_).size + 1);        \
    (_a_).data[(_a_).size-1] = _el_;                    \
  } while(0)

CCL_DECLARE_DELETE_PROC(ccl_array_delete_array);
# define ccl_array_delete(_a_) ccl_array_delete_array ((_a_).data)
# define ccl_array_clean_and_delete(_a_,_del_)                \
  do {                                                        \
    while ((_a_).size--) _del_ ((_a_).data[(_a_).size]);      \
    ccl_array_delete ((_a_));                                 \
  } while (0)

# define ccl_array_ensure_size(_a_,_sz_)                        \
  if ((_sz_) >= (_a_).size)                                     \
    ccl_array_resize(&(_a_).size, sizeof ((_a_).data[0]),       \
                     (void **) &((_a_).data),                   \
                     (_sz_), 0)

# define ccl_array_ensure_size_plus_one(_a_) \
  ccl_array_ensure_size (_a_, (_a_).size + 1)

# define ccl_array_trim(_a_,_sz_) \
  ccl_array_resize (&(_a_).size, sizeof ((_a_).data[0]), \
                    (void **) &((_a_).data), \
                   _sz_, 1)

# define ccl_array_trim_to_size(_a_) ccl_array_trim (_a_, (_a_).size)

extern void 
ccl_array_resize (int *poldsz, int elsz, void **data, int newsz, int trim);

END_C_DECLS

#endif /* ! __CCL_ARRAY_H__ */