xaizek / libvle (License: GPLv3+) (since 2019-04-21)
Library for building Vim-like applications.
<root> / utils / darray.h (ceaf776c3f3560e6d67c46576f44425088fb7763) (3,379B) (mode 100644) [raw]
/* vifm
 * Copyright (C) 2015 xaizek.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * 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.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
 */

#ifndef VIFM__UTILS__DARRAY_H__
#define VIFM__UTILS__DARRAY_H__

/* Simple macros that wrap common operations on dynamic arrays. */

#include <assert.h> /* assert() */
#include <stddef.h> /* ptrdiff_t size_t */
#include <stdlib.h> /* free() */
#include <string.h> /* memcpy() */

#include "../compat/reallocarray.h"

/* Instantiates additional data for dynamic array implementation.  Usage
 * example:
 *   static int *array;
 *   static DA_INSTANCE(array); */
#define DA_INSTANCE(da) DA_INSTANCE_FIELD(da) = 0U

/* DA_INSTANCE equivalent for structures. */
#define DA_INSTANCE_FIELD(da) size_t da##_count__

/* Obtains lvalue of array size, its type is size_t. */
#define DA_SIZE(da) *(&da##_count__)

/* Extends array capacity (not size) by at least one more element.  Returns
 * pointer to the element or NULL on memory allocation error.  Once element data
 * is successfully initialized DA_COMMIT should be used to update size. */
#define DA_EXTEND(da) \
	({ \
		typeof(da) last = NULL; \
		void *const ptr = reallocarray(da, da##_count__ + 1U, sizeof(*da)); \
		if(ptr != NULL) \
		{ \
			da = ptr; \
			last = &da[da##_count__]; \
		} \
		last; \
	})

/* Increments array size, to be used in pair with DA_EXTEND.  Usage example:
 *   char **const string = DA_EXTEND(strings);
 *   if(string != NULL)
 *   {
 *     *string = strdup(str);
 *     if(*string != NULL)
 *     {
 *       DA_COMMIT(strings);
 *     }
 *   } */
#define DA_COMMIT(a) do { ++a##_count__; } while(0)

/* Removes item specified by pointer. */
#define DA_REMOVE(da, item) \
	do \
	{ \
		const typeof(da) it = item; \
		size_t i; \
		assert(it >= da && "Wrong item pointer."); \
		assert(it - da < (ptrdiff_t)da##_count__ && "Wrong item pointer."); \
		for(i = it - da + 1U; i < da##_count__; ++i) \
		{ \
			memcpy(&da[i - 1], &da[i], sizeof(*da)); \
		} \
		if(--da##_count__ == 0) \
		{ \
			free(da); \
			da = NULL; \
		} \
	} \
	while(0)

/* Removes all elements starting from and including the item. */
#define DA_REMOVE_AFTER(da, item) \
	do \
	{ \
		const typeof(da) it = item; \
		assert(it >= da && "Wrong item pointer."); \
		assert(it - da <= (ptrdiff_t)da##_count__ && "Wrong item pointer."); \
		da##_count__ = it - da; \
		if(da##_count__ == 0) \
		{ \
			free(da); \
			da = NULL; \
		} \
	} \
	while(0)

/* Empties the array freeing allocated memory. */
#define DA_REMOVE_ALL(da) \
	do \
	{ \
		da##_count__ = 0; \
		free(da); \
		da = NULL; \
	} \
	while(0)

#endif /* VIFM__UTILS__DARRAY_H__ */

/* vim: set tabstop=2 softtabstop=2 shiftwidth=2 noexpandtab cinoptions-=(0 : */
/* vim: set cinoptions+=t0 filetype=c : */
Hints

Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/libvle

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/libvle

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master