drgn/libdrgn/array.h
Omar Sandoval 87b7292aa5 Relicense drgn from GPLv3+ to LGPLv2.1+
drgn is currently licensed as GPLv3+. Part of the long term vision for
drgn is that other projects can use it as a library providing
programmatic interfaces for debugger functionality. A more permissive
license is better suited to this goal. We decided on LGPLv2.1+ as a good
balance between software freedom and permissiveness.

All contributors not employed by Meta were contacted via email and
consented to the license change. The only exception was the author of
commit c4fbf7e589 ("libdrgn: fix for compilation error"), who did not
respond. That commit reverted a single line of code to one originally
written by me in commit 640b1c011d ("libdrgn: embed DWARF index in
DWARF info cache").

Signed-off-by: Omar Sandoval <osandov@osandov.com>
2022-11-01 17:05:16 -07:00

45 lines
921 B
C

// Copyright (c) Meta Platforms, Inc. and affiliates.
// SPDX-License-Identifier: LGPL-2.1-or-later
/**
* @file
*
* Helpers for C arrays.
*/
#ifndef DRGN_ARRAY_H
#define DRGN_ARRAY_H
#include "pp.h"
#include "util.h"
/** @cond */
#define array_for_each_impl(var, arr, unique_end) \
for (typeof((arr)[0]) *var = (arr), \
*unique_end = var + array_size(arr); \
var < unique_end; var++)
/** @endcond */
/**
* Return the number of elements in an array.
*
* @hideinitializer
*/
#define array_size(arr) \
static_assert_expression( \
!types_compatible((arr), &(arr)[0]), "not an array", \
sizeof(arr) / sizeof((arr)[0]) \
)
/**
* Iterate over every element in an array.
*
* The element is declared as `element_type *var` in the scope of the loop.
*
* @hideinitializer
*/
#define array_for_each(var, arr) \
array_for_each_impl(var, arr, PP_UNIQUE(end))
#endif /* DRGN_ARRAY_H */