106 lines
4.1 KiB
C
106 lines
4.1 KiB
C
/* struct-group.h - mirrored structure macros.
|
|
*
|
|
* Copyright (C) 2021-2024 Bruno Raoult ("br")
|
|
* Licensed under the GNU General Public License v3.0 or later.
|
|
* Some rights reserved. See COPYING.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along with this
|
|
* program. If not, see <https://www.gnu.org/licenses/gpl-3.0-standalone.html>.
|
|
*
|
|
* SPDX-License-Identifier: GPL-3.0-or-later <https://spdx.org/licenses/GPL-3.0-or-later.html>
|
|
*
|
|
* Some parts are taken from Linux's kernel <linux/stddef.h> and others, and are :
|
|
* SPDX-License-Identifier: GPL-2.0
|
|
*
|
|
*/
|
|
|
|
#ifndef _STRUCT_GROUP_H
|
|
#define _STRUCT_GROUP_H
|
|
|
|
/**
|
|
* __struct_group() - Create a mirrored named and anonyomous struct
|
|
*
|
|
* @TAG: The tag name for the named sub-struct (usually empty)
|
|
* @NAME: The identifier name of the mirrored sub-struct
|
|
* @ATTRS: Any struct attributes (usually empty)
|
|
* @MEMBERS: The member declarations for the mirrored structs
|
|
*
|
|
* Used to create an anonymous union of two structs with identical layout
|
|
* and size: one anonymous and one named. The former's members can be used
|
|
* normally without sub-struct naming, and the latter can be used to
|
|
* reason about the start, end, and size of the group of struct members.
|
|
* The named struct can also be explicitly tagged for layer reuse, as well
|
|
* as both having struct attributes appended.
|
|
*/
|
|
#define __struct_group(TAG, NAME, ATTRS, MEMBERS...) \
|
|
union { \
|
|
struct { MEMBERS } ATTRS; \
|
|
struct TAG { MEMBERS } ATTRS NAME; \
|
|
}
|
|
|
|
/**
|
|
* DECLARE_FLEX_ARRAY() - Declare a flexible array usable in a union
|
|
*
|
|
* @TYPE: The type of each flexible array element
|
|
* @NAME: The name of the flexible array member
|
|
*
|
|
* In order to have a flexible array member in a union or alone in a
|
|
* struct, it needs to be wrapped in an anonymous struct with at least 1
|
|
* named member, but that member can be empty.
|
|
*/
|
|
#define DECLARE_FLEX_ARRAY(TYPE, NAME) \
|
|
struct { \
|
|
struct { } __empty_ ## NAME; \
|
|
TYPE NAME[]; \
|
|
}
|
|
|
|
/**
|
|
* struct_group() - Wrap a set of declarations in a mirrored struct
|
|
*
|
|
* @NAME: The identifier name of the mirrored sub-struct
|
|
* @MEMBERS: The member declarations for the mirrored structs
|
|
*
|
|
* Used to create an anonymous union of two structs with identical
|
|
* layout and size: one anonymous and one named. The former can be
|
|
* used normally without sub-struct naming, and the latter can be
|
|
* used to reason about the start, end, and size of the group of
|
|
* struct members.
|
|
*/
|
|
#define struct_group(NAME, MEMBERS...) \
|
|
__struct_group(/* no tag */, NAME, /* no attrs */, MEMBERS)
|
|
|
|
/**
|
|
* struct_group_attr() - Create a struct_group() with trailing attributes
|
|
*
|
|
* @NAME: The identifier name of the mirrored sub-struct
|
|
* @ATTRS: Any struct attributes to apply
|
|
* @MEMBERS: The member declarations for the mirrored structs
|
|
*
|
|
* Used to create an anonymous union of two structs with identical
|
|
* layout and size: one anonymous and one named. The former can be
|
|
* used normally without sub-struct naming, and the latter can be
|
|
* used to reason about the start, end, and size of the group of
|
|
* struct members. Includes structure attributes argument.
|
|
*/
|
|
#define struct_group_attr(NAME, ATTRS, MEMBERS...) \
|
|
__struct_group(/* no tag */, NAME, ATTRS, MEMBERS)
|
|
|
|
/**
|
|
* struct_group_tagged() - Create a struct_group with a reusable tag
|
|
*
|
|
* @TAG: The tag name for the named sub-struct
|
|
* @NAME: The identifier name of the mirrored sub-struct
|
|
* @MEMBERS: The member declarations for the mirrored structs
|
|
*
|
|
* Used to create an anonymous union of two structs with identical
|
|
* layout and size: one anonymous and one named. The former can be
|
|
* used normally without sub-struct naming, and the latter can be
|
|
* used to reason about the start, end, and size of the group of
|
|
* struct members. Includes struct tag argument for the named copy,
|
|
* so the specified layout can be reused later.
|
|
*/
|
|
#define struct_group_tagged(TAG, NAME, MEMBERS...) \
|
|
__struct_group(TAG, NAME, /* no attrs */, MEMBERS)
|
|
|
|
#endif /* _STRUCT_GROUP_H */
|