* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((alloc_size))` */

# define RUBY3_ATTR_ALLOC_SIZE(tuple) __attribute__((__alloc_size__ tuple))

#else

# define RUBY3_ATTR_ALLOC_SIZE(tuple) /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((artificial))` */

# define RUBY3_ATTR_ARTIFICIAL() __attribute__((__artificial__))

#else

# define RUBY3_ATTR_ARTIFICIAL() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

#include "ruby/3/compiler_is.h"

/** Wraps (or simulates) `__attribute__((cold))` */

# /* Recent SunPro has __has_attribute, and is borken. */

# /* It reports it has attribute cold, reality isn't (warnings issued). */

# define RUBY3_ATTR_COLD() /* void */

#elif RUBY3_HAS_ATTRIBUTE(cold)

# define RUBY3_ATTR_COLD() __attribute__((__cold__))

#else

# define RUBY3_ATTR_COLD() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

#include "ruby/3/has/declspec_attribute.h"

/** Wraps (or simulates) `__attribute__((const))` */

# define RUBY3_ATTR_CONST() __attribute__((__const__))

#elif RUBY3_HAS_DECLSPEC_ATTRIBUTE(noalias)

# /* If a function can be a const, that is also a noalias. */

# define RUBY3_ATTR_CONST() __declspec(noalias)

#elif RUBY3_COMPILER_SINCE(SunPro, 5, 10, 0)

# define RUBY3_ATTR_CONST() _Pragma("no_side_effect")

#else

# define RUBY3_ATTR_CONST() /* void */

#endif

/** Enables #RUBY3_ATTR_CONST iff. #RUBY_NDEBUG. */

# define RUBY3_ATTR_CONST_ON_NDEBUG() RUBY3_ATTR_CONST()

#else

# define RUBY3_ATTR_CONST_ON_NDEBUG() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

#include "ruby/3/has/feature.h"

#include "ruby/3/compiler_is.h"

# /* Makes no sense. */

# define RUBY3_HAS_ATTR_CONSTEXPR_CXX11 0

# define RUBY3_HAS_ATTR_CONSTEXPR_CXX14 0

/** @endcond */

/** Wraps (or simulates) C++11 `constexpr`. */

# define RUBY3_ATTR_CONSTEXPR(_) constexpr

#elif RUBY3_HAS_ATTR_CONSTEXPR_CXX11

#endif

/** Enables #RUBY3_ATTR_CONSTEXPR iff. #RUBY_NDEBUG. */

# define RUBY3_ATTR_CONSTEXPR_ON_NDEBUG(_) RUBY3_ATTR_CONSTEXPR(_)

#else

# define RUBY3_ATTR_CONSTEXPR_ON_NDEBUG(_) /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

#include "ruby/3/has/extension.h"

/** Wraps (or simulates) `[[deprecated]]` */

# define RUBY3_ATTR_DEPRECATED(msg) __attribute__((__deprecated__ msg))

#elif RUBY3_COMPILER_SINCE(GCC, 4, 5, 0)

#else

# define RUBY3_ATTR_DEPRECATED(msg) /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((diagnose_if))` */

# /* https://bugs.llvm.org/show_bug.cgi?id=34319 */

# define RUBY3_ATTR_DIAGNOSE_IF(_, __, ___) /* void */

#else

# define RUBY3_ATTR_DIAGNOSE_IF(_, __, ___) /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((enum_extensibility))` */

# define RUBY3_ATTR_ENUM_EXTENSIBILITY(_) __attribute__((__enum_extensibility__(_)))

#else

# define RUBY3_ATTR_ENUM_EXTENSIBILITY(_) /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((error))` */

# define RUBY3_ATTR_ERROR(msg) __attribute__((__error__ msg))

#else

# define RUBY3_ATTR_ERROR(msg) /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((flag_enum)` */

# define RUBY3_ATTR_FLAG_ENUM() __attribute__((__flag_enum__))

#else

# define RUBY3_ATTR_FLAG_ENUM() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

* `__forceinline` are mutually exclusive. We have to mimic that behaviour for

* non-MSVC compilers.

*/

# define RUBY3_ATTR_FORCEINLINE() __forceinline

#elif RUBY3_HAS_ATTRIBUTE(always_inline)

# define RUBY3_ATTR_FORCEINLINE() __attribute__((__always_inline__)) inline

#else

# define RUBY3_ATTR_FORCEINLINE() inline

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((format))` */

# define RUBY3_ATTR_FORMAT(x, y, z) __attribute__((__format__(x, y, z)))

#else

# define RUBY3_ATTR_FORMAT(x, y, z) /* void */

#endif

# define RUBY3_PRINTF_FORMAT __MINGW_PRINTF_FORMAT

#else

# define RUBY3_PRINTF_FORMAT __printf__

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

#include "ruby/3/has/cpp_attribute.h"

/** Wraps (or simulates) `[[maybe_unused]]` */

# define RUBY3_ATTR_MAYBE_UNUSED() [[maybe_unused]]

#elif RUBY3_HAS_C_ATTRIBUTE(maybe_unused)

# define RUBY3_ATTR_MAYBE_UNUSED() [[maybe_unused]]

#elif RUBY3_HAS_ATTRIBUTE(unused)

# define RUBY3_ATTR_MAYBE_UNUSED() __attribute__((__unused__))

#else

# define RUBY3_ATTR_MAYBE_UNUSED() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

#include "ruby/3/has/declspec_attribute.h"

/** Wraps (or simulates) `__declspec((noalias))` */

# define RUBY3_ATTR_NOALIAS() __declspec(noalias)

#else

# define RUBY3_ATTR_NOALIAS() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

* nodiscard attribute can have a message why the result shall not be ignoed.

* However GCC attribute and SAL annotation cannot take them.

*/

# define RUBY3_ATTR_NODISCARD() [[nodiscard]]

#elif RUBY3_HAS_C_ATTRIBUTE(nodiscard)

# define RUBY3_ATTR_NODISCARD() [[nodiscard]]

#elif RUBY3_HAS_ATTRIBUTE(warn_unused_result)

# define RUBY3_ATTR_NODISCARD() __attribute__((__warn_unused_result__))

#elif defined(_Check_return_)

# /* Take SAL definition. */

# define RUBY3_ATTR_NODISCARD() _Check_return_

#else

# define RUBY3_ATTR_NODISCARD() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

#include "ruby/3/has/feature.h"

/** Wraps (or simulates) C++11 `noexcept` */

# /* Doesn't make sense. */

# define RUBY3_ATTR_NOEXCEPT(_) /* void */

#else

# define RUBY3_ATTR_NOEXCEPT(_) /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

#include "ruby/3/has/declspec_attribute.h"

/** Wraps (or simulates) `__declspec(noinline)` */

# define RUBY3_ATTR_NOINLINE() __declspec(noinline)

#elif RUBY3_HAS_ATTRIBUTE(noinline)

# define RUBY3_ATTR_NOINLINE() __attribute__((__noinline__))

#else

# define RUBY3_ATTR_NOINLINE() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((nonnull))` */

# define RUBY3_ATTR_NONNULL(list) __attribute__((__nonnull__ list))

#else

# define RUBY3_ATTR_NONNULL(list) /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

#include "ruby/3/has/declspec_attribute.h"

/** Wraps (or simulates) `[[noreturn]]` */

# define RUBY3_ATTR_NORETURN() _Pragma("does_not_return")

#elif RUBY3_HAS_DECLSPEC_ATTRIBUTE(noreturn)

#else

# define RUBY3_ATTR_NORETURN() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

#include "ruby/assert.h"

/** Wraps (or simulates) `__attribute__((pure))` */

# define RUBY3_ATTR_PURE() __attribute__((__pure__))

#elif RUBY3_COMPILER_SINCE(SunPro, 5, 10, 0)

# define RUBY3_ATTR_PURE() _Pragma("does_not_write_global_data")

#else

# define RUBY3_ATTR_PURE() /* void */

#endif

/** Enables #RUBY3_ATTR_PURE iff. #RUBY_NDEBUG. */

# define RUBY3_ATTR_PURE_ON_NDEBUG() RUBY3_ATTR_PURE()

#else

# define RUBY3_ATTR_PURE_ON_NDEBUG() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

* `__has_declspec_attribute()` which involves macro substitution. */

/** Wraps (or simulates) `__declspec(restrict)` */

# define RUBY3_ATTR_RESTRICT() __declspec(RUBY3_TOKEN_PASTE(re, strict))

#elif RUBY3_HAS_ATTRIBUTE(malloc)

#else

# define RUBY3_ATTR_RESTRICT() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((returns_nonnull))` */

# /* Take SAL definition. */

# define RUBY3_ATTR_RETURNS_NONNULL() _Ret_nonnull_

#else

# define RUBY3_ATTR_RETURNS_NONNULL() /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((warning))` */

# define RUBY3_ATTR_WARNING(msg) __attribute__((__warning__ msg))

#else

# define RUBY3_ATTR_WARNING(msg) /* void */

#endif

* @file

* @author Ruby developers <[email protected]>

* @copyright This file is a part of the programming language Ruby.

*/

/** Wraps (or simulates) `__attribute__((weakref))` */

# define RUBY3_ATTR_WEAKREF(sym) __attribute__((__weakref__(# sym)))

#else

# define RUBY3_ATTR_WEAKREF(sym) /* void */

#endif