blob: 4dcbfffec2ff1e33037ef5000b5c09cd26dad997 [file] [log] [blame]
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001/**
2 * @file common.h
3 * @author Radek Krejci <rkrejci@cesnet.cz>
4 * @brief common internal definitions for libyang
5 *
6 * Copyright (c) 2015 - 2018 CESNET, z.s.p.o.
7 *
8 * This source code is licensed under BSD 3-Clause License (the "License").
9 * You may not use this file except in compliance with the License.
10 * You may obtain a copy of the License at
11 *
12 * https://opensource.org/licenses/BSD-3-Clause
13 */
14
15#ifndef LY_COMMON_H_
16#define LY_COMMON_H_
17
Radek Krejcib7db73a2018-10-24 14:18:40 +020018#define _DEFAULT_SOURCE
19#define _GNU_SOURCE
20#define _XOPEN_SOURCE
21
Radek Krejci151a5b72018-10-19 14:21:44 +020022#include <assert.h>
Radek Krejci6caa6ab2018-10-24 10:04:48 +020023#include <pthread.h>
Radek Krejci5aeea3a2018-09-05 13:29:36 +020024#include <stdint.h>
25#include <stdlib.h>
26
Radek Krejci2c22f122018-09-05 15:08:03 +020027#include "config.h"
Radek Krejciad573502018-09-07 15:26:55 +020028#include "log.h"
Radek Krejcid33273d2018-10-25 14:55:52 +020029#include "context.h"
Radek Krejcic59bc972018-09-17 16:13:06 +020030#include "tree_schema.h"
Radek Krejci6caa6ab2018-10-24 10:04:48 +020031#include "set.h"
32#include "hash_table.h"
Radek Krejci5aeea3a2018-09-05 13:29:36 +020033
34#if __STDC_VERSION__ >= 201112 && !defined __STDC_NO_THREADS__
35# define THREAD_LOCAL _Thread_local
36#elif defined __GNUC__ || \
37 defined __SUNPRO_C || \
38 defined __xlC__
39# define THREAD_LOCAL __thread
40#else
41# error "Cannot define THREAD_LOCAL"
42#endif
43
Radek Krejcic59bc972018-09-17 16:13:06 +020044#define GETMACRO1(_1, NAME, ...) NAME
Radek Krejci5aeea3a2018-09-05 13:29:36 +020045#define GETMACRO2(_1, _2, NAME, ...) NAME
46#define GETMACRO3(_1, _2, _3, NAME, ...) NAME
47#define GETMACRO4(_1, _2, _3, _4, NAME, ...) NAME
48
49/*
Radek Krejcic59bc972018-09-17 16:13:06 +020050 * If the compiler supports attribute to mark objects as hidden, mark all
51 * objects as hidden and export only objects explicitly marked to be part of
52 * the public API.
Radek Krejci5aeea3a2018-09-05 13:29:36 +020053 */
Radek Krejcic59bc972018-09-17 16:13:06 +020054#define API __attribute__((visibility("default")))
55
56/******************************************************************************
57 * Logger
58 *****************************************************************************/
Radek Krejci5aeea3a2018-09-05 13:29:36 +020059
60/* internal logging options */
61enum int_log_opts {
62 ILO_LOG = 0, /* log normally */
63 ILO_STORE, /* only store any messages, they will be processed higher on stack */
64 ILO_IGNORE, /* completely ignore messages */
65 ILO_ERR2WRN, /* change errors to warnings */
66};
67
Radek Krejci94aa9942018-09-07 17:12:17 +020068enum LY_VLOG_ELEM {
69 LY_VLOG_NONE = 0,
70 LY_VLOG_LINE,/* line number */
71 LY_VLOG_LYS, /* struct lysc_node* */
72 LY_VLOG_LYD, /* struct lyd_node* */
73 LY_VLOG_STR, /* const char* */
74 LY_VLOG_PREV /* use exact same previous path */
75};
76
Radek Krejci5aeea3a2018-09-05 13:29:36 +020077extern THREAD_LOCAL enum int_log_opts log_opt;
78extern volatile uint8_t ly_log_level;
79extern volatile uint8_t ly_log_opts;
80
Radek Krejciad573502018-09-07 15:26:55 +020081void ly_err_free(void *ptr);
Radek Krejci5aeea3a2018-09-05 13:29:36 +020082void ly_log(const struct ly_ctx *ctx, LY_LOG_LEVEL level, LY_ERR no, const char *format, ...);
Radek Krejci94aa9942018-09-07 17:12:17 +020083void ly_vlog(const struct ly_ctx *ctx, enum LY_VLOG_ELEM elem_type, const void *elem, LY_VECODE code, const char *format, ...);
Radek Krejci5aeea3a2018-09-05 13:29:36 +020084
85#define LOGERR(ctx, errno, str, args...) ly_log(ctx, LY_LLERR, errno, str, ##args)
86#define LOGWRN(ctx, str, args...) ly_log(ctx, LY_LLWRN, 0, str, ##args)
87#define LOGVRB(str, args...) ly_log(NULL, LY_LLVRB, 0, str, ##args)
88
Radek Krejci4ab61562018-09-05 15:00:37 +020089#ifdef NDEBUG
90# define LOGDBG(dbg_group, str, args...)
91#else
92 void ly_log_dbg(int group, const char *format, ...);
93# define LOGDBG(dbg_group, str, args...) ly_log_dbg(dbg_group, str, ##args);
94#endif
95
Radek Krejci5aeea3a2018-09-05 13:29:36 +020096#define LOGMEM(CTX) LOGERR(CTX, LY_EMEM, "Memory allocation failed (%s()).", __func__)
97#define LOGINT(CTX) LOGERR(CTX, LY_EINT, "Internal error (%s:%d).", __FILE__, __LINE__)
98#define LOGARG(CTX, ARG) LOGERR(CTX, LY_EINVAL, "Invalid argument %s (%s()).", #ARG, __func__)
Radek Krejcic07921a2018-09-17 11:40:15 +020099#define LOGVAL(CTX, ELEM_TYPE, ELEM, CODE, FORMAT...) ly_vlog(CTX, ELEM_TYPE, ELEM, CODE, ##FORMAT)
Radek Krejci94aa9942018-09-07 17:12:17 +0200100
101#define LOGMEM_RET(CTX) LOGMEM(CTX); return LY_EMEM
102#define LOGINT_RET(CTX) LOGINT(CTX); return LY_EINT
103#define LOGARG_RET(CTX) LOGARG(CTX); return LY_EINVAL
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200104
105/*
106 * Common code to check return value and perform appropriate action.
107 */
108#define LY_CHECK_GOTO(COND, GOTO) if (COND) {goto GOTO;}
109#define LY_CHECK_ERR_GOTO(COND, ERR, GOTO) if (COND) {ERR; goto GOTO;}
Radek Krejci6d9b9b52018-11-02 12:43:39 +0100110#define LY_CHECK_RET1(RETVAL) {LY_ERR ret__ = RETVAL;if (ret__ != LY_SUCCESS) {return ret__;}}
Radek Krejcic59bc972018-09-17 16:13:06 +0200111#define LY_CHECK_RET2(COND, RETVAL) if (COND) {return RETVAL;}
112#define LY_CHECK_RET(...) GETMACRO2(__VA_ARGS__, LY_CHECK_RET2, LY_CHECK_RET1)(__VA_ARGS__)
Michal Vaskob3d0d6b2018-09-07 10:17:33 +0200113#define LY_CHECK_ERR_RET(COND, ERR, RETVAL) if (COND) {ERR; return RETVAL;}
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200114
Michal Vaskob3d0d6b2018-09-07 10:17:33 +0200115#define LY_CHECK_ARG_GOTO1(CTX, ARG, GOTO) if (!ARG) {LOGARG(CTX, ARG);goto GOTO;}
116#define LY_CHECK_ARG_GOTO2(CTX, ARG1, ARG2, GOTO) LY_CHECK_ARG_GOTO1(CTX, ARG1, GOTO);LY_CHECK_ARG_GOTO1(CTX, ARG2, GOTO)
117#define LY_CHECK_ARG_GOTO3(CTX, ARG1, ARG2, ARG3, GOTO) LY_CHECK_ARG_GOTO2(CTX, ARG1, ARG2, GOTO);LY_CHECK_ARG_GOTO1(CTX, ARG3, GOTO)
118#define LY_CHECK_ARG_GOTO(CTX, ...) GETMACRO4(__VA_ARGS__, LY_CHECK_ARG_GOTO3, LY_CHECK_ARG_GOTO2, LY_CHECK_ARG_GOTO1)(CTX, __VA_ARGS__)
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200119
Michal Vaskob3d0d6b2018-09-07 10:17:33 +0200120#define LY_CHECK_ARG_RET1(CTX, ARG, RETVAL) if (!ARG) {LOGARG(CTX, ARG);return RETVAL;}
121#define LY_CHECK_ARG_RET2(CTX, ARG1, ARG2, RETVAL) LY_CHECK_ARG_RET1(CTX, ARG1, RETVAL);LY_CHECK_ARG_RET1(CTX, ARG2, RETVAL)
122#define LY_CHECK_ARG_RET3(CTX, ARG1, ARG2, ARG3, RETVAL) LY_CHECK_ARG_RET2(CTX, ARG1, ARG2, RETVAL);LY_CHECK_ARG_RET1(CTX, ARG3, RETVAL)
123#define LY_CHECK_ARG_RET(CTX, ...) GETMACRO4(__VA_ARGS__, LY_CHECK_ARG_RET3, LY_CHECK_ARG_RET2, LY_CHECK_ARG_RET1)(CTX, __VA_ARGS__)
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200124
Radek Krejcid972c252018-09-25 13:23:39 +0200125/* count sequence size for LY_VCODE_INCHILDSTMT validation error code */
126size_t LY_VCODE_INSTREXP_len(const char *str);
127/* default maximum characters to print in LY_VCODE_INCHILDSTMT */
128#define LY_VCODE_INSTREXP_MAXLEN 20
129
Michal Vasko58257712018-09-12 11:11:38 +0200130#define LY_VCODE_INCHAR LYVE_SYNTAX, "Invalid character 0x%x."
Michal Vasko37d705c2018-09-12 15:31:26 +0200131#define LY_VCODE_INSTREXP LYVE_SYNTAX, "Invalid character sequence \"%.*s\", expected %s."
Michal Vasko58257712018-09-12 11:11:38 +0200132#define LY_VCODE_EOF LYVE_SYNTAX, "Unexpected end-of-file."
Radek Krejcid91dbaf2018-09-21 15:51:39 +0200133#define LY_VCODE_NTERM LYVE_SYNTAX, "%s not terminated."
134#define LY_VCODE_NSUPP LYVE_SYNTAX, "%s not supported."
Radek Krejci94aa9942018-09-07 17:12:17 +0200135#define LY_VCODE_INSTMT LYVE_SYNTAX_YANG, "Invalid keyword \"%s\"."
Michal Vasko58257712018-09-12 11:11:38 +0200136#define LY_VCODE_INCHILDSTMT LYVE_SYNTAX_YANG, "Invalid keyword \"%s\" as a child of \"%s\"."
137#define LY_VCODE_DUPSTMT LYVE_SYNTAX_YANG, "Duplicate keyword \"%s\"."
Radek Krejcifaa1eac2018-10-30 14:34:55 +0100138#define LY_VCODE_DUPIDENT LYVE_SYNTAX_YANG, "Duplicate identifier \"%s\" of %s statement."
Michal Vasko37d705c2018-09-12 15:31:26 +0200139#define LY_VCODE_INVAL LYVE_SYNTAX_YANG, "Invalid value \"%.*s\" of \"%s\"."
Michal Vasko58257712018-09-12 11:11:38 +0200140#define LY_VCODE_MISSTMT LYVE_SYNTAX_YANG, "Missing mandatory keyword \"%s\" as a child of \"%s\"."
141#define LY_VCODE_INORD LYVE_SYNTAX_YANG, "Invalid keyword \"%s\", it cannot appear after \"%s\"."
Michal Vasko37d705c2018-09-12 15:31:26 +0200142#define LY_VCODE_OOB LYVE_SYNTAX_YANG, "Value \"%.*s\" is out of \"%s\" bounds."
Michal Vasko58257712018-09-12 11:11:38 +0200143#define LY_VCODE_INDEV LYVE_SYNTAX_YANG, "Deviate \"%s\" does not support keyword \"%s\"."
Radek Krejci94aa9942018-09-07 17:12:17 +0200144
Radek Krejcic59bc972018-09-17 16:13:06 +0200145/******************************************************************************
Radek Krejci6caa6ab2018-10-24 10:04:48 +0200146 * Context
147 *****************************************************************************/
148
149/**
150 * @brief Context of the YANG schemas
151 */
152struct ly_ctx {
153 struct dict_table dict; /**< dictionary to effectively store strings used in the context related structures */
154 struct ly_set search_paths; /**< set of directories where to search for schema's imports/includes */
155 struct ly_set list; /**< set of YANG schemas */
Radek Krejcid33273d2018-10-25 14:55:52 +0200156 ly_module_imp_clb imp_clb; /**< Optional callback for retrieving missing included or imported models in a custom way. */
157 void *imp_clb_data; /**< Optional private data for imp_clb() */
Radek Krejci6caa6ab2018-10-24 10:04:48 +0200158 uint16_t module_set_id; /**< ID of the current set of schemas */
159 uint16_t flags; /**< context settings, see @ref contextoptions. */
160 pthread_key_t errlist_key; /**< key for the thread-specific list of errors related to the context */
161};
162
Radek Krejcid33273d2018-10-25 14:55:52 +0200163/**
164 * @brief Try to find submodule in the context. Submodules are present only in the parsed (lysp_) schema trees, if only
165 * the compiled versions of the schemas are present, the submodule cannot be returned even if it was used to compile
166 * some of the currently present schemas.
167 *
168 * @param[in] ctx Context where to search
Radek Krejcifaa1eac2018-10-30 14:34:55 +0100169 * @param[in] module Name of the module where the submodule is supposed to belongs-to. If NULL, the module name is not checked.
Radek Krejcid33273d2018-10-25 14:55:52 +0200170 * @param[in] submodule Name of the submodule to find.
171 * @param[in] revision Optional revision of the submodule to find. If not specified, the latest revision is returned.
172 * @return Pointer to the specified submodule if it is present in the context.
173 */
174struct lysp_module *ly_ctx_get_submodule(const struct ly_ctx *ctx, const char *module, const char *submodule, const char *revision);
175
Radek Krejci6caa6ab2018-10-24 10:04:48 +0200176/******************************************************************************
Radek Krejcic59bc972018-09-17 16:13:06 +0200177 * Parsers
178 *****************************************************************************/
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200179
Radek Krejcic59bc972018-09-17 16:13:06 +0200180enum yang_keyword {
181 YANG_NONE = 0,
182 YANG_ACTION,
183 YANG_ANYDATA,
184 YANG_ANYXML,
185 YANG_ARGUMENT,
186 YANG_AUGMENT,
187 YANG_BASE,
188 YANG_BELONGS_TO,
189 YANG_BIT,
190 YANG_CASE,
191 YANG_CHOICE,
192 YANG_CONFIG,
193 YANG_CONTACT,
194 YANG_CONTAINER,
195 YANG_DEFAULT,
196 YANG_DESCRIPTION,
197 YANG_DEVIATE,
198 YANG_DEVIATION,
199 YANG_ENUM,
200 YANG_ERROR_APP_TAG,
201 YANG_ERROR_MESSAGE,
202 YANG_EXTENSION,
203 YANG_FEATURE,
204 YANG_FRACTION_DIGITS,
205 YANG_GROUPING,
206 YANG_IDENTITY,
207 YANG_IF_FEATURE,
208 YANG_IMPORT,
209 YANG_INCLUDE,
210 YANG_INPUT,
211 YANG_KEY,
212 YANG_LEAF,
213 YANG_LEAF_LIST,
214 YANG_LENGTH,
215 YANG_LIST,
216 YANG_MANDATORY,
217 YANG_MAX_ELEMENTS,
218 YANG_MIN_ELEMENTS,
219 YANG_MODIFIER,
220 YANG_MODULE,
221 YANG_MUST,
222 YANG_NAMESPACE,
223 YANG_NOTIFICATION,
224 YANG_ORDERED_BY,
225 YANG_ORGANIZATION,
226 YANG_OUTPUT,
227 YANG_PATH,
228 YANG_PATTERN,
229 YANG_POSITION,
230 YANG_PREFIX,
231 YANG_PRESENCE,
232 YANG_RANGE,
233 YANG_REFERENCE,
234 YANG_REFINE,
235 YANG_REQUIRE_INSTANCE,
236 YANG_REVISION,
237 YANG_REVISION_DATE,
238 YANG_RPC,
239 YANG_STATUS,
240 YANG_SUBMODULE,
241 YANG_TYPE,
242 YANG_TYPEDEF,
243 YANG_UNIQUE,
244 YANG_UNITS,
245 YANG_USES,
246 YANG_VALUE,
247 YANG_WHEN,
248 YANG_YANG_VERSION,
249 YANG_YIN_ELEMENT,
250
251 YANG_SEMICOLON,
252 YANG_LEFT_BRACE,
253 YANG_RIGHT_BRACE,
254 YANG_CUSTOM
255};
256
257/* list of the YANG statements strings */
258extern const char *const ly_stmt_list[];
259#define ly_stmt2str(STMT) ly_stmt_list[STMT]
260
261/* list of the extensions' substatements strings */
262extern const char *const lyext_substmt_list[];
263#define lyext_substmt2str(STMT) lyext_substmt_list[STMT]
264
265/* list of the deviate modifications strings */
266extern const char *const ly_devmod_list[];
267#define ly_devmod2str(TYPE) ly_devmod_list[TYPE]
268
269/******************************************************************************
Michal Vasko1324b6c2018-09-07 11:16:23 +0200270 * Generic useful functions.
Radek Krejcic59bc972018-09-17 16:13:06 +0200271 *****************************************************************************/
Michal Vasko1324b6c2018-09-07 11:16:23 +0200272
273/**
274 * @brief Wrapper for realloc() call. The only difference is that if it fails to
275 * allocate the requested memory, the original memory is freed as well.
276 *
277 * @param[in] ptr Memory to reallocate.
278 * @param[in] size New size of the memory block.
279 *
280 * @return Pointer to the new memory, NULL on error.
281 */
282void *ly_realloc(void *ptr, size_t size);
283
Radek Krejcif345c012018-09-19 11:12:59 +0200284/**
Radek Krejcib416be62018-10-01 14:51:45 +0200285 * @brief Get UTF8 code point of the next character in the input string.
286 *
287 * @param[in,out] input Input string to process, updated according to the processed/read data.
288 * @param[out] utf8_char UTF8 code point of the next character.
289 * @param[out] bytes_read Number of bytes used to encode the read utf8_char.
290 * @return LY_ERR value
291 */
292LY_ERR ly_getutf8(const char **input, unsigned int *utf8_char, size_t *bytes_read);
293
294/**
Radek Krejci86d106e2018-10-18 09:53:19 +0200295 * @brief mmap(2) wrapper to map input files into memory to unify parsing.
Radek Krejcif345c012018-09-19 11:12:59 +0200296 *
Radek Krejci86d106e2018-10-18 09:53:19 +0200297 * The address space is allocate only for reading.
298 *
299 * @param[in] ctx libyang context for logging
300 * @param[in] fd Open file descriptor of a file to map.
301 * @param[out] length Allocated size.
302 * @param[out] addr Address where the file is mapped.
Radek Krejcif345c012018-09-19 11:12:59 +0200303 * @return LY_ERR value.
304 */
Radek Krejci86d106e2018-10-18 09:53:19 +0200305LY_ERR ly_mmap(struct ly_ctx *ctx, int fd, size_t *length, void **addr);
Michal Vasko841d1a92018-09-07 15:40:31 +0200306
Radek Krejci86d106e2018-10-18 09:53:19 +0200307/**
308 * @brief munmap(2) wrapper to free the memory mapped by ly_mmap()
Michal Vasko1324b6c2018-09-07 11:16:23 +0200309 *
Radek Krejci86d106e2018-10-18 09:53:19 +0200310 * @param[in] addr Address where the input file is mapped.
311 * @param[in] length Allocated size of the address space.
312 * @return LY_ERR value.
313 */
314LY_ERR ly_munmap(void *addr, size_t length);
315
316/**
317 * @brief (Re-)Allocation of a ([sized array](@ref sizedarrays)).
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200318 *
Radek Krejci2c4e7172018-10-19 15:56:26 +0200319 * Increases the size information.
320 *
Radek Krejci86d106e2018-10-18 09:53:19 +0200321 * @param[in] CTX libyang context for logging.
Radek Krejci2c4e7172018-10-19 15:56:26 +0200322 * @param[in,out] ARRAY Pointer to the array to allocate/resize. The size of the allocated
323 * space is counted from the type of the ARRAY, so do not provide placeholder void pointers.
Radek Krejci86d106e2018-10-18 09:53:19 +0200324 * @param[out] NEW_ITEM Returning pointer to the newly allocated record in the ARRAY.
325 * @param[in] RETVAL Return value for the case of error (memory allocation failure).
Michal Vasko1324b6c2018-09-07 11:16:23 +0200326 */
Radek Krejci2c4e7172018-10-19 15:56:26 +0200327#define LY_ARRAY_NEW_RET(CTX, ARRAY, NEW_ITEM, RETVAL) \
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200328 if (!(ARRAY)) { \
329 ARRAY = malloc(sizeof(uint32_t) + sizeof *(ARRAY)); \
330 *((uint32_t*)(ARRAY)) = 1; \
331 } else { \
Radek Krejci2c4e7172018-10-19 15:56:26 +0200332 ++(*((uint32_t*)(ARRAY) - 1)); \
333 ARRAY = ly_realloc(((uint32_t*)(ARRAY) - 1), sizeof(uint32_t) + (*((uint32_t*)(ARRAY) - 1) * sizeof *(ARRAY))); \
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200334 LY_CHECK_ERR_RET(!(ARRAY), LOGMEM(CTX), RETVAL); \
335 } \
Radek Krejci2c4e7172018-10-19 15:56:26 +0200336 ARRAY = (void*)((uint32_t*)(ARRAY) + 1); \
337 (NEW_ITEM) = &(ARRAY)[*((uint32_t*)(ARRAY) - 1) - 1]; \
338 memset(NEW_ITEM, 0, sizeof *(NEW_ITEM))
Michal Vasko1324b6c2018-09-07 11:16:23 +0200339
Radek Krejci2c4e7172018-10-19 15:56:26 +0200340/**
341 * @brief Allocate a ([sized array](@ref sizedarrays)) for the specified number of items.
342 *
343 * Does not set the size information, it is supposed to be incremented via ::LY_ARRAY_INCREMENT
344 * when the items are filled.
345 *
346 * @param[in] CTX libyang context for logging.
347 * @param[in,out] ARRAY Pointer to the array to create.
348 * @param[in] SIZE Number of items the array is supposed to hold. The size of the allocated
349 * space is then counted from the type of the ARRAY, so do not provide placeholder void pointers.
350 * @param[in] RETVAL Return value for the case of error (memory allocation failure).
351 */
352#define LY_ARRAY_CREATE_RET(CTX, ARRAY, SIZE, RETVAL) \
353 ARRAY = calloc(1, sizeof(uint32_t) + SIZE * sizeof *(ARRAY)); \
354 LY_CHECK_ERR_RET(!(ARRAY), LOGMEM(CTX), RETVAL); \
355 ARRAY = (void*)((uint32_t*)(ARRAY) + 1)
356
Radek Krejci6d6e4e42018-10-29 13:28:19 +0100357/**
358 * @brief Allocate a ([sized array](@ref sizedarrays)) for the specified number of items.
359 *
360 * Does not set the size information, it is supposed to be incremented via ::LY_ARRAY_INCREMENT
361 * when the items are filled.
362 *
363 * @param[in] CTX libyang context for logging.
364 * @param[in,out] ARRAY Pointer to the array to create.
365 * @param[in] SIZE Number of items the array is supposed to hold. The size of the allocated
366 * space is then counted from the type of the ARRAY, so do not provide placeholder void pointers.
367 * @param[out] RET Variable to store error code.
368 * @param[in] GOTO Label to go in case of error (memory allocation failure).
369 */
370#define LY_ARRAY_CREATE_GOTO(CTX, ARRAY, SIZE, RET, GOTO) \
371 ARRAY = calloc(1, sizeof(uint32_t) + SIZE * sizeof *(ARRAY)); \
372 LY_CHECK_ERR_GOTO(!(ARRAY), LOGMEM(CTX); RET = LY_EMEM, GOTO); \
373 ARRAY = (void*)((uint32_t*)(ARRAY) + 1)
374
Radek Krejci2c4e7172018-10-19 15:56:26 +0200375#define LY_ARRAY_INCREMENT(ARRAY) \
376 ++(*((uint32_t*)(ARRAY) - 1))
377/**
378 * @brief Free the space allocated for the ([sized array](@ref sizedarrays)).
379 *
380 * The items inside the array are not freed.
381 *
382 * @param[in] ARRAY A ([sized array](@ref sizedarrays)) to be freed.
383 */
384#define LY_ARRAY_FREE(ARRAY) \
385 if (ARRAY){free((uint32_t*)(ARRAY) - 1);}
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200386#endif /* LY_COMMON_H_ */