Nilorea Library
C utilities for networking, threading, graphics
Loading...
Searching...
No Matches
n_enum.h
Go to the documentation of this file.
1/*
2 * Nilorea Library
3 * Copyright (C) 2005-2026 Castagnier Mickael
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
14 * implied. See the License for the specific language governing
15 * permissions and limitations under the License.
16 *
17 * SPDX-License-Identifier: Apache-2.0
18 */
19
28#ifndef __N_ENUM_HEADER__
29#define __N_ENUM_HEADER__
30
31#include <string.h> // for strcmp
32#include <stdbool.h>
33
34#ifdef __cplusplus
35extern "C" {
36#endif
37
43/* MACROS FOR N_ENUMS MACRO ENTRIES (START) */
44
46#define N_ENUM_ENTRY(class, method) class##__##method
47
49#define __N_ENUM_MACRO_ENTRY_CASE(element_name) case element_name:
51#define __N_ENUM_MACRO_ENTRY_COMPARE(element_name) if (!strcmp(#element_name, str_value))
53#define __N_ENUM_MACRO_ENTRY_COMPARE_EX(element_name) if (!strcmp(#element_name + index, str_value))
55#define __N_ENUM_MACRO_ENTRY_UNKNOWN_VALUE(enum_name) __##enum_name##_UNKNOWN_VALUE__
56
58#define __N_ENUM_MACRO_ENTRY_TO_ENUM_ELEMENT(element_name, element_value) \
59 element_name = element_value,
61#define __N_ENUM_MACRO_ENTRY_TO_ISVALID_CASE(element_name, element_value) \
62 __N_ENUM_MACRO_ENTRY_CASE(element_name) \
63 return true;
65#define __N_ENUM_MACRO_ENTRY_TO_TOSTRING_CASE(element_name, element_value) \
66 __N_ENUM_MACRO_ENTRY_CASE(element_name) \
67 return #element_name;
69#define __N_ENUM_MACRO_ENTRY_TO_FROMSTRING_COMPARE(element_name, element_value) \
70 __N_ENUM_MACRO_ENTRY_COMPARE(element_name) \
71 return element_name;
73#define __N_ENUM_MACRO_ENTRY_TO_FROMSTRING_COMPARE_EX(element_name, element_value) \
74 __N_ENUM_MACRO_ENTRY_COMPARE_EX(element_name) \
75 return element_name;
77#define __N_ENUM_MACRO_ENTRY_TO_ISSTRINGVALID_COMPARE(element_name, element_value) \
78 __N_ENUM_MACRO_ENTRY_COMPARE(element_name) \
79 return true;
80/* MACROS FOR N_ENUMS MACRO ENTRIES (END) */
81
82/* MACRO FOR ENUM DECLARATION (START) */
84#define __N_ENUM_DECLARE_ENUM(MACRO_DEFINITION, enum_name) \
85 typedef enum enum_name { \
86 MACRO_DEFINITION(__N_ENUM_MACRO_ENTRY_TO_ENUM_ELEMENT) \
87 __N_ENUM_MACRO_ENTRY_UNKNOWN_VALUE(enum_name) \
88 } enum_name;
89/* MACRO FOR ENUM DECLARATION (END) */
90
91/* MACRO FOR N_ENUMS FUNCTIONS * PREFIX : __N_ENUM_FUNCTION_ */
93#define __N_ENUM_DECLARE_FUNCTION(__N_ENUM_FUNCTION, enum_name) __N_ENUM_FUNCTION(enum_name); // MACRO for function declaration (just add ; after function)
95#define __N_ENUM_FUNCTION_ISVALID(enum_name) \
96 bool N_ENUM_ENTRY(enum_name, isValid)(enum_name value)
98#define __N_ENUM_FUNCTION_TOSTRING(enum_name) \
99 const char* N_ENUM_ENTRY(enum_name, toString)(enum_name value)
101#define __N_ENUM_FUNCTION_ISSTRINGVALID(enum_name) \
102 bool N_ENUM_ENTRY(enum_name, isStringValid)(const char* str_value)
104#define __N_ENUM_FUNCTION_FROMSTRING(enum_name) \
105 enum_name N_ENUM_ENTRY(enum_name, fromString)(const char* str_value)
107#define __N_ENUM_FUNCTION_FROMSTRING_EX(enum_name) \
108 enum_name N_ENUM_ENTRY(enum_name, fromStringEx)(const char* str_value, int index)
109/* MACRO FOR N_ENUMS FUNCTIONS (END) */
110
111/* MACRO FOR N_ENUMS FUNCTIONS DEFINITIONS * PREFIX : __N_ENUM_DEFINE_FUNCTION_ */
113#define __N_ENUM_DEFINE_FUNCTION_ISVALID(MACRO_DEFINITION, enum_name) \
114 __N_ENUM_FUNCTION_ISVALID(enum_name) { \
115 switch (value) { \
116 MACRO_DEFINITION(__N_ENUM_MACRO_ENTRY_TO_ISVALID_CASE) \
117 default: \
118 return false; \
119 } \
120 }
122#define __N_ENUM_DEFINE_FUNCTION_TOSTRING(MACRO_DEFINITION, enum_name) \
123 __N_ENUM_FUNCTION_TOSTRING(enum_name) { \
124 switch (value) { \
125 MACRO_DEFINITION(__N_ENUM_MACRO_ENTRY_TO_TOSTRING_CASE) \
126 default: \
127 return 0; \
128 } \
129 }
131#define __N_ENUM_DEFINE_FUNCTION_ISSTRINGVALID(MACRO_DEFINITION, enum_name) \
132 __N_ENUM_FUNCTION_ISSTRINGVALID(enum_name) { \
133 if (!str_value) return false; \
134 MACRO_DEFINITION(__N_ENUM_MACRO_ENTRY_TO_ISSTRINGVALID_COMPARE) \
135 return false; \
136 }
138#define __N_ENUM_DEFINE_FUNCTION_FROMSTRING(MACRO_DEFINITION, enum_name) \
139 __N_ENUM_FUNCTION_FROMSTRING(enum_name) { \
140 if (!str_value) return __N_ENUM_MACRO_ENTRY_UNKNOWN_VALUE(enum_name); \
141 MACRO_DEFINITION(__N_ENUM_MACRO_ENTRY_TO_FROMSTRING_COMPARE) \
142 return __N_ENUM_MACRO_ENTRY_UNKNOWN_VALUE(enum_name); \
143 }
145#define __N_ENUM_DEFINE_FUNCTION_FROMSTRING_EX(MACRO_DEFINITION, enum_name) \
146 __N_ENUM_FUNCTION_FROMSTRING_EX(enum_name) { \
147 if (!str_value) return __N_ENUM_MACRO_ENTRY_UNKNOWN_VALUE(enum_name); \
148 MACRO_DEFINITION(__N_ENUM_MACRO_ENTRY_TO_FROMSTRING_COMPARE_EX) \
149 return __N_ENUM_MACRO_ENTRY_UNKNOWN_VALUE(enum_name); \
150 }
151/* MACRO FOR N_ENUMS FUNCTIONS DEFINITIONS (END) */
152
153/* N_ENUM DECLARATION */
155#define N_ENUM_DECLARE(MACRO_DEFINITION, enum_name) \
156 __N_ENUM_DECLARE_ENUM(MACRO_DEFINITION, enum_name) \
157 __N_ENUM_DECLARE_FUNCTION(__N_ENUM_FUNCTION_ISVALID, enum_name) \
158 __N_ENUM_DECLARE_FUNCTION(__N_ENUM_FUNCTION_ISSTRINGVALID, enum_name) \
159 __N_ENUM_DECLARE_FUNCTION(__N_ENUM_FUNCTION_TOSTRING, enum_name) \
160 __N_ENUM_DECLARE_FUNCTION(__N_ENUM_FUNCTION_FROMSTRING, enum_name) \
161 __N_ENUM_DECLARE_FUNCTION(__N_ENUM_FUNCTION_FROMSTRING_EX, enum_name)
162/* N_ENUM DECLARATION (END) */
163
164/* N_ENUM DEFINITION */
166#define N_ENUM_DEFINE(MACRO_DEFINITION, enum_name) \
167 __N_ENUM_DEFINE_FUNCTION_ISVALID(MACRO_DEFINITION, enum_name) \
168 __N_ENUM_DEFINE_FUNCTION_ISSTRINGVALID(MACRO_DEFINITION, enum_name) \
169 __N_ENUM_DEFINE_FUNCTION_TOSTRING(MACRO_DEFINITION, enum_name) \
170 __N_ENUM_DEFINE_FUNCTION_FROMSTRING(MACRO_DEFINITION, enum_name) \
171 __N_ENUM_DEFINE_FUNCTION_FROMSTRING_EX(MACRO_DEFINITION, enum_name)
172/* N_ENUM DEFINITION (END) */
173
178#ifdef __cplusplus
179}
180#endif
181
182#endif // header guard