rockbox/tools/reggen_src/array.h
Aidan MacDonald 969a2b65c7 tools: add RegGen utility
This is a tool written in C which does basically the same job
as regtools' headergen_v2, but using a new input format which
is less verbose than XML. In the interests of simplicity it
omits some features that regtools does support, like variant
registers or the SoC selector stuff so it cannot completely
replace regtools on the i.MX platforms that use these features.

RegGen doesn't generate API macros like regtools does; instead
these are expected to be maintained by hand, since it's arguably
easier to do that way.

Since RegGen has no dependencies beyond a C compiler it can
be integrated with the build system without adding any new
build time dependencies. This will allow generating headers
automatically, which is a substantial improvement over running
headergen_v2 by hand and committing the generated output.

The RegGen tool itself is licensed as GPLv3+, but generated
headers can be licensed as the user chooses.

Change-Id: If18f9577f8f4df6e2c97c1665b725773dd5466f0
2025-12-29 18:51:56 -05:00

43 lines
1.3 KiB
C

/*
* This file is part of RegGen -- register definition generator
* Copyright (C) 2025 Aidan MacDonald
*
* 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 3 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, see <https://www.gnu.org/licenses/>.
*/
#ifndef REGGEN_ARRAY_H
#define REGGEN_ARRAY_H
#include <stddef.h>
/*
* Dynamically sized array
*/
struct array
{
void **data;
size_t size;
size_t capacity;
};
#define ARRAY_FOREACH(arr, value) \
for (size_t index##value = 0; index##value < (arr)->size; ++index##value) \
if (value = (arr)->data[index##value], 1)
void array_free(struct array *array);
void array_push(struct array *array, void *data);
void *array_pop(struct array *array);
size_t array_size(struct array *array);
void *array_get(struct array *array, size_t index);
#endif /* REGGEN_ARRAY_H */