summaryrefslogtreecommitdiff
path: root/gnulib/doc/posix-headers/stdalign.texi
blob: bebc70d46b83fc2e6b308da6fffea80c4460bbec (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
@node stdalign.h
@section @file{stdalign.h}

POSIX specification:@* Not in POSIX yet, but we expect it will be.
ISO C1X @url{http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1570.pdf}
sections 6.5.3.4, 6.7.5, 7.15.
C++0X @url{http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2011/n3242.pdf}
section 18.10.

Gnulib module: stdalign

Portability problems fixed by Gnulib:
@itemize
@item
This header file is missing on most circa-2011 platforms.
@item
Clang 3.0's @code{<stdalign.h>} does not define @code{alignof}/@code{_Alignof}.
@end itemize

Portability problems not fixed by Gnulib:
@itemize
@item
@code{_Alignas} and @code{alignas} are not always supported;
on platforms lacking support, the
macro @code{__alignas_is_defined} is not defined.
Supported compilers include GCC, IBM C, Sun C 5.11 and later,
and MSVC 7.0 and later.
@item
Some compilers do not support alignment via
@code{alignas}/@code{_Alignas} of @code{auto} variables (i.e.,
variables on the stack).  They diagnose and ignore the alignment: Sun
C 5.11.
@item
Some linkers do not support operands of @code{_Alignas}/@code{alignas}
that are greater than 8: mingw.
@item
Some compilers require the operand of @code{_Alignas}/@code{alignas}
to be a single integer constant, not an expression: MSVC 7.0 through
at least 10.0.
@item
The Sun C 5.11 compiler sometimes mishandles the alignment of multiple
external variables that are declared close together with
@code{_Alignas}/@code{alignas}.  This compiler bug causes the Gnulib
module @code{stdalign-tests} to fail.  The Sun Studio Developer Bug
Report Review Team assigned the internal review ID 2125432 (dated
2011-11-01) to this issue.
@item
@code{<stdalign.h>} must be #included before @samp{_Alignas} and
@samp{_Alignof} can be used.
@item
You cannot assume that @code{_Alignas} and @code{_Alignof} are reserved words;
they might be macros.
@end itemize