1 /* Definitions and declarations for stor-layout.cc.
2 Copyright (C) 2013-2023 Free Software Foundation, Inc.
3
4 This file is part of GCC.
5
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU General Public License as published by the Free
8 Software Foundation; either version 3, or (at your option) any later
9 version.
10
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
19
20 #ifndef GCC_STOR_LAYOUT_H
21 #define GCC_STOR_LAYOUT_H
22
23 extern void set_min_and_max_values_for_integral_type (tree, int, signop);
24 extern void fixup_signed_type (tree);
25 extern unsigned int update_alignment_for_field (record_layout_info, tree,
26 unsigned int);
27 extern record_layout_info start_record_layout (tree);
28 extern tree bit_from_pos (tree, tree);
29 extern tree byte_from_pos (tree, tree);
30 extern void pos_from_bit (tree *, tree *, unsigned int, tree);
31 extern void normalize_offset (tree *, tree *, unsigned int);
32 extern tree rli_size_unit_so_far (record_layout_info);
33 extern tree rli_size_so_far (record_layout_info);
34 extern void normalize_rli (record_layout_info);
35 extern void place_field (record_layout_info, tree);
36 extern void compute_record_mode (tree);
37 extern void finish_bitfield_layout (tree);
38 extern void finish_record_layout (record_layout_info, int);
39 extern unsigned int element_precision (const_tree);
40 extern void finalize_size_functions (void);
41 extern void fixup_unsigned_type (tree);
42 extern void initialize_sizetypes (void);
43
44 /* Finish up a builtin RECORD_TYPE. Give it a name and provide its
45 fields. Optionally specify an alignment, and then lay it out. */
46 extern void finish_builtin_struct (tree, const char *, tree, tree);
47
48 /* Given a VAR_DECL, PARM_DECL, RESULT_DECL or FIELD_DECL node,
49 calculates the DECL_SIZE, DECL_SIZE_UNIT, DECL_ALIGN and DECL_MODE
50 fields. Call this only once for any given decl node.
51
52 Second argument is the boundary that this field can be assumed to
53 be starting at (in bits). Zero means it can be assumed aligned
54 on any boundary that may be needed. */
55 extern void layout_decl (tree, unsigned);
56
57 /* Given a ..._TYPE node, calculate the TYPE_SIZE, TYPE_SIZE_UNIT,
58 TYPE_ALIGN and TYPE_MODE fields. If called more than once on one
59 node, does nothing except for the first time. */
60 extern void layout_type (tree);
61
62 /* Return the least alignment in bytes required for type TYPE. */
63 extern unsigned int min_align_of_type (tree);
64
65 /* Construct various nodes representing fract or accum data types. */
66 extern tree make_fract_type (int, int, int);
67 extern tree make_accum_type (int, int, int);
68
69 #define make_signed_fract_type(P) make_fract_type (P, 0, 0)
70 #define make_unsigned_fract_type(P) make_fract_type (P, 1, 0)
71 #define make_sat_signed_fract_type(P) make_fract_type (P, 0, 1)
72 #define make_sat_unsigned_fract_type(P) make_fract_type (P, 1, 1)
73 #define make_signed_accum_type(P) make_accum_type (P, 0, 0)
74 #define make_unsigned_accum_type(P) make_accum_type (P, 1, 0)
75 #define make_sat_signed_accum_type(P) make_accum_type (P, 0, 1)
76 #define make_sat_unsigned_accum_type(P) make_accum_type (P, 1, 1)
77
78 #define make_or_reuse_signed_fract_type(P) \
79 make_or_reuse_fract_type (P, 0, 0)
80 #define make_or_reuse_unsigned_fract_type(P) \
81 make_or_reuse_fract_type (P, 1, 0)
82 #define make_or_reuse_sat_signed_fract_type(P) \
83 make_or_reuse_fract_type (P, 0, 1)
84 #define make_or_reuse_sat_unsigned_fract_type(P) \
85 make_or_reuse_fract_type (P, 1, 1)
86 #define make_or_reuse_signed_accum_type(P) \
87 make_or_reuse_accum_type (P, 0, 0)
88 #define make_or_reuse_unsigned_accum_type(P) \
89 make_or_reuse_accum_type (P, 1, 0)
90 #define make_or_reuse_sat_signed_accum_type(P) \
91 make_or_reuse_accum_type (P, 0, 1)
92 #define make_or_reuse_sat_unsigned_accum_type(P) \
93 make_or_reuse_accum_type (P, 1, 1)
94
95 extern tree make_signed_type (int);
96 extern tree make_unsigned_type (int);
97
98 /* Return the mode for data of a given size SIZE and mode class CLASS.
99 If LIMIT is nonzero, then don't use modes bigger than MAX_FIXED_MODE_SIZE.
100 The value is BLKmode if no other mode is found. This is like
101 mode_for_size, but is passed a tree. */
102 extern opt_machine_mode mode_for_size_tree (const_tree, enum mode_class, int);
103
104 extern tree bitwise_type_for_mode (machine_mode);
105
106 /* Given a VAR_DECL, PARM_DECL or RESULT_DECL, clears the results of
107 a previous call to layout_decl and calls it again. */
108 extern void relayout_decl (tree);
109
110 /* variable_size (EXP) is like save_expr (EXP) except that it
111 is for the special case of something that is part of a
112 variable size for a data type. It makes special arrangements
113 to compute the value at the right time when the data type
114 belongs to a function parameter. */
115 extern tree variable_size (tree);
116
117 #endif // GCC_STOR_LAYOUT_H