90 lines
2.6 KiB
C
90 lines
2.6 KiB
C
|
/*
|
||
|
|
* Copyright 2022 Google LLC
|
||
|
|
*
|
||
|
|
* Use of this source code is governed by a BSD-style license that can be
|
||
|
|
* found in the LICENSE file.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef SkAttributes_DEFINED
|
||
|
|
#define SkAttributes_DEFINED
|
||
|
|
|
||
|
|
#include "include/private/base/SkFeatures.h" // IWYU pragma: keep
|
||
|
|
#include "include/private/base/SkLoadUserConfig.h" // IWYU pragma: keep
|
||
|
|
|
||
|
|
#if defined(__clang__) || defined(__GNUC__)
|
||
|
|
# define SK_ATTRIBUTE(attr) __attribute__((attr))
|
||
|
|
#else
|
||
|
|
# define SK_ATTRIBUTE(attr)
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if !defined(SK_UNUSED)
|
||
|
|
# if !defined(__clang__) && defined(_MSC_VER)
|
||
|
|
# define SK_UNUSED __pragma(warning(suppress:4189))
|
||
|
|
# else
|
||
|
|
# define SK_UNUSED SK_ATTRIBUTE(unused)
|
||
|
|
# endif
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if !defined(SK_WARN_UNUSED_RESULT)
|
||
|
|
#define SK_WARN_UNUSED_RESULT SK_ATTRIBUTE(warn_unused_result)
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/**
|
||
|
|
* If your judgment is better than the compiler's (i.e. you've profiled it),
|
||
|
|
* you can use SK_ALWAYS_INLINE to force inlining. E.g.
|
||
|
|
* inline void someMethod() { ... } // may not be inlined
|
||
|
|
* SK_ALWAYS_INLINE void someMethod() { ... } // should always be inlined
|
||
|
|
*/
|
||
|
|
#if !defined(SK_ALWAYS_INLINE)
|
||
|
|
# if defined(SK_BUILD_FOR_WIN)
|
||
|
|
# define SK_ALWAYS_INLINE __forceinline
|
||
|
|
# else
|
||
|
|
# define SK_ALWAYS_INLINE SK_ATTRIBUTE(always_inline) inline
|
||
|
|
# endif
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/**
|
||
|
|
* If your judgment is better than the compiler's (i.e. you've profiled it),
|
||
|
|
* you can use SK_NEVER_INLINE to prevent inlining.
|
||
|
|
*/
|
||
|
|
#if !defined(SK_NEVER_INLINE)
|
||
|
|
# if defined(SK_BUILD_FOR_WIN)
|
||
|
|
# define SK_NEVER_INLINE __declspec(noinline)
|
||
|
|
# else
|
||
|
|
# define SK_NEVER_INLINE SK_ATTRIBUTE(noinline)
|
||
|
|
# endif
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Used to annotate a function as taking printf style arguments.
|
||
|
|
* `A` is the (1 based) index of the format string argument.
|
||
|
|
* `B` is the (1 based) index of the first argument used by the format string.
|
||
|
|
*/
|
||
|
|
#if !defined(SK_PRINTF_LIKE)
|
||
|
|
# define SK_PRINTF_LIKE(A, B) SK_ATTRIBUTE(format(printf, (A), (B)))
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Used to ignore sanitizer warnings.
|
||
|
|
*/
|
||
|
|
#if !defined(SK_NO_SANITIZE)
|
||
|
|
# define SK_NO_SANITIZE(A) SK_ATTRIBUTE(no_sanitize(A))
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Annotates a class' non-trivial special functions as trivial for the purposes of calls.
|
||
|
|
* Allows a class with a non-trivial destructor to be __is_trivially_relocatable.
|
||
|
|
* Use of this attribute on a public API breaks platform ABI.
|
||
|
|
* Annotated classes may not hold pointers derived from `this`.
|
||
|
|
* Annotated classes must implement move+delete as equivalent to memcpy+free.
|
||
|
|
* Use may require more complete types, as callee destroys.
|
||
|
|
*
|
||
|
|
* https://clang.llvm.org/docs/AttributeReference.html#trivial-abi
|
||
|
|
* https://libcxx.llvm.org/DesignDocs/UniquePtrTrivialAbi.html
|
||
|
|
*/
|
||
|
|
#if !defined(SK_TRIVIAL_ABI)
|
||
|
|
# define SK_TRIVIAL_ABI
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif
|