e955c94ed3
Listing the "Blender Foundation" as copyright holder implied the Blender Foundation holds copyright to files which may include work from many developers. While keeping copyright on headers makes sense for isolated libraries, Blender's own code may be refactored or moved between files in a way that makes the per file copyright holders less meaningful. Copyright references to the "Blender Foundation" have been replaced with "Blender Authors", with the exception of `./extern/` since these this contains libraries which are more isolated, any changed to license headers there can be handled on a case-by-case basis. Some directories in `./intern/` have also been excluded: - `./intern/cycles/` it's own `AUTHORS` file is planned. - `./intern/opensubdiv/`. An "AUTHORS" file has been added, using the chromium projects authors file as a template. Design task: #110784 Ref !110783.
93 lines
2.4 KiB
C
93 lines
2.4 KiB
C
/* SPDX-FileCopyrightText: 2013 Blender Authors
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bli
|
|
*/
|
|
|
|
/* hint to make sure function result is actually used */
|
|
#ifdef __GNUC__
|
|
# define ATTR_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
|
|
#else
|
|
# define ATTR_WARN_UNUSED_RESULT
|
|
#endif
|
|
|
|
/* hint to mark function arguments expected to be non-null
|
|
* if no arguments are given to the macro, all of pointer
|
|
* arguments would be expected to be non-null
|
|
*/
|
|
#ifdef __GNUC__
|
|
# define ATTR_NONNULL(args...) __attribute__((nonnull(args)))
|
|
#else
|
|
# define ATTR_NONNULL(...)
|
|
#endif
|
|
|
|
/* never returns NULL */
|
|
#ifdef __GNUC__
|
|
# define ATTR_RETURNS_NONNULL __attribute__((returns_nonnull))
|
|
#else
|
|
# define ATTR_RETURNS_NONNULL
|
|
#endif
|
|
|
|
/* hint to mark function as it wouldn't return */
|
|
#if defined(__GNUC__) || defined(__clang__)
|
|
# define ATTR_NORETURN __attribute__((noreturn))
|
|
#else
|
|
# define ATTR_NORETURN
|
|
#endif
|
|
|
|
/* hint to treat any non-null function return value cannot alias any other pointer */
|
|
#ifdef __GNUC__
|
|
# define ATTR_MALLOC __attribute__((malloc))
|
|
#else
|
|
# define ATTR_MALLOC
|
|
#endif
|
|
|
|
/* the function return value points to memory (2 args for 'size * tot') */
|
|
#if defined(__GNUC__) && !defined(__clang__)
|
|
# define ATTR_ALLOC_SIZE(args...) __attribute__((alloc_size(args)))
|
|
#else
|
|
# define ATTR_ALLOC_SIZE(...)
|
|
#endif
|
|
|
|
/* ensures a NULL terminating argument as the n'th last argument of a variadic function */
|
|
#ifdef __GNUC__
|
|
# define ATTR_SENTINEL(arg_pos) __attribute__((sentinel(arg_pos)))
|
|
#else
|
|
# define ATTR_SENTINEL(arg_pos)
|
|
#endif
|
|
|
|
/* hint to compiler that function uses printf-style format string */
|
|
#ifdef __GNUC__
|
|
# define ATTR_PRINTF_FORMAT(format_param, dots_param) \
|
|
__attribute__((format(printf, format_param, dots_param)))
|
|
#else
|
|
# define ATTR_PRINTF_FORMAT(format_param, dots_param)
|
|
#endif
|
|
|
|
/* Use to suppress '-Wimplicit-fallthrough' (in place of 'break'). */
|
|
#ifndef ATTR_FALLTHROUGH
|
|
# ifdef __GNUC__
|
|
# define ATTR_FALLTHROUGH __attribute__((fallthrough))
|
|
# else
|
|
# define ATTR_FALLTHROUGH ((void)0)
|
|
# endif
|
|
#endif
|
|
|
|
/* Declare the memory alignment in Bytes. */
|
|
#if defined(_WIN32) && !defined(FREE_WINDOWS)
|
|
# define ATTR_ALIGN(x) __declspec(align(x))
|
|
#else
|
|
# define ATTR_ALIGN(x) __attribute__((aligned(x)))
|
|
#endif
|
|
|
|
/* Alignment directive */
|
|
#ifdef _WIN64
|
|
# define ALIGN_STRUCT __declspec(align(64))
|
|
#else
|
|
# define ALIGN_STRUCT
|
|
#endif
|