Ruby  3.4.0dev (2024-12-06 revision 892c46283a5ea4179500d951c9d4866c0051f27b)
Macros
stdalign.h File Reference

(892c46283a5ea4179500d951c9d4866c0051f27b)

Defines RUBY_ALIGNAS / RUBY_ALIGNOF. More...

#include "ruby/internal/stdalign.h"
Include dependency graph for stdalign.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

#define RUBY_ALIGNAS   RBIMPL_ALIGNAS
 Wraps (or simulates) alignas. More...
 
#define RUBY_ALIGNOF   RBIMPL_ALIGNOF
 Wraps (or simulates) alignof. More...
 

Detailed Description

Defines RUBY_ALIGNAS / RUBY_ALIGNOF.

Author
Ruby developers ruby-.nosp@m.core.nosp@m.@ruby.nosp@m.-lan.nosp@m.g.org
Warning
Symbols prefixed with either RBIMPL or rbimpl are implementation details. Don't take them as canon. They could rapidly appear then vanish. The name (path) of this header file is also an implementation detail. Do not expect it to persist at the place it is now. Developers are free to move it anywhere anytime at will.
Note
To ruby-core: remember that this header can be possibly recursively included from extension libraries written in C++. Do not expect for instance __VA_ARGS__ is always available. We assume C99 for ruby itself but we don't assume languages of extension libraries. They could be written in C++98.

Definition in file stdalign.h.

Macro Definition Documentation

◆ RUBY_ALIGNAS

#define RUBY_ALIGNAS   RBIMPL_ALIGNAS

Wraps (or simulates) alignas.

This is C++11's alignas and is different from C11 _Alignas. For instance,

typedef struct alignas(128) foo { int foo } foo;

is a valid C++ while

typedef struct _Alignas(128) foo { int foo } foo;

is an invalid C because:

  • You cannot struct _Alignas.
  • A typedef cannot have alignments.

Definition at line 27 of file stdalign.h.

◆ RUBY_ALIGNOF

#define RUBY_ALIGNOF   RBIMPL_ALIGNOF

Wraps (or simulates) alignof.

We want C11's _Alignof. However in spite of its clear language, compilers (including GCC and clang) tend to have buggy implementations. We have to avoid such things to resort to our own version.

See also
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=52023
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=69560
https://bugs.llvm.org/show_bug.cgi?id=26547

Definition at line 28 of file stdalign.h.