124 lines
4.6 KiB
C
124 lines
4.6 KiB
C
|
/*===---- stddef.h - Basic type definitions --------------------------------===
|
||
|
*
|
||
|
* Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
||
|
* See https://llvm.org/LICENSE.txt for license information.
|
||
|
* SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
||
|
*
|
||
|
*===-----------------------------------------------------------------------===
|
||
|
*/
|
||
|
|
||
|
/*
|
||
|
* This header is designed to be included multiple times. If any of the __need_
|
||
|
* macros are defined, then only that subset of interfaces are provided. This
|
||
|
* can be useful for POSIX headers that need to not expose all of stddef.h, but
|
||
|
* need to use some of its interfaces. Otherwise this header provides all of
|
||
|
* the expected interfaces.
|
||
|
*
|
||
|
* When clang modules are enabled, this header is a textual header. It ignores
|
||
|
* its header guard so that multiple submodules can export its interfaces.
|
||
|
* Take module SM with submodules A and B, whose headers both include stddef.h
|
||
|
* When SM.A builds, __STDDEF_H will be defined. When SM.B builds, the
|
||
|
* definition from SM.A will leak when building without local submodule
|
||
|
* visibility. stddef.h wouldn't include any of its implementation headers, and
|
||
|
* SM.B wouldn't import any of the stddef modules, and SM.B's `export *`
|
||
|
* wouldn't export any stddef interfaces as expected. However, since stddef.h
|
||
|
* ignores its header guard when building with modules, it all works as
|
||
|
* expected.
|
||
|
*
|
||
|
* When clang modules are not enabled, the header guards can function in the
|
||
|
* normal simple fashion.
|
||
|
*/
|
||
|
#if !defined(__STDDEF_H) || __has_feature(modules) || \
|
||
|
(defined(__STDC_WANT_LIB_EXT1__) && __STDC_WANT_LIB_EXT1__ >= 1) || \
|
||
|
defined(__need_ptrdiff_t) || defined(__need_size_t) || \
|
||
|
defined(__need_rsize_t) || defined(__need_wchar_t) || \
|
||
|
defined(__need_NULL) || defined(__need_nullptr_t) || \
|
||
|
defined(__need_unreachable) || defined(__need_max_align_t) || \
|
||
|
defined(__need_offsetof) || defined(__need_wint_t)
|
||
|
|
||
|
#if !defined(__need_ptrdiff_t) && !defined(__need_size_t) && \
|
||
|
!defined(__need_rsize_t) && !defined(__need_wchar_t) && \
|
||
|
!defined(__need_NULL) && !defined(__need_nullptr_t) && \
|
||
|
!defined(__need_unreachable) && !defined(__need_max_align_t) && \
|
||
|
!defined(__need_offsetof) && !defined(__need_wint_t)
|
||
|
#define __STDDEF_H
|
||
|
#define __need_ptrdiff_t
|
||
|
#define __need_size_t
|
||
|
/* ISO9899:2011 7.20 (C11 Annex K): Define rsize_t if __STDC_WANT_LIB_EXT1__ is
|
||
|
* enabled. */
|
||
|
#if defined(__STDC_WANT_LIB_EXT1__) && __STDC_WANT_LIB_EXT1__ >= 1
|
||
|
#define __need_rsize_t
|
||
|
#endif
|
||
|
#define __need_wchar_t
|
||
|
#define __need_NULL
|
||
|
#if (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 202311L) || \
|
||
|
defined(__cplusplus)
|
||
|
#define __need_nullptr_t
|
||
|
#endif
|
||
|
#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 202311L
|
||
|
#define __need_unreachable
|
||
|
#endif
|
||
|
#if (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L) || \
|
||
|
(defined(__cplusplus) && __cplusplus >= 201103L)
|
||
|
#define __need_max_align_t
|
||
|
#endif
|
||
|
#define __need_offsetof
|
||
|
/* wint_t is provided by <wchar.h> and not <stddef.h>. It's here
|
||
|
* for compatibility, but must be explicitly requested. Therefore
|
||
|
* __need_wint_t is intentionally not defined here. */
|
||
|
#endif
|
||
|
|
||
|
#if defined(__need_ptrdiff_t)
|
||
|
#include <__stddef_ptrdiff_t.h>
|
||
|
#undef __need_ptrdiff_t
|
||
|
#endif /* defined(__need_ptrdiff_t) */
|
||
|
|
||
|
#if defined(__need_size_t)
|
||
|
#include <__stddef_size_t.h>
|
||
|
#undef __need_size_t
|
||
|
#endif /*defined(__need_size_t) */
|
||
|
|
||
|
#if defined(__need_rsize_t)
|
||
|
#include <__stddef_rsize_t.h>
|
||
|
#undef __need_rsize_t
|
||
|
#endif /* defined(__need_rsize_t) */
|
||
|
|
||
|
#if defined(__need_wchar_t)
|
||
|
#include <__stddef_wchar_t.h>
|
||
|
#undef __need_wchar_t
|
||
|
#endif /* defined(__need_wchar_t) */
|
||
|
|
||
|
#if defined(__need_NULL)
|
||
|
#include <__stddef_null.h>
|
||
|
#undef __need_NULL
|
||
|
#endif /* defined(__need_NULL) */
|
||
|
|
||
|
#if defined(__need_nullptr_t)
|
||
|
#include <__stddef_nullptr_t.h>
|
||
|
#undef __need_nullptr_t
|
||
|
#endif /* defined(__need_nullptr_t) */
|
||
|
|
||
|
#if defined(__need_unreachable)
|
||
|
#include <__stddef_unreachable.h>
|
||
|
#undef __need_unreachable
|
||
|
#endif /* defined(__need_unreachable) */
|
||
|
|
||
|
#if defined(__need_max_align_t)
|
||
|
#include <__stddef_max_align_t.h>
|
||
|
#undef __need_max_align_t
|
||
|
#endif /* defined(__need_max_align_t) */
|
||
|
|
||
|
#if defined(__need_offsetof)
|
||
|
#include <__stddef_offsetof.h>
|
||
|
#undef __need_offsetof
|
||
|
#endif /* defined(__need_offsetof) */
|
||
|
|
||
|
/* Some C libraries expect to see a wint_t here. Others (notably MinGW) will use
|
||
|
__WINT_TYPE__ directly; accommodate both by requiring __need_wint_t */
|
||
|
#if defined(__need_wint_t)
|
||
|
#include <__stddef_wint_t.h>
|
||
|
#undef __need_wint_t
|
||
|
#endif /* __need_wint_t */
|
||
|
|
||
|
#endif
|