Skip to main content

rucc_pp/
predef.rs

1//! The predefined macro set, generated from the target description.
2//!
3//! Design: `spec/04-driver-and-cli.md` section 4.5.
4//!
5//! The set is built as text and then read by the directive engine, which is what GCC does and
6//! is not laziness. Constructing a few hundred `MacroDef` values by hand would need its own
7//! parser for macro bodies, would not exercise the one that already exists, and could not be
8//! read by a person checking a limit against the psABI. A file of `#define` lines can be
9//! printed by `-dM`, diffed against GCC's output, and understood at a glance.
10//!
11//! Two synthetic files come out of this, and they are the two GCC names in a diagnostic:
12//! `<built-in>` for the generated set and `<command-line>` for `-D` and `-U`. Keeping them
13//! apart is what lets "`FOO` redefined" point at the command line rather than at a line
14//! nobody wrote.
15//!
16//! The decision that everything else follows from is in section 4.5: we define `__GNUC__`,
17//! which means glibc's headers, the kernel's headers and every autoconf probe take the GNU
18//! path. The version claimed is deliberately conservative and is a knob, because claiming too
19//! high a version means headers use extensions we do not have, and the matrix in `rucc-gnu`
20//! is the list of promises the claim makes.
21
22use rucc_base::float::Format;
23use rucc_session::{GnucVersion, OptLevel, Options, Pic, Std};
24use rucc_target::{Arch, Env, Os, TargetInfo, Triple};
25use rucc_tuple::{self as tuple};
26
27/// The name a diagnostic about the generated set points at.
28pub const BUILT_IN: &str = "<built-in>";
29
30/// The name a diagnostic about `-D` or `-U` points at.
31pub const COMMAND_LINE: &str = "<command-line>";
32
33/// The translation date, as `__DATE__` and `__TIME__` spell it.
34///
35/// Fixed for the whole translation unit, which is what the standard requires and what makes
36/// the two macros ordinary object-like macros rather than something the expander has to know
37/// about.
38#[derive(Debug, Clone, PartialEq, Eq)]
39pub struct Timestamp {
40    /// `Mmm dd yyyy`, with the day space padded, which is the format the standard fixes.
41    pub date: String,
42    /// `hh:mm:ss`.
43    pub time: String,
44}
45
46impl Timestamp {
47    /// The current time, or `SOURCE_DATE_EPOCH` when the build asked for a reproducible one.
48    ///
49    /// Reading the environment here rather than in the driver is what GCC does, and it keeps
50    /// the variable working for an embedder who never goes through a command line.
51    pub fn now() -> Timestamp {
52        let seconds = match std::env::var("SOURCE_DATE_EPOCH").ok().and_then(|v| v.parse().ok()) {
53            Some(fixed) => fixed,
54            None => std::time::SystemTime::now()
55                .duration_since(std::time::UNIX_EPOCH)
56                .map_or(0, |d| d.as_secs() as i64),
57        };
58        Timestamp::from_unix(seconds)
59    }
60
61    /// The time `seconds` after the epoch, in UTC.
62    ///
63    /// UTC rather than local time, because a compiler whose output depends on the machine's
64    /// time zone is a compiler whose output is not reproducible.
65    pub fn from_unix(seconds: i64) -> Timestamp {
66        let days = seconds.div_euclid(86_400);
67        let rest = seconds.rem_euclid(86_400);
68        let (year, month, day) = civil_from_days(days);
69        const MONTHS: [&str; 12] =
70            ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
71        let name = MONTHS[(month - 1) as usize];
72        Timestamp {
73            date: format!("{name} {day:2} {year}"),
74            time: format!("{:02}:{:02}:{:02}", rest / 3600, (rest / 60) % 60, rest % 60),
75        }
76    }
77}
78
79/// The year, month and day `days` after 1970-01-01.
80///
81/// Howard Hinnant's civil calendar algorithm, which is a handful of divisions and no table.
82/// It is here rather than in a dependency because the whole workspace has no dependencies,
83/// and a date conversion is not a good reason to acquire the first one.
84fn civil_from_days(days: i64) -> (i64, u32, u32) {
85    // Shift the epoch to 0000-03-01, so that a leap day is the last day of the year and the
86    // month lengths become a repeating pattern that one division can invert.
87    let shifted = days + 719_468;
88    let era = shifted.div_euclid(146_097);
89    let day_of_era = shifted.rem_euclid(146_097);
90    let year_of_era =
91        (day_of_era - day_of_era / 1460 + day_of_era / 36_524 - day_of_era / 146_096) / 365;
92    let year = year_of_era + era * 400;
93    let day_of_year = day_of_era - (365 * year_of_era + year_of_era / 4 - year_of_era / 100);
94    let marched = (5 * day_of_year + 2) / 153;
95    let day = (day_of_year - (153 * marched + 2) / 5 + 1) as u32;
96    let month = if marched < 10 { marched + 3 } else { marched - 9 } as u32;
97    (year + i64::from(month <= 2), month, day)
98}
99
100/// Everything the predefined set is built from that is not the target.
101#[derive(Debug, Clone, PartialEq, Eq)]
102pub struct Predef {
103    /// The dialect, which decides `__STDC_VERSION__`.
104    pub std: Std,
105    /// Whether the GNU extensions are on, which is `-std=gnu23` rather than `-std=c23`. It
106    /// decides `__STRICT_ANSI__` and the unarmoured `linux` and `unix` macros.
107    pub gnu_extensions: bool,
108    /// Whether the unit is under GNU's reading of `inline`, which is `-fgnu89-inline`. It decides
109    /// which of `__GNUC_GNU_INLINE__` and `__GNUC_STDC_INLINE__` is defined, and the C89 dialects
110    /// are under that reading whatever it says.
111    pub gnu89_inline: bool,
112    /// The GCC release claimed.
113    pub gnuc: GnucVersion,
114    /// Decides `__OPTIMIZE__`, `__OPTIMIZE_SIZE__` and `__NO_INLINE__`.
115    pub opt_level: OptLevel,
116    /// Whether there is a standard library, which is `-ffreestanding` turned around.
117    pub hosted: bool,
118    /// Which link the output is for, from `-fPIC` and `-fPIE`. It decides `__PIE__`, since
119    /// `__PIC__` is defined either way and says only that there are no absolute addresses.
120    pub pic: Pic,
121    /// `__DATE__` and `__TIME__`.
122    pub timestamp: Timestamp,
123    /// The glibc release the headers are, as the minor number alone, when they are ours.
124    ///
125    /// `__GLIBC_MINOR__` and nothing else: `__GLIBC__` is 2 in the tree itself, which is how Zig's
126    /// own patched `features.h` has it, and a version the compiler supplied and a version the
127    /// header supplied would be two answers to one question.
128    pub glibc_minor: Option<u32>,
129    /// `-D` in command line order. `FOO` means `FOO=1`, as GCC has it.
130    pub defines: Vec<String>,
131    /// `-U` in command line order, applied after the defines.
132    pub undefines: Vec<String>,
133}
134
135impl Predef {
136    /// The default dialect, `gnu23`, at `-O0`.
137    pub fn new() -> Predef {
138        Predef {
139            std: Std::default(),
140            gnu_extensions: true,
141            gnu89_inline: false,
142            gnuc: GnucVersion::default(),
143            opt_level: OptLevel::O0,
144            hosted: true,
145            pic: Pic::Executable,
146            timestamp: Timestamp::now(),
147            glibc_minor: None,
148            defines: Vec::new(),
149            undefines: Vec::new(),
150        }
151    }
152}
153
154impl Predef {
155    /// The set the command line asked for.
156    ///
157    /// The mapping lives here rather than in the driver because it is the definition of what
158    /// each flag means to the macro set, and the driver's job is to parse a command line, not
159    /// to know that `-ffreestanding` is `__STDC_HOSTED__` being zero.
160    pub fn for_options(opts: &Options) -> Predef {
161        Predef {
162            std: opts.std,
163            gnu_extensions: opts.gnu_extensions,
164            gnu89_inline: opts.gnu89_inline,
165            gnuc: opts.gnuc,
166            opt_level: opts.opt_level,
167            hosted: opts.hosted,
168            pic: opts.pic,
169            timestamp: Timestamp::now(),
170            glibc_minor: opts.glibc_minor,
171            defines: opts.defines.clone(),
172            undefines: opts.undefines.clone(),
173        }
174    }
175}
176
177impl Default for Predef {
178    fn default() -> Predef {
179        Predef::new()
180    }
181}
182
183/// A file of `#define` lines being built up.
184struct Defs {
185    text: String,
186}
187
188impl Defs {
189    fn new() -> Defs {
190        Defs { text: String::new() }
191    }
192
193    /// `#define name value`.
194    fn set(&mut self, name: &str, value: &str) {
195        self.text.push_str("#define ");
196        self.text.push_str(name);
197        self.text.push(' ');
198        self.text.push_str(value);
199        self.text.push('\n');
200    }
201
202    /// `#define name 1`, which is what a macro that is only ever tested for needs.
203    fn flag(&mut self, name: &str) {
204        self.set(name, "1");
205    }
206
207    fn set_if(&mut self, when: bool, name: &str, value: &str) {
208        if when {
209            self.set(name, value);
210        }
211    }
212
213    fn flag_if(&mut self, when: bool, name: &str) {
214        if when {
215            self.flag(name);
216        }
217    }
218}
219
220/// The whole predefined set for a target, as the text of a file.
221pub(crate) fn built_in(target: &TargetInfo, opts: &Predef) -> String {
222    let mut d = Defs::new();
223    identity(&mut d, target, opts);
224    // `__DATE__` and `__TIME__` are fixed for the whole translation unit, which is what the
225    // standard asks for, so they are ordinary object-like macros and the expander needs to
226    // know nothing about them.
227    d.set("__DATE__", &format!("\"{}\"", opts.timestamp.date));
228    d.set("__TIME__", &format!("\"{}\"", opts.timestamp.time));
229    dialect(&mut d, opts);
230    optimization(&mut d, opts);
231    platform(&mut d, target, opts);
232    sizes(&mut d, target);
233    integers(&mut d, target);
234    floats(&mut d, target);
235    atomics(&mut d, target);
236    d.text
237}
238
239/// `-D` and `-U`, as the text of a file.
240///
241/// Empty when there are none, so that the caller can skip adding a file that would say
242/// nothing. The undefines come last whatever order they were written in, because `-U` beats
243/// `-D` in GCC no matter which side of it the `-D` was on.
244pub(crate) fn command_line(opts: &Predef) -> String {
245    let mut d = Defs::new();
246    for define in &opts.defines {
247        match define.split_once('=') {
248            Some((name, value)) => d.set(name, value),
249            // `-DFOO` is `-DFOO=1`. A macro nobody gave a value to is one that is only ever
250            // tested for, and giving it an empty body would break `#if FOO`.
251            None => d.flag(define),
252        }
253    }
254    for name in &opts.undefines {
255        d.text.push_str("#undef ");
256        d.text.push_str(name);
257        d.text.push('\n');
258    }
259    d.text
260}
261
262/// What this compiler says its own version is.
263///
264/// Read from the manifest at build time rather than written here, because a number written in a
265/// second place is a number that goes stale: these five macros said 0.1.0 through sixty seven
266/// releases. A program testing `__rucc_major__` for a feature was told the answer for a version
267/// nobody has run since, and a build log recording `__VERSION__` recorded the wrong compiler.
268const VERSION: &str = env!("CARGO_PKG_VERSION");
269
270/// One dotted field of a version, as the digits at the front of it.
271///
272/// `0.10.68-rc.1` has a patch level of 68 and not of `68-rc`, and a field that is not there at all
273/// is zero, which is what a two field version means by its third. Neither shape is one this
274/// workspace publishes, and a macro that expands to something no `#if` can read is worse than a
275/// macro that is approximately right.
276fn field(version: &str, n: usize) -> &str {
277    let part = version.split('.').nth(n).unwrap_or("0");
278    let digits = part.trim_start_matches(|c: char| !c.is_ascii_digit());
279    let end = digits.find(|c: char| !c.is_ascii_digit()).unwrap_or(digits.len());
280    if end == 0 { "0" } else { &digits[..end] }
281}
282
283/// Who the compiler says it is.
284fn identity(d: &mut Defs, target: &TargetInfo, opts: &Predef) {
285    d.flag("__rucc__");
286    d.set("__rucc_version__", &format!("\"{VERSION}\""));
287    d.set("__rucc_major__", field(VERSION, 0));
288    d.set("__rucc_minor__", field(VERSION, 1));
289    d.set("__rucc_patchlevel__", field(VERSION, 2));
290    // The promise from section 4.5. Everything in the matrix hangs off this line.
291    d.set("__GNUC__", &opts.gnuc.major.to_string());
292    d.set("__GNUC_MINOR__", &opts.gnuc.minor.to_string());
293    d.set("__GNUC_PATCHLEVEL__", &opts.gnuc.patch.to_string());
294    d.set("__VERSION__", &format!("\"rucc {VERSION}\""));
295    // Not `__clang__`, deliberately. Section 4.5 says so, and a header that takes the Clang
296    // path expects Clang's extension surface rather than GCC's.
297    //
298    // Which of the two readings of `inline` is in force, which a header reads to decide how to
299    // write its own inline definitions: glibc's `__extern_inline` is `extern __inline` under the
300    // one and adds `__attribute__ ((__gnu_inline__))` under the other. C99 changed the meaning of
301    // the keyword and gcc follows the dialect, so the C89 ones keep GNU's reading and every
302    // dialect after them takes C's until `-fgnu89-inline` says otherwise.
303    let gnu_inline = opts.gnu89_inline || opts.std == Std::C89;
304    d.flag_if(gnu_inline, "__GNUC_GNU_INLINE__");
305    d.flag_if(!gnu_inline, "__GNUC_STDC_INLINE__");
306    // The charsets a literal is converted to. Both are fixed here rather than settable, since
307    // there is no `-fexec-charset` to set them with, and both are what gcc answers with none.
308    // The wide one follows `wchar_t`, which is sixteen bits on Windows and thirty two
309    // everywhere else, so it is the one target fact in this function.
310    d.set("__GNUC_EXECUTION_CHARSET_NAME", "\"UTF-8\"");
311    let wide = if target.wchar_width == 16 { "\"UTF-16LE\"" } else { "\"UTF-32LE\"" };
312    d.set("__GNUC_WIDE_EXECUTION_CHARSET_NAME", wide);
313    // The C++ ABI this would be if it compiled C++, which gcc defines in C as well. It is not
314    // a claim about this compiler so much as a number headers read: libstdc++ is not the only
315    // thing that tests it, and a C header shared with a C++ one reaches it through `extern
316    // "C"` guards. The value is gcc 16's.
317    d.set("__GXX_ABI_VERSION", "1021");
318}
319
320/// What the dialect flags say.
321fn dialect(d: &mut Defs, opts: &Predef) {
322    d.flag("__STDC__");
323    d.set_if(opts.hosted, "__STDC_HOSTED__", "1");
324    d.set_if(!opts.hosted, "__STDC_HOSTED__", "0");
325    if let Some(version) = opts.std.stdc_version() {
326        d.set("__STDC_VERSION__", version);
327    }
328    // Defined exactly when the extensions are off, which is the whole difference between
329    // `-std=c23` and `-std=gnu23` as far as the preprocessor is concerned.
330    d.flag_if(!opts.gnu_extensions, "__STRICT_ANSI__");
331    d.flag("__STDC_UTF_16__");
332    d.flag("__STDC_UTF_32__");
333    d.flag("__STDC_IEC_559__");
334    d.flag("__STDC_IEC_559_COMPLEX__");
335    // TS 18661-1's date, in every dialect, which is gcc 16's answer rather than the standard's.
336    // C23 folded that document into Annex F and gave the macro a date of its own, so 202311L is
337    // the value C23 asks for, and writing it is what a reading of the standard alone produces.
338    // It also breaks every translation unit that reaches glibc. `<stdc-predef.h>` is included
339    // ahead of the first line of the file and defines this name as 201404L whenever
340    // `__GCC_IEC_559` is positive, which it is here, so a different value is a redefinition with
341    // a different body and that is a diagnostic on a line the program never wrote. The cost is
342    // not only noise: sqlite's configure runs its feature tests through autosetup's `cctest
343    // -nooutput 1`, which reads any output at all as a failed test, and the readline completion
344    // test failed for no other reason than this warning.
345    d.set("__STDC_IEC_60559_BFP__", "201404L");
346    // The same date for the complex half, which is the other name `<stdc-predef.h>` writes and
347    // which was missing here. Withholding it looked like the careful answer and was not one, for
348    // two reasons. `__STDC_NO_COMPLEX__` is defined, so there is no complex arithmetic for the
349    // claim to be about and a program that reads one of these has already been told there is
350    // none. And the library makes the claim anyway: the `#else` in `<stdc-predef.h>` is reached
351    // by a compiler that says nothing about its intent, and it presumes an older compiler that
352    // meant yes. Saying nothing therefore does not withhold anything, it only makes the value
353    // arrive from somewhere else.
354    d.set("__STDC_IEC_60559_COMPLEX__", "201404L");
355    d.set("__STDC_ISO_10646__", "201706L");
356    // The type behind `char8_t`, which C23 added and no dialect before it has. It sits here
357    // rather than next to `__CHAR16_TYPE__` and `__CHAR32_TYPE__` because those two are the
358    // same in every dialect and this one is not, which is the whole reason a header can test
359    // for it: gcc's own `stdatomic.h` writes `atomic_char8_t` under `#ifdef __CHAR8_TYPE__`
360    // and gets it in C23 and not in C17.
361    d.set_if(opts.std == Std::C23, "__CHAR8_TYPE__", "unsigned char");
362    // C11 made these conditional features, and a header that sees `__STDC_VERSION__` at
363    // 201112 with no `__STDC_NO_ATOMICS__` next to it will use `_Atomic`. Each one here is a
364    // claim not to have something, so each one is only correct while it stays true: atomics
365    // because there is no `stdatomic.h` to include, threads because there is no `threads.h`,
366    // and complex because the arithmetic is not lowered.
367    //
368    // Variable length arrays are not on this list, because they work. Claiming otherwise is
369    // not a harmless overstatement of caution: glibc's `regex.h` writes the bound of
370    // `regexec`'s match array as `_REGEX_NELTS (__nmatch)`, which is the parameter when the
371    // dialect has them and nothing at all when a compiler says it does not, so the claim
372    // silently changes a declaration in a header rather than turning something off.
373    if opts.std.has_c11() {
374        d.flag("__STDC_NO_ATOMICS__");
375        d.flag("__STDC_NO_THREADS__");
376        d.flag("__STDC_NO_COMPLEX__");
377    }
378    // What `__has_embed` answers with. They are defined in every dialect and not only in C23,
379    // because the operator is answerable in every dialect and a header that writes
380    // `#if __has_embed(...) == __STDC_EMBED_FOUND__` under `-std=gnu17` would otherwise be
381    // comparing against zero and taking the not found branch on a resource that is there.
382    d.set("__STDC_EMBED_NOT_FOUND__", "0");
383    d.set("__STDC_EMBED_FOUND__", "1");
384    d.set("__STDC_EMBED_EMPTY__", "2");
385}
386
387/// The memory orders and the lock free answers.
388///
389/// These are here whether or not `_Atomic` is, and `__STDC_NO_ATOMICS__` does not turn them
390/// off, because they are the numbering the `__atomic` builtins take rather than a promise
391/// about the language. musl's `stdatomic.h` writes `memory_order_relaxed = __ATOMIC_RELAXED`
392/// with no test around it at all, so a compiler without them prints an enumerator whose value
393/// is an identifier.
394///
395/// Two means always lock free, and every integer type gets a two on all three targets, which
396/// are all sixty four bit machines. `long long` is the one that would change on a thirty two
397/// bit target, where a double word load is an instruction the machine may or may not have.
398fn atomics(d: &mut Defs, target: &TargetInfo) {
399    d.set("__ATOMIC_RELAXED", "0");
400    d.set("__ATOMIC_CONSUME", "1");
401    d.set("__ATOMIC_ACQUIRE", "2");
402    d.set("__ATOMIC_RELEASE", "3");
403    d.set("__ATOMIC_ACQ_REL", "4");
404    d.set("__ATOMIC_SEQ_CST", "5");
405    // The gate is the machine word rather than `long`, because Windows has a thirty two bit
406    // `long` on a sixty four bit machine and its `long long` is still one instruction.
407    let llong = if target.pointer_width == 64 { "2" } else { "1" };
408    for name in [
409        "BOOL", "CHAR", "CHAR8_T", "CHAR16_T", "CHAR32_T", "WCHAR_T", "SHORT", "INT", "LONG",
410        "POINTER",
411    ] {
412        d.set(&format!("__GCC_ATOMIC_{name}_LOCK_FREE"), "2");
413    }
414    // The one that is not always two: a target whose word is thirty two bits wide can only
415    // promise `long long` is lock free if it has a double word instruction, and the honest
416    // answer there is sometimes rather than always.
417    d.set("__GCC_ATOMIC_LLONG_LOCK_FREE", llong);
418    d.set("__GCC_ATOMIC_TEST_AND_SET_TRUEVAL", "1");
419    // What `__sync_bool_compare_and_swap` works on, one macro per width in bytes. Every target
420    // here has the instruction at all four, and glibc reads these rather than the `__atomic_*`
421    // set because they are the older question and the answer is the same one.
422    for width in [1, 2, 4, 8] {
423        d.flag(&format!("__GCC_HAVE_SYNC_COMPARE_AND_SWAP_{width}"));
424    }
425    // The two flag bits an x86 memory order can carry, for the hardware lock elision prefixes.
426    // They are numbers a program passes back to a builtin rather than a claim that the prefix
427    // is emitted, and a program that computes one on a machine where the macro is missing gets
428    // a preprocessor error rather than a slower atomic.
429    if target.tuple.arch() == tuple::Arch::X86_64 {
430        d.set("__ATOMIC_HLE_ACQUIRE", "65536");
431        d.set("__ATOMIC_HLE_RELEASE", "131072");
432    }
433}
434
435/// What the optimizer level says.
436fn optimization(d: &mut Defs, opts: &Predef) {
437    d.flag_if(opts.opt_level.runs_optimizer(), "__OPTIMIZE__");
438    d.flag_if(opts.opt_level.is_size(), "__OPTIMIZE_SIZE__");
439    // glibc's headers test this before deciding whether to define a function as an inline
440    // wrapper, so getting it wrong changes what a program links against.
441    d.flag_if(!opts.opt_level.runs_optimizer(), "__NO_INLINE__");
442    // Zero, and zero until there is a `-ffast-math` to make it one. glibc's `math.h` reads it
443    // to decide whether to declare the `__*_finite` aliases, so it has to be defined rather
444    // than merely not claimed: a header testing `#if __FINITE_MATH_ONLY__ > 0` on a compiler
445    // that leaves it undefined takes the same branch, but one writing `#if
446    // !__FINITE_MATH_ONLY__` is a different question and gcc gives it an answer.
447    d.set("__FINITE_MATH_ONLY__", "0");
448}
449
450/// The architecture, the operating system and the object format.
451fn platform(d: &mut Defs, target: &TargetInfo, opts: &Predef) {
452    // The macros a target with no backend predefines are not written down here. They are a
453    // header's whole view of the machine, a wrong one is a header taking a branch written for
454    // another processor, and there is nothing cheap that would catch it. The driver takes a three
455    // field triple, so a target this cannot spell is one nobody can ask for yet rather than a
456    // hole in what it answers.
457    let Some(triple) = Triple::from_tuple(target.tuple) else {
458        return;
459    };
460    match triple.arch {
461        Arch::X86_64 => {
462            d.flag("__x86_64__");
463            d.flag("__x86_64");
464            d.flag("__amd64__");
465            d.flag("__amd64");
466            d.flag("__SSE__");
467            d.flag("__SSE2__");
468            d.flag("__MMX__");
469            d.flag("__SSE_MATH__");
470            d.flag("__SSE2_MATH__");
471            d.flag("__k8");
472            d.flag("__k8__");
473            // FXSAVE and FXRSTOR, which every x86-64 has, and the small code model, which is
474            // the default and the only one a program gets without being told otherwise.
475            d.flag("__FXSR__");
476            d.flag("__code_model_small__");
477            // The MMX registers are not used on x86-64: the sixty four bit operations go
478            // through SSE instead. gcc's own `xmmintrin.h` reads this to decide how to write
479            // `_mm_maskmove_si64`, so a compiler that leaves it undefined is handed a
480            // different function body than gcc is, which is what the header sweep found.
481            d.flag("__MMX_WITH_SSE__");
482        }
483        Arch::Aarch64 => {
484            d.flag("__aarch64__");
485            d.flag("__AARCH64EL__");
486            d.set("__ARM_ARCH", "8");
487            d.set("__ARM_ARCH_PROFILE", "'A'");
488            d.set("__ARM_64BIT_STATE", "1");
489            d.set("__ARM_ALIGN_MAX_PWR", "28");
490            d.set("__ARM_FP", "0xe");
491            d.set("__ARM_NEON", "1");
492            d.set("__ARM_FEATURE_UNALIGNED", "1");
493            d.set("__ARM_PCS_AAPCS64", "1");
494        }
495        Arch::Riscv64 => {
496            d.flag("__riscv");
497            d.set("__riscv_xlen", "64");
498            d.set("__riscv_flen", "64");
499            d.flag("__riscv_float_abi_double");
500            d.flag("__riscv_muldiv");
501            d.flag("__riscv_atomic");
502            d.flag("__riscv_compressed");
503            d.set("__riscv_cmodel_medlow", "1");
504        }
505    }
506    match triple.os {
507        Os::Linux => {
508            d.flag("__linux__");
509            d.flag("__linux");
510            d.flag("__unix__");
511            d.flag("__unix");
512            d.flag("__gnu_linux__");
513            d.flag("__ELF__");
514            // The unarmoured spellings are not reserved identifiers, so a strict mode may not
515            // define them. Autoconf still tests for `linux`, which is why they exist at all.
516            if opts.gnu_extensions {
517                d.flag("linux");
518                d.flag("unix");
519            }
520        }
521        Os::Darwin => {
522            d.flag("__APPLE__");
523            d.flag("__MACH__");
524            d.flag("__unix__");
525            d.flag("__unix");
526            d.set("__APPLE_CC__", "6000");
527            d.set("__DYNAMIC__", "1");
528            if triple.arch == Arch::Aarch64 {
529                // Apple's own spelling of the architecture, which its headers use rather than
530                // __aarch64__. sys/cdefs.h tests for it by name and reaches an #error called
531                // "Unsupported architecture" without it, so every system header on this
532                // platform fails on the first include until these two are here.
533                d.flag("__arm64__");
534                d.flag("__arm64");
535            }
536            if opts.gnu_extensions {
537                d.flag("unix");
538            }
539        }
540        Os::Windows => {
541            // Every spelling gcc has for this platform, because the mingw-w64 tree reads more
542            // than one of them and a missing one is a declaration that quietly is not there.
543            // `winuser.h` guards `EndTask` with `#ifdef WINNT` and `rpcdcep.h` guards six
544            // declarations with `#ifndef WINNT`, so a compiler that leaves it undefined
545            // preprocesses `windows.h` to a different set of functions than gcc does, which is
546            // what the token comparison against a real mingw install found.
547            d.flag("_WIN32");
548            d.flag("__WIN32");
549            d.flag("__WIN32__");
550            d.flag("__WINNT");
551            d.flag("__WINNT__");
552            d.flag("__MINGW32__");
553            // Not the machine word: `_WIN64` says the pointer is sixty four bits wide, and
554            // i686-w64-mingw32-gcc defines neither it nor `__MINGW64__`.
555            if target.pointer_width == 64 {
556                d.flag("_WIN64");
557                d.flag("__WIN64");
558                d.flag("__WIN64__");
559                d.flag("__MINGW64__");
560            }
561            // Which kind of exception machinery the platform has, and on this one there is only
562            // the one: a table the operating system reads rather than anything the prologue
563            // registers. mingw's `setjmp.h` reads this to choose the two argument `_setjmp`,
564            // whose second argument is `__builtin_frame_address(0)` and becomes the frame
565            // `longjmp` asks `RtlUnwindEx` to unwind to. That is the same address the function's
566            // own unwind record reports, because the record names the frame pointer with an
567            // offset of zero and the prologue leaves the pointer holding the body's stack
568            // pointer, so the number the builtin answers with and the number the walk arrives at
569            // are the same number by construction. Only for the architecture whose records this
570            // compiler writes: x86_64-w64-mingw32-gcc defines it and i686-w64-mingw32-gcc does
571            // not, because a thirty two bit Windows unwinds some other way.
572            if triple.arch == Arch::X86_64 && target.pointer_width == 64 {
573                d.flag("__SEH__");
574            }
575            // Which C runtime the headers are configured for. The sysroot this compiler fetches
576            // is built `--with-default-msvcrt=msvcrt` to match the link line, which names
577            // `libmsvcrt.a`, and gcc defines this for the same tree.
578            d.flag("__MSVCRT__");
579            // The widest integer the compiler has, which is what Microsoft's headers ask
580            // instead of asking about `long long`.
581            d.set("_INTEGRAL_MAX_BITS", "64");
582            // The unarmoured three, which are not reserved identifiers, so a strict mode may
583            // not define them and gcc does not. Windows code tests all three anyway, the same
584            // way portable Unix code still tests `linux`.
585            if opts.gnu_extensions {
586                d.flag("WIN32");
587                d.flag("WINNT");
588                if target.pointer_width == 64 {
589                    d.flag("WIN64");
590                }
591            }
592            windows_spellings(d, opts);
593        }
594        Os::None => {
595            // Freestanding. `__ELF__` still holds, because the object format is a property of
596            // the target rather than of having an operating system under it.
597            d.flag("__ELF__");
598        }
599    }
600    match triple.env {
601        Env::Musl => d.flag("__musl__"),
602        Env::Gnu | Env::None | Env::Msvc => {}
603    }
604    // The version of the libc's headers, and only when they are the tree we bundle. One tree serves
605    // every glibc release with the differences written as `#if __GLIBC_MINOR__ >= n` inside the
606    // files, so the release is the part of it the target supplies and the compiler is what supplies
607    // it. Zig patches the same macro into the same tree the same way, which is where the spelling
608    // comes from rather than from a scheme of ours: `__GLIBC_PREREQ` reads it and so does every
609    // autoconf probe ever written.
610    //
611    // The condition is the whole of it and it is not here. A host glibc defines this macro in its
612    // own `features.h` and so does a tree the user named, and a second definition with a different
613    // value is a warning on every compilation, so the driver decides and this writes down what it
614    // decided.
615    if let Some(minor) = opts.glibc_minor {
616        d.set("__GLIBC_MINOR__", &minor.to_string());
617    }
618    // LP64 is the model everywhere except Windows, and a great deal of code tests for it
619    // rather than testing pointer and long widths separately.
620    if target.long_width == 64 && target.pointer_width == 64 {
621        d.flag("__LP64__");
622        d.flag("_LP64");
623    }
624    // What the assembler prepends to a C name to get the symbol. Mach-O keeps the leading
625    // underscore that every a.out toolchain had and ELF dropped it. It has to be defined even
626    // where it is empty, because of how it is used: glibc writes `__asm__ (__ASMNAME (name))`
627    // and that stringifies `__USER_LABEL_PREFIX__`, so a compiler that leaves it undefined
628    // does not get an error, it gets the name of the macro as the string and renames the
629    // function.
630    d.set("__USER_LABEL_PREFIX__", if triple.os == Os::Darwin { "_" } else { "" });
631    // Its counterpart, what the assembler puts in front of a register name. Empty on every
632    // target here, since all three assemble in a syntax that does not mark registers, and
633    // defined anyway for the same reason as the line above: it is used inside a stringize.
634    d.set("__REGISTER_PREFIX__", "");
635
636    // Position independent code is the default on the ELF targets and on Apple's, which is
637    // what a distribution build expects. The value 2 is GCC's for `-fPIC` rather than `-fpic`.
638    //
639    // Both are defined whichever link the output is for, because `__PIC__` says there are no
640    // absolute addresses in the text and that is true either way. What says which link it is is
641    // `__PIE__`, and a program reads it to find out whether a name it exports is one something
642    // else may replace. gcc defines it under `-fPIE` and under the default on a distribution
643    // where the default is an executable, which is the default here too.
644    if !matches!(triple.os, Os::Windows) {
645        d.set("__PIC__", "2");
646        d.set("__pic__", "2");
647        if opts.pic == Pic::Executable {
648            d.set("__PIE__", "2");
649            d.set("__pie__", "2");
650        }
651    }
652}
653
654/// The five spellings a Windows header writes a calling convention and an attribute in.
655///
656/// `int __cdecl f(void);` is the second declaration in mingw-w64's `stdio.h` and it stops a parser
657/// that has never heard of `__cdecl`, which reads it as the name being declared and then finds a
658/// second one. None of the five is a keyword, though: gcc defines every one of them as a macro over
659/// the GNU spelling of the same thing, which is why they are keywords on Windows and nowhere else
660/// without anything in its lexer being told what the target is. `-dM -E` on a mingw-w64 gcc prints
661/// exactly the lines below.
662///
663/// `__declspec(x)` being the GNU spelling of its argument is the part worth saying out loud, since
664/// it means `__declspec(dllimport)` and `__attribute__((dllimport))` cannot come to mean different
665/// things: there is one attribute and two ways of writing it, and everything that reads attributes
666/// reads both.
667///
668/// On x86-64 all four conventions name the one convention the target has, so the attributes go
669/// where every attribute nothing implements goes, which is left on the declaration. On i386 they
670/// differ over who pops the arguments and the choice is written into the symbol name, which is
671/// document 06.5 and is that target's work when there is one.
672fn windows_spellings(d: &mut Defs, opts: &Predef) {
673    for name in ["cdecl", "stdcall", "fastcall", "thiscall"] {
674        d.set(&format!("__{name}"), &format!("__attribute__((__{name}__))"));
675        // The single underscore spellings are not in the reserved namespace, so an implementation
676        // may not take them in a strict ISO mode and gcc does not.
677        if opts.gnu_extensions {
678            d.set(&format!("_{name}"), &format!("__attribute__((__{name}__))"));
679        }
680    }
681    d.set("__declspec(x)", "__attribute__((x))");
682}
683
684/// `__CHAR_BIT__`, the `__SIZEOF_*__` family and the alignment macros.
685fn sizes(d: &mut Defs, target: &TargetInfo) {
686    let pointer = target.pointer_width / 8;
687    // The two hardware interference sizes, which say how far apart two objects have to be for
688    // a write to one not to invalidate the other's cache line, and how close together two have
689    // to be to share one. A cache line is sixty four bytes on every target here, so the two
690    // answers are the same number and gcc gives the same number as well.
691    d.set("__GCC_CONSTRUCTIVE_SIZE", "64");
692    d.set("__GCC_DESTRUCTIVE_SIZE", "64");
693    let long = target.long_width / 8;
694    let long_double = target.long_double_width / 8;
695    d.set("__CHAR_BIT__", "8");
696    d.set("__SIZEOF_SHORT__", "2");
697    d.set("__SIZEOF_INT__", "4");
698    d.set("__SIZEOF_LONG__", &long.to_string());
699    d.set("__SIZEOF_LONG_LONG__", "8");
700    d.set("__SIZEOF_INT128__", "16");
701    d.set("__SIZEOF_FLOAT__", "4");
702    d.set("__SIZEOF_DOUBLE__", "8");
703    d.set("__SIZEOF_LONG_DOUBLE__", &long_double.to_string());
704    d.set("__SIZEOF_POINTER__", &pointer.to_string());
705    d.set("__SIZEOF_SIZE_T__", &pointer.to_string());
706    d.set("__SIZEOF_PTRDIFF_T__", &pointer.to_string());
707    d.set("__SIZEOF_WCHAR_T__", &wchar(target).size.to_string());
708    // From the spelling rather than from a constant, because Windows makes `wint_t` a
709    // `short unsigned int` and this said four bytes there while `__WINT_WIDTH__` said sixteen
710    // bits two hundred lines away.
711    d.set("__SIZEOF_WINT_T__", &(wint(target).width / 8).to_string());
712    d.set("__BIGGEST_ALIGNMENT__", "16");
713    // The `__BYTE_ORDER__` family, which the kernel and every serialisation library read.
714    // The names of the orders are defined whichever one is in force, because code compares
715    // against both.
716    d.set("__ORDER_LITTLE_ENDIAN__", "1234");
717    d.set("__ORDER_BIG_ENDIAN__", "4321");
718    d.set("__ORDER_PDP_ENDIAN__", "3412");
719    let order =
720        if target.little_endian { "__ORDER_LITTLE_ENDIAN__" } else { "__ORDER_BIG_ENDIAN__" };
721    d.set("__BYTE_ORDER__", order);
722    d.set("__FLOAT_WORD_ORDER__", order);
723    d.flag_if(!target.char_is_signed, "__CHAR_UNSIGNED__");
724}
725
726/// How `wchar_t` is spelled on a target, and what it holds.
727struct Wchar {
728    /// The C type it is a name for.
729    spelling: &'static str,
730    /// Its width in bytes.
731    size: u32,
732    /// `__WCHAR_MAX__`.
733    max: &'static str,
734    /// `__WCHAR_MIN__`.
735    min: &'static str,
736}
737
738/// `wchar_t` is the type that divides the targets most and is written down least.
739///
740/// Windows makes it 16 bits so that a wide string is UTF-16. AArch64 Linux makes it unsigned,
741/// following the psABI's rule for plain `char`, while x86-64 Linux makes it signed. Code that
742/// compares a `wchar_t` against a negative value is correct on one and not on the other.
743///
744/// The width and the signedness come from the target description rather than from another match
745/// on the triple, because the lexer needs the same two facts to convert a wide literal and the
746/// two answers have to be the same one.
747fn wchar(target: &TargetInfo) -> Wchar {
748    match (target.wchar_width, target.wchar_is_signed) {
749        (16, false) => Wchar { spelling: "short unsigned int", size: 2, max: "0xffff", min: "0" },
750        (16, true) => Wchar { spelling: "short int", size: 2, max: "0x7fff", min: "(-32767 - 1)" },
751        (_, false) => Wchar { spelling: "unsigned int", size: 4, max: "0xffffffffU", min: "0U" },
752        (_, true) => {
753            Wchar { spelling: "int", size: 4, max: "0x7fffffff", min: "(-__WCHAR_MAX__ - 1)" }
754        }
755    }
756}
757
758/// How `wint_t` is spelled on a target, and what it holds.
759struct Wint {
760    /// The C type it is a name for.
761    spelling: &'static str,
762    /// `__WINT_MAX__`.
763    max: &'static str,
764    /// `__WINT_MIN__`.
765    min: &'static str,
766    /// `__WINT_WIDTH__`, which follows the spelling rather than `__SIZEOF_WINT_T__`.
767    width: u32,
768}
769
770/// `wint_t` does not follow `wchar_t`, and Darwin is where that shows.
771///
772/// Apple makes it a signed `int`, so that `WEOF` is negative the way `EOF` is, while Linux
773/// makes it `unsigned int` and gives `WEOF` the value `0xffffffff`. The SDK's `arm/_types.h`
774/// spells `__darwin_wint_t` as `__WINT_TYPE__` and nothing else, so getting this wrong changes
775/// the signedness of every wide character function's argument on that platform.
776fn wint(target: &TargetInfo) -> Wint {
777    match target.tuple.os() {
778        tuple::Os::Windows => {
779            Wint { spelling: "short unsigned int", max: "0xffff", min: "0", width: 16 }
780        }
781        os if os.is_darwin() => {
782            Wint { spelling: "int", max: "0x7fffffff", min: "(-__WINT_MAX__ - 1)", width: 32 }
783        }
784        _ => Wint { spelling: "unsigned int", max: "0xffffffffU", min: "0U", width: 32 },
785    }
786}
787
788/// The integer type names, their limits, and the exact width family.
789fn integers(d: &mut Defs, target: &TargetInfo) {
790    // The one fact everything below turns on: which type is 64 bits wide. On LP64 it is
791    // `long`, and on Windows LLP64 it is `long long`, and every `size_t`, `intmax_t` and
792    // `int64_t` spelling follows from that.
793    let lp64 = target.long_width == 64;
794    let wide = if lp64 { "long int" } else { "long long int" };
795    let wide_unsigned = if lp64 { "long unsigned int" } else { "long long unsigned int" };
796    let wide_suffix = if lp64 { "L" } else { "LL" };
797    let wide_max = format!("0x7fffffffffffffff{wide_suffix}");
798    let wide_umax = format!("0xffffffffffffffffU{wide_suffix}");
799
800    d.set("__SCHAR_MAX__", "0x7f");
801    d.set("__SHRT_MAX__", "0x7fff");
802    d.set("__INT_MAX__", "0x7fffffff");
803    d.set("__LONG_MAX__", if lp64 { "0x7fffffffffffffffL" } else { "0x7fffffffL" });
804    d.set("__LONG_LONG_MAX__", "0x7fffffffffffffffLL");
805    d.set("__INTMAX_MAX__", &wide_max);
806    d.set("__UINTMAX_MAX__", &wide_umax);
807    d.set("__SIZE_MAX__", &wide_umax);
808    d.set("__PTRDIFF_MAX__", &wide_max);
809    d.set("__INTPTR_MAX__", &wide_max);
810    d.set("__UINTPTR_MAX__", &wide_umax);
811    d.set("__SIG_ATOMIC_MAX__", "0x7fffffff");
812    d.set("__SIG_ATOMIC_MIN__", "(-__SIG_ATOMIC_MAX__ - 1)");
813    // The widest `_BitInt` this compiler builds, which is narrower than gcc 16's sixty five
814    // thousand five hundred and thirty five because a folded constant here is a hundred and
815    // twenty eight bits wide. A program that reads this macro to decide what to write gets an
816    // answer it can rely on, which is the point of saying a number smaller than gcc's rather
817    // than saying gcc's and refusing what it asked for. `MAX_BIT_INT_WIDTH` in `rucc-sema` is
818    // the same number and has to be changed with it.
819    d.set("__BITINT_MAXWIDTH__", "128");
820
821    let wchar = wchar(target);
822    d.set("__WCHAR_TYPE__", wchar.spelling);
823    d.set("__WCHAR_MAX__", wchar.max);
824    d.set("__WCHAR_MIN__", wchar.min);
825    let wint = wint(target);
826    d.set("__WINT_TYPE__", wint.spelling);
827    d.set("__WINT_MAX__", wint.max);
828    d.set("__WINT_MIN__", wint.min);
829    d.set("__SIZE_TYPE__", wide_unsigned);
830    d.set("__PTRDIFF_TYPE__", wide);
831    d.set("__INTMAX_TYPE__", wide);
832    d.set("__UINTMAX_TYPE__", wide_unsigned);
833    d.set("__INTPTR_TYPE__", wide);
834    d.set("__UINTPTR_TYPE__", wide_unsigned);
835    d.set("__SIG_ATOMIC_TYPE__", "int");
836    d.set("__CHAR16_TYPE__", "short unsigned int");
837    d.set("__CHAR32_TYPE__", "unsigned int");
838    d.set("__INTMAX_C(c)", &format!("c ## {wide_suffix}"));
839    d.set("__UINTMAX_C(c)", &format!("c ## U{wide_suffix}"));
840
841    // The exact width family, which is what a freestanding `stdint.h` is written out of.
842    exact(d, 8, "signed char", "unsigned char", "0x7f", "0xff", "");
843    exact(d, 16, "short int", "short unsigned int", "0x7fff", "0xffff", "");
844    // No suffix. An `int` needs none, and the `U` on the unsigned side is added by `exact`
845    // rather than being part of the width.
846    exact(d, 32, "int", "unsigned int", "0x7fffffff", "0xffffffffU", "");
847    exact(d, 64, wide, wide_unsigned, &wide_max, &wide_umax, wide_suffix);
848
849    // The fast types. GCC makes the 16 and 32 bit ones `long` on x86-64 glibc and `int`
850    // everywhere else, and a header that computes a printf format from the type name notices
851    // the difference.
852    //
853    // musl is the reason this is not simply a question of the architecture. musl defines
854    // `int_fast16_t` and `int_fast32_t` as `int32_t` on every target it supports, GCC built
855    // for a musl target agrees with it, and GCC built for glibc on the same processor does
856    // not. The place it shows is `stdatomic.h`, which GCC ships and writes directly out of
857    // these macros: `typedef _Atomic __INT_FAST16_TYPE__ atomic_int_fast16_t;`. Get this wrong
858    // and every atomic fast type in the program is the wrong width.
859    let fast_is_wide = target.tuple.arch() == tuple::Arch::X86_64
860        && lp64
861        && target.tuple.env() != tuple::Env::Musl;
862    let fast_middle = if fast_is_wide { wide } else { "int" };
863    // Windows is the exception in the other direction, and it is only the 16 bit one. mingw's
864    // `stdint.h` makes `int_fast16_t` a `short` and gcc for that target says the same, while
865    // `int_fast32_t` there is the `int` it is nearly everywhere, so the two cannot share an
866    // answer on this platform the way they do on the others. The measurement is the mingw tree,
867    // which is the only Windows header tree this compiler fetches, and the msvc environment is
868    // given the same answer because nothing compiles against a tree of Microsoft's yet.
869    let fast16_is_short = target.tuple.os() == tuple::Os::Windows;
870    d.set("__INT_FAST8_TYPE__", "signed char");
871    d.set("__UINT_FAST8_TYPE__", "unsigned char");
872    d.set("__INT_FAST8_MAX__", "0x7f");
873    d.set("__UINT_FAST8_MAX__", "0xff");
874    for width in [16, 32] {
875        let (signed, unsigned, max, umax) = if width == 16 && fast16_is_short {
876            ("short int", "short unsigned int", "0x7fff", "0xffff")
877        } else if fast_middle == "int" {
878            ("int", "unsigned int", "0x7fffffff", "0xffffffffU")
879        } else {
880            (wide, wide_unsigned, wide_max.as_str(), wide_umax.as_str())
881        };
882        d.set(&format!("__INT_FAST{width}_TYPE__"), signed);
883        d.set(&format!("__UINT_FAST{width}_TYPE__"), unsigned);
884        d.set(&format!("__INT_FAST{width}_MAX__"), max);
885        d.set(&format!("__UINT_FAST{width}_MAX__"), umax);
886    }
887    d.set("__INT_FAST64_TYPE__", wide);
888    d.set("__UINT_FAST64_TYPE__", wide_unsigned);
889    d.set("__INT_FAST64_MAX__", &wide_max);
890    d.set("__UINT_FAST64_MAX__", &wide_umax);
891
892    let fast32 = if fast_is_wide { 64 } else { 32 };
893    widths(d, target, &wchar, &wint, if fast16_is_short { 16 } else { fast32 }, fast32);
894}
895
896/// The widths, which C23's `limits.h` and `stdint.h` are written out of.
897///
898/// Twenty macros and not a few more: there is no `__INT8_WIDTH__`, because the width of an
899/// exact width type is in its name and gcc does not define one, and there is no unsigned member
900/// of any of these pairs, because a signed type and its unsigned counterpart have the same
901/// width and `UINTMAX_WIDTH` is written `__INTMAX_WIDTH__` in every header that needs it.
902///
903/// Each of these says how many value bits and sign bits the type has, which is not the same as
904/// how many bits it occupies. They agree for every type on every target here, and the day one of
905/// them does not, this is the family that has to say the smaller number.
906fn widths(d: &mut Defs, target: &TargetInfo, wchar: &Wchar, wint: &Wint, fast16: u32, fast32: u32) {
907    let pointer = target.pointer_width;
908    d.set("__SCHAR_WIDTH__", "8");
909    d.set("__SHRT_WIDTH__", "16");
910    d.set("__INT_WIDTH__", "32");
911    d.set("__LONG_WIDTH__", &target.long_width.to_string());
912    d.set("__LONG_LONG_WIDTH__", "64");
913    d.set("__INTMAX_WIDTH__", "64");
914    d.set("__INTPTR_WIDTH__", &pointer.to_string());
915    d.set("__PTRDIFF_WIDTH__", &pointer.to_string());
916    d.set("__SIZE_WIDTH__", &pointer.to_string());
917    d.set("__SIG_ATOMIC_WIDTH__", "32");
918    d.set("__WCHAR_WIDTH__", &(wchar.size * 8).to_string());
919    d.set("__WINT_WIDTH__", &wint.width.to_string());
920    for width in [8, 16, 32, 64] {
921        d.set(&format!("__INT_LEAST{width}_WIDTH__"), &width.to_string());
922    }
923    d.set("__INT_FAST8_WIDTH__", "8");
924    d.set("__INT_FAST16_WIDTH__", &fast16.to_string());
925    d.set("__INT_FAST32_WIDTH__", &fast32.to_string());
926    d.set("__INT_FAST64_WIDTH__", "64");
927}
928
929/// One width of the exact and least families, which are the same types.
930fn exact(
931    d: &mut Defs,
932    width: u32,
933    signed: &str,
934    unsigned: &str,
935    max: &str,
936    umax: &str,
937    // The suffix the width needs and nothing more, so `""`, `"L"` or `"LL"`. The `U` that
938    // makes a constant unsigned is added below and is not part of this, because a caller that
939    // wrote it here would produce `UU` on the unsigned macro and a stray `U` on the signed one.
940    width_suffix: &str,
941) {
942    d.set(&format!("__INT{width}_TYPE__"), signed);
943    d.set(&format!("__UINT{width}_TYPE__"), unsigned);
944    d.set(&format!("__INT{width}_MAX__"), max);
945    d.set(&format!("__UINT{width}_MAX__"), umax);
946    d.set(&format!("__INT_LEAST{width}_TYPE__"), signed);
947    d.set(&format!("__UINT_LEAST{width}_TYPE__"), unsigned);
948    d.set(&format!("__INT_LEAST{width}_MAX__"), max);
949    d.set(&format!("__UINT_LEAST{width}_MAX__"), umax);
950    // The constant makers. `__INT8_C(1)` is `1` and not `1 ## `, because a paste with nothing
951    // on the right is not a token the expander should have to think about.
952    //
953    // The `U` goes on only where the type is still unsigned after promotion. `uint8_t` and
954    // `uint16_t` are narrower than `int`, so an integer promotion turns them into a signed
955    // `int` and `UINT8_C(1)` has that type in gcc and in the standard's own words. Writing
956    // `1U` there is not a harmless extra: `UINT8_C(1) - 2` comes out as four billion odd
957    // instead of minus one, and a `_Generic` on it picks the unsigned arm. Every target this
958    // compiler has makes `int` thirty two bits, which is what makes the width enough to decide.
959    let unsigned_after_promotion = width >= 32;
960    let u = if unsigned_after_promotion { "U" } else { "" };
961    if width_suffix.is_empty() && u.is_empty() {
962        d.set(&format!("__INT{width}_C(c)"), "c");
963        d.set(&format!("__UINT{width}_C(c)"), "c");
964    } else if width_suffix.is_empty() {
965        d.set(&format!("__INT{width}_C(c)"), "c");
966        d.set(&format!("__UINT{width}_C(c)"), &format!("c ## {u}"));
967    } else {
968        d.set(&format!("__INT{width}_C(c)"), &format!("c ## {width_suffix}"));
969        d.set(&format!("__UINT{width}_C(c)"), &format!("c ## {u}{width_suffix}"));
970    }
971}
972
973/// What a header needs to know about one floating format, as the text the macros expand to.
974///
975/// The four values are written to the digit gcc writes them to rather than rounded to something
976/// tidier, because a header carrying its own copy of a limit compares the two spellings and a
977/// difference in the last place is a difference.
978struct Characteristics {
979    mant_dig: &'static str,
980    dig: &'static str,
981    min_exp: &'static str,
982    min_10_exp: &'static str,
983    max_exp: &'static str,
984    max_10_exp: &'static str,
985    decimal_dig: &'static str,
986    max: &'static str,
987    /// The largest value with a full significand, which is `max` for every format whose values
988    /// all have one and is smaller for the double-double, whose largest values do not.
989    ///
990    /// A double-double's high half can be as large as a `double` gets while its low half is
991    /// nowhere near, and the sum is then a number above anything the format can write with a
992    /// hundred and six significand bits behind it. So `LDBL_MAX` on PowerPC is `DBL_MAX` and
993    /// `LDBL_NORM_MAX` is a bit under half of it, and a program that reaches for the largest
994    /// value it can compute with wants the second.
995    norm_max: &'static str,
996    min: &'static str,
997    epsilon: &'static str,
998    denorm_min: &'static str,
999    /// Whether the format is one IEC 60559 describes, which every one of them is but the brain
1000    /// float, whose significand is a `float`'s with sixteen bits cut off the end of it, and the
1001    /// double-double, which is not a binary floating point format in IEC 60559's sense at all.
1002    is_iec_60559: &'static str,
1003}
1004
1005/// IEEE binary16, which is `_Float16`.
1006const HALF: Characteristics = Characteristics {
1007    mant_dig: "11",
1008    dig: "3",
1009    min_exp: "(-13)",
1010    min_10_exp: "(-4)",
1011    max_exp: "16",
1012    max_10_exp: "4",
1013    decimal_dig: "5",
1014    max: "6.55040000000000000000000000000000000e+4",
1015    norm_max: "6.55040000000000000000000000000000000e+4",
1016    min: "6.10351562500000000000000000000000000e-5",
1017    epsilon: "9.76562500000000000000000000000000000e-4",
1018    denorm_min: "5.96046447753906250000000000000000000e-8",
1019    is_iec_60559: "1",
1020};
1021
1022/// The brain float, which nothing here names yet and which every format table has a row for.
1023const BFLOAT16: Characteristics = Characteristics {
1024    mant_dig: "8",
1025    dig: "2",
1026    min_exp: "(-125)",
1027    min_10_exp: "(-37)",
1028    max_exp: "128",
1029    max_10_exp: "38",
1030    decimal_dig: "4",
1031    max: "3.38953138925153547590470800371487867e+38",
1032    norm_max: "3.38953138925153547590470800371487867e+38",
1033    min: "1.17549435082228750796873653722224568e-38",
1034    epsilon: "7.81250000000000000000000000000000000e-3",
1035    denorm_min: "9.18354961579912115600575419704879436e-41",
1036    is_iec_60559: "0",
1037};
1038
1039/// IEEE binary32, which is `float` and `_Float32`.
1040const SINGLE: Characteristics = Characteristics {
1041    mant_dig: "24",
1042    dig: "6",
1043    min_exp: "(-125)",
1044    min_10_exp: "(-37)",
1045    max_exp: "128",
1046    max_10_exp: "38",
1047    decimal_dig: "9",
1048    max: "3.40282346638528859811704183484516925e+38",
1049    norm_max: "3.40282346638528859811704183484516925e+38",
1050    min: "1.17549435082228750796873653722224568e-38",
1051    epsilon: "1.19209289550781250000000000000000000e-7",
1052    denorm_min: "1.40129846432481707092372958328991613e-45",
1053    is_iec_60559: "1",
1054};
1055
1056/// IEEE binary64, which is `double`, `_Float64`, `_Float32x` and `long double` on Apple and
1057/// on Windows.
1058const DOUBLE: Characteristics = Characteristics {
1059    mant_dig: "53",
1060    dig: "15",
1061    min_exp: "(-1021)",
1062    min_10_exp: "(-307)",
1063    max_exp: "1024",
1064    max_10_exp: "308",
1065    decimal_dig: "17",
1066    max: "1.79769313486231570814527423731704357e+308",
1067    norm_max: "1.79769313486231570814527423731704357e+308",
1068    min: "2.22507385850720138309023271733240406e-308",
1069    epsilon: "2.22044604925031308084726333618164062e-16",
1070    denorm_min: "4.94065645841246544176568792868221372e-324",
1071    is_iec_60559: "1",
1072};
1073
1074/// The x87 eighty bit format, which on x86-64 is both `long double` and `_Float64x`.
1075const X87: Characteristics = Characteristics {
1076    mant_dig: "64",
1077    dig: "18",
1078    min_exp: "(-16381)",
1079    min_10_exp: "(-4931)",
1080    max_exp: "16384",
1081    max_10_exp: "4932",
1082    decimal_dig: "21",
1083    max: "1.18973149535723176502126385303097021e+4932",
1084    norm_max: "1.18973149535723176502126385303097021e+4932",
1085    min: "3.36210314311209350626267781732175260e-4932",
1086    epsilon: "1.08420217248550443400745280086994171e-19",
1087    denorm_min: "3.64519953188247460252840593361941982e-4951",
1088    is_iec_60559: "1",
1089};
1090
1091/// IEEE binary128, which is `_Float128`, `_Float64x` off x86 and `long double` on AArch64 and
1092/// RISC-V Linux.
1093const QUAD: Characteristics = Characteristics {
1094    mant_dig: "113",
1095    dig: "33",
1096    min_exp: "(-16381)",
1097    min_10_exp: "(-4931)",
1098    max_exp: "16384",
1099    max_10_exp: "4932",
1100    decimal_dig: "36",
1101    max: "1.18973149535723176508575932662800702e+4932",
1102    norm_max: "1.18973149535723176508575932662800702e+4932",
1103    min: "3.36210314311209350626267781732175260e-4932",
1104    epsilon: "1.92592994438723585305597794258492732e-34",
1105    denorm_min: "6.47517511943802511092443895822764655e-4966",
1106    is_iec_60559: "1",
1107};
1108
1109/// IBM double-double, which is `long double` on 64-bit PowerPC.
1110///
1111/// The row that does not follow from a precision and an exponent range, because the format has
1112/// neither. `MANT_DIG` is 106 and `DIG` is 31, which are the figures near the top of the
1113/// significand and not everywhere. `MAX` is a little above `DBL_MAX`, since the high half can be
1114/// `DBL_MAX` and the low half then adds to it, and `NORM_MAX` is about half of that, so this is
1115/// the one row where the two are different numbers. `EPSILON` is the same number as `DENORM_MIN`,
1116/// two to the minus one thousand and seventy four, because the smallest value that changes a
1117/// double-double near one is a subnormal in the low half rather than one unit in the last place
1118/// of anything. `MIN` is two to the minus nine hundred and sixty nine rather than `DBL_MIN`,
1119/// because below that the low half has no room left to be normal in.
1120///
1121/// Every value here is what the reference compiler prints for `powerpc64le-linux-gnu`, checked
1122/// rather than derived, on the same terms as the data layouts in `rucc-abi`. The format is one
1123/// where deriving them is how the four wrong numbers in those layouts happened.
1124const DOUBLE_DOUBLE: Characteristics = Characteristics {
1125    mant_dig: "106",
1126    dig: "31",
1127    min_exp: "(-968)",
1128    min_10_exp: "(-291)",
1129    max_exp: "1024",
1130    max_10_exp: "308",
1131    decimal_dig: "33",
1132    max: "1.79769313486231580793728971405301e+308",
1133    norm_max: "8.98846567431157953864652595394501e+307",
1134    min: "2.00416836000897277799610805135016e-292",
1135    epsilon: "4.94065645841246544176568792868221e-324",
1136    denorm_min: "4.94065645841246544176568792868221e-324",
1137    is_iec_60559: "0",
1138};
1139
1140/// The row of the table a format has, so that a type the target chooses the format of can look
1141/// its own limits up rather than have them written out again per architecture.
1142const fn characteristics(format: Format) -> &'static Characteristics {
1143    match format {
1144        Format::Half => &HALF,
1145        Format::BFloat16 => &BFLOAT16,
1146        Format::Single => &SINGLE,
1147        Format::Double => &DOUBLE,
1148        Format::X87Extended => &X87,
1149        Format::Quad => &QUAD,
1150        Format::DoubleDouble => &DOUBLE_DOUBLE,
1151    }
1152}
1153
1154/// The `float.h` characteristics.
1155///
1156/// Nine families of them, which is `float`, `double` and `long double` and the six C23 named
1157/// them after. Two of the nine have a format the target decides: `long double`, which is x87 on
1158/// x86-64 Linux, quad on AArch64 and RISC-V Linux and a `double` on Apple and on Windows, and
1159/// `_Float64x`, which is the widest format the processor has and so does not follow `long
1160/// double` down on the targets that shrink it.
1161///
1162/// Three more have a target that decides whether they are there at all. `_Float64x` is missing
1163/// on a machine with nothing wider than a `double`, and `_Float16` and `_Float128` are missing
1164/// wherever the machine has no such format, which is four of the seven rows for the half and one
1165/// of them for the quad.
1166///
1167/// `__FLT128X_*__` is deliberately missing. `_Float128x` is a type no target gcc supports has,
1168/// so gcc defines nothing for it and neither does this.
1169fn floats(d: &mut Defs, target: &TargetInfo) {
1170    d.set("__FLT_RADIX__", "2");
1171    // Real arithmetic follows IEC 60559 in every format on every target here, which is what the
1172    // value two says. The complex one beside it says the same about complex arithmetic, and gcc
1173    // gives both the value two on every target this compiler has. These two are read rather than
1174    // tested: glibc's `<stdc-predef.h>` asks what the compiler intended and writes the
1175    // `__STDC_IEC_559` family from the answer, and a compiler that says nothing is presumed to
1176    // have meant yes. So the choice is not between claiming and not claiming, it is between
1177    // saying so and having it said for us.
1178    d.set("__GCC_IEC_559", "2");
1179    d.set("__GCC_IEC_559_COMPLEX", "2");
1180    // Every operation is done in the type of its operands, which is what SSE2 and the AArch64
1181    // and RISC-V floating units all do. The other two names are the same answer asked under the
1182    // rules of C99 and of TS 18661-3, which are the same rules for a target with no excess
1183    // precision to have, and glibc's `<math.h>` reads the last of the three.
1184    d.set("__FLT_EVAL_METHOD__", "0");
1185    d.set("__FLT_EVAL_METHOD_C99__", "0");
1186    d.set("__FLT_EVAL_METHOD_TS_18661_3__", "0");
1187
1188    family(d, "FLT", &SINGLE, |value| format!("{value}F"));
1189    // gcc writes the `double` values as `long double` constants cast back down, which is exact
1190    // in every format `long double` has and is the one family whose values are not a suffix.
1191    family(d, "DBL", &DOUBLE, |value| format!("((double){value}L)"));
1192    family(d, "LDBL", characteristics(target.long_double_format), |value| format!("{value}L"));
1193
1194    // The two named types that are not on every machine, each written where the type is and left
1195    // out where it is not. A program reads `__FLT128_MANT_DIG__` to find out whether it may write
1196    // the type, which is what glibc's `<float.h>` and `<math.h>` do, so the macros and the type
1197    // have to agree or the header asks for something the compiler will refuse.
1198    if target.has_float16 {
1199        family(d, "FLT16", &HALF, |value| format!("{value}F16"));
1200    }
1201    family(d, "FLT32", &SINGLE, |value| format!("{value}F32"));
1202    family(d, "FLT64", &DOUBLE, |value| format!("{value}F64"));
1203    if target.has_float128 {
1204        family(d, "FLT128", &QUAD, |value| format!("{value}F128"));
1205    }
1206    family(d, "FLT32X", &DOUBLE, |value| format!("{value}F32x"));
1207    // Nothing at all on a target whose widest format is a `double`, which is what gcc does
1208    // there: `_Float64x` is not a type on that machine and the family that describes it is not a
1209    // set of macros with a smaller answer in them.
1210    if let Some(format) = target.float64x_format {
1211        family(d, "FLT64X", characteristics(format), |value| format!("{value}F64x"));
1212    }
1213
1214    // The number itself rather than the name of the other macro. The value is the same either
1215    // way, since `long double` is the widest format here, but the two are not the same thing to
1216    // read: `-dM` prints what the macro is, and a program that undefines `__LDBL_DECIMAL_DIG__`
1217    // takes this one with it. gcc writes the number.
1218    d.set("__DECIMAL_DIG__", characteristics(target.long_double_format).decimal_dig);
1219}
1220
1221/// One family of `float.h` macros, named `__{prefix}_*__`.
1222///
1223/// `write` turns a value into the constant its macro expands to, which is a suffix for every
1224/// family but `double`.
1225fn family(d: &mut Defs, prefix: &str, c: &Characteristics, write: impl Fn(&str) -> String) {
1226    d.set(&format!("__{prefix}_MANT_DIG__"), c.mant_dig);
1227    d.set(&format!("__{prefix}_DIG__"), c.dig);
1228    d.set(&format!("__{prefix}_MIN_EXP__"), c.min_exp);
1229    d.set(&format!("__{prefix}_MIN_10_EXP__"), c.min_10_exp);
1230    d.set(&format!("__{prefix}_MAX_EXP__"), c.max_exp);
1231    d.set(&format!("__{prefix}_MAX_10_EXP__"), c.max_10_exp);
1232    d.set(&format!("__{prefix}_DECIMAL_DIG__"), c.decimal_dig);
1233    d.set(&format!("__{prefix}_MAX__"), &write(c.max));
1234    d.set(&format!("__{prefix}_NORM_MAX__"), &write(c.norm_max));
1235    d.set(&format!("__{prefix}_MIN__"), &write(c.min));
1236    d.set(&format!("__{prefix}_EPSILON__"), &write(c.epsilon));
1237    d.set(&format!("__{prefix}_DENORM_MIN__"), &write(c.denorm_min));
1238    d.set(&format!("__{prefix}_IS_IEC_60559__"), c.is_iec_60559);
1239    d.set(&format!("__{prefix}_HAS_DENORM__"), "1");
1240    d.set(&format!("__{prefix}_HAS_INFINITY__"), "1");
1241    d.set(&format!("__{prefix}_HAS_QUIET_NAN__"), "1");
1242}
1243
1244#[cfg(test)]
1245mod tests {
1246    use rucc_target::Triple;
1247
1248    use super::*;
1249
1250    fn set_for(triple: &str) -> String {
1251        let triple: Triple = triple.parse().expect("a triple the compiler supports");
1252        built_in(&TargetInfo::new(triple), &Predef::new())
1253    }
1254
1255    /// The same, for a machine the three field triple cannot spell.
1256    fn set_for_tuple(tuple: &str) -> String {
1257        let target = TargetInfo::for_tuple(tuple.parse().expect("a row in the target table"));
1258        built_in(&target, &Predef::new())
1259    }
1260
1261    fn has(text: &str, line: &str) -> bool {
1262        text.lines().any(|l| l == line)
1263    }
1264
1265    #[test]
1266    fn the_version_macros_say_the_version_this_compiler_was_built_at() {
1267        // They said 0.1.0 through sixty seven releases, because the number was written here as
1268        // well as in the manifest, so a program asking which rucc it was is now told.
1269        let text = set_for("x86_64-unknown-linux-gnu");
1270        assert!(has(&text, &format!("#define __rucc_version__ \"{VERSION}\"")), "{text}");
1271        assert!(has(&text, &format!("#define __VERSION__ \"rucc {VERSION}\"")), "{text}");
1272        assert!(has(&text, &format!("#define __rucc_major__ {}", field(VERSION, 0))));
1273        assert!(has(&text, &format!("#define __rucc_minor__ {}", field(VERSION, 1))));
1274        assert!(has(&text, &format!("#define __rucc_patchlevel__ {}", field(VERSION, 2))));
1275
1276        // And what each of them expands to is something an `#if` can read, which is the whole
1277        // reason the three numbers are separate macros from the string.
1278        for n in 0..3 {
1279            assert!(field(VERSION, n).parse::<u32>().is_ok(), "{}", field(VERSION, n));
1280        }
1281    }
1282
1283    #[test]
1284    fn a_version_field_is_the_digits_at_the_front_of_it() {
1285        assert_eq!(
1286            (field("0.10.68", 0), field("0.10.68", 1), field("0.10.68", 2)),
1287            ("0", "10", "68")
1288        );
1289
1290        // A pre-release suffix belongs to the string and not to the number an `#if` compares, and
1291        // a field that is not there at all is what a two field version means by its third.
1292        assert_eq!(field("0.10.68-rc.1", 2), "68");
1293        assert_eq!(field("1.0", 2), "0");
1294        assert_eq!(field("", 0), "0");
1295    }
1296
1297    #[test]
1298    fn the_set_is_driven_by_the_target_rather_than_by_the_host() {
1299        let x86 = set_for("x86_64-unknown-linux-gnu");
1300        let arm = set_for("aarch64-unknown-linux-gnu");
1301        assert!(has(&x86, "#define __x86_64__ 1"));
1302        assert!(!has(&x86, "#define __aarch64__ 1"));
1303        assert!(has(&arm, "#define __aarch64__ 1"));
1304        assert!(!has(&arm, "#define __x86_64__ 1"));
1305        assert!(has(&x86, "#define __linux__ 1") && has(&arm, "#define __linux__ 1"));
1306    }
1307
1308    #[test]
1309    fn windows_is_the_target_that_makes_long_thirty_two_bits() {
1310        let windows = set_for("x86_64-pc-windows-msvc");
1311        let linux = set_for("x86_64-unknown-linux-gnu");
1312        assert!(has(&windows, "#define __SIZEOF_LONG__ 4"));
1313        assert!(has(&windows, "#define __SIZE_TYPE__ long long unsigned int"));
1314        assert!(has(&windows, "#define __INT64_TYPE__ long long int"));
1315        assert!(!has(&windows, "#define __LP64__ 1"));
1316        assert!(has(&linux, "#define __SIZEOF_LONG__ 8"));
1317        assert!(has(&linux, "#define __SIZE_TYPE__ long unsigned int"));
1318        assert!(has(&linux, "#define __INT64_TYPE__ long int"));
1319        assert!(has(&linux, "#define __LP64__ 1"));
1320    }
1321
1322    #[test]
1323    fn windows_spells_a_calling_convention_and_an_attribute_as_macros() {
1324        // The second declaration in mingw-w64's stdio.h is `int __cdecl __mingw_sscanf(...)`, so
1325        // a Windows target where these are missing reads no header at all.
1326        let windows = set_for("x86_64-pc-windows-gnu");
1327        assert!(has(&windows, "#define __cdecl __attribute__((__cdecl__))"));
1328        assert!(has(&windows, "#define __stdcall __attribute__((__stdcall__))"));
1329        assert!(has(&windows, "#define __fastcall __attribute__((__fastcall__))"));
1330        assert!(has(&windows, "#define __thiscall __attribute__((__thiscall__))"));
1331        assert!(has(&windows, "#define _cdecl __attribute__((__cdecl__))"));
1332        assert!(has(&windows, "#define __declspec(x) __attribute__((x))"));
1333        let linux = set_for("x86_64-unknown-linux-gnu");
1334        assert!(!has(&linux, "#define __cdecl __attribute__((__cdecl__))"));
1335        assert!(!has(&linux, "#define __declspec(x) __attribute__((x))"));
1336    }
1337
1338    #[test]
1339    fn a_strict_mode_keeps_the_spellings_that_are_not_the_implementations_to_take() {
1340        // `_cdecl` is a name a program may use and `__cdecl` is not, so gcc defines the first
1341        // only where the extensions are on and the second everywhere.
1342        let mut opts = Predef::new();
1343        opts.gnu_extensions = false;
1344        let triple: Triple = "x86_64-pc-windows-gnu".parse().expect("a triple");
1345        let strict = built_in(&TargetInfo::new(triple), &opts);
1346        assert!(has(&strict, "#define __cdecl __attribute__((__cdecl__))"));
1347        assert!(!has(&strict, "#define _cdecl __attribute__((__cdecl__))"));
1348    }
1349
1350    #[test]
1351    fn wchar_t_is_the_type_that_divides_the_targets() {
1352        // Signed on x86-64 Linux, unsigned on AArch64 Linux, and sixteen bits on Windows.
1353        assert!(has(&set_for("x86_64-unknown-linux-gnu"), "#define __WCHAR_TYPE__ int"));
1354        assert!(has(&set_for("aarch64-unknown-linux-gnu"), "#define __WCHAR_TYPE__ unsigned int"));
1355        let windows = set_for("x86_64-pc-windows-msvc");
1356        assert!(has(&windows, "#define __WCHAR_TYPE__ short unsigned int"));
1357        assert!(has(&windows, "#define __SIZEOF_WCHAR_T__ 2"));
1358    }
1359
1360    #[test]
1361    fn apple_spells_the_architecture_its_own_way_and_its_headers_only_know_that_spelling() {
1362        // sys/cdefs.h reaches #error "Unsupported architecture" without these, which is the
1363        // first line of the first header of every program on the platform.
1364        let darwin = set_for("aarch64-apple-darwin");
1365        assert!(has(&darwin, "#define __arm64__ 1"));
1366        assert!(has(&darwin, "#define __arm64 1"));
1367        assert!(has(&darwin, "#define __aarch64__ 1"), "the portable spelling stays too");
1368        let linux = set_for("aarch64-unknown-linux-gnu");
1369        assert!(!has(&linux, "#define __arm64__ 1"), "Apple's spelling is Apple's alone");
1370        assert!(!has(&set_for("x86_64-apple-darwin"), "#define __arm64__ 1"));
1371    }
1372
1373    #[test]
1374    fn every_limit_is_spelled_in_hexadecimal_the_way_gcc_spells_it() {
1375        // The value was never in question and the spelling is, because these macros reach a
1376        // program's text. glibc's `limits.h` writes `#define INT_MAX __INT_MAX__`, openssl
1377        // writes `((unsigned int)INT_MAX + 1)`, and `-E` over that header printed a decimal
1378        // number where gcc printed a hexadecimal one. The type is the same either way here,
1379        // which is why the suffixes are unchanged: `0x7fffffff` and `2147483647` are both
1380        // `int`, and `0xffffffffffffffffUL` and its decimal twin are both `unsigned long`.
1381        let linux = set_for("x86_64-unknown-linux-gnu");
1382        for line in [
1383            "#define __SCHAR_MAX__ 0x7f",
1384            "#define __SHRT_MAX__ 0x7fff",
1385            "#define __INT_MAX__ 0x7fffffff",
1386            "#define __LONG_MAX__ 0x7fffffffffffffffL",
1387            "#define __LONG_LONG_MAX__ 0x7fffffffffffffffLL",
1388            "#define __INTMAX_MAX__ 0x7fffffffffffffffL",
1389            "#define __UINTMAX_MAX__ 0xffffffffffffffffUL",
1390            "#define __SIZE_MAX__ 0xffffffffffffffffUL",
1391            "#define __PTRDIFF_MAX__ 0x7fffffffffffffffL",
1392            "#define __SIG_ATOMIC_MAX__ 0x7fffffff",
1393            "#define __INT8_MAX__ 0x7f",
1394            "#define __UINT8_MAX__ 0xff",
1395            "#define __INT16_MAX__ 0x7fff",
1396            "#define __UINT16_MAX__ 0xffff",
1397            "#define __INT32_MAX__ 0x7fffffff",
1398            "#define __UINT32_MAX__ 0xffffffffU",
1399            "#define __INT64_MAX__ 0x7fffffffffffffffL",
1400            "#define __UINT64_MAX__ 0xffffffffffffffffUL",
1401            "#define __INT_FAST8_MAX__ 0x7f",
1402            "#define __UINT_FAST8_MAX__ 0xff",
1403        ] {
1404            assert!(has(&linux, line), "{line}");
1405        }
1406        // Windows, where `long` is thirty two bits, so the wide suffix moves and the narrow
1407        // `long` limit is not the same number.
1408        let windows = set_for("x86_64-pc-windows-msvc");
1409        assert!(has(&windows, "#define __LONG_MAX__ 0x7fffffffL"));
1410        assert!(has(&windows, "#define __INTMAX_MAX__ 0x7fffffffffffffffLL"));
1411        assert!(has(&windows, "#define __UINTMAX_MAX__ 0xffffffffffffffffULL"));
1412    }
1413
1414    #[test]
1415    fn wint_t_does_not_follow_wchar_t() {
1416        // Apple makes it signed so that WEOF is negative the way EOF is. Linux does not.
1417        let darwin = set_for("aarch64-apple-darwin");
1418        assert!(has(&darwin, "#define __WINT_TYPE__ int"));
1419        assert!(has(&darwin, "#define __WINT_MAX__ 0x7fffffff"));
1420        assert!(has(&darwin, "#define __WCHAR_TYPE__ int"));
1421        let linux = set_for("aarch64-unknown-linux-gnu");
1422        assert!(has(&linux, "#define __WINT_TYPE__ unsigned int"));
1423        assert!(has(&linux, "#define __WINT_MAX__ 0xffffffffU"));
1424        assert!(has(&linux, "#define __WCHAR_TYPE__ unsigned int"), "and wchar_t is its own");
1425        assert!(has(
1426            &set_for("x86_64-pc-windows-msvc"),
1427            "#define __WINT_TYPE__ short unsigned int"
1428        ));
1429    }
1430
1431    #[test]
1432    fn the_widths_say_what_the_type_holds_and_follow_the_target_that_changes_it() {
1433        // Twenty of them, which is gcc's set: no exact width member, since the width of an
1434        // `int32_t` is in its name, and no unsigned member, since a header that wants
1435        // `UINTMAX_WIDTH` writes `__INTMAX_WIDTH__`.
1436        let linux = set_for("x86_64-unknown-linux-gnu");
1437        assert_eq!(linux.lines().filter(|line| line.contains("_WIDTH__")).count(), 20);
1438        assert!(has(&linux, "#define __LONG_WIDTH__ 64"));
1439        assert!(has(&linux, "#define __SIZE_WIDTH__ 64"));
1440        assert!(has(&linux, "#define __WCHAR_WIDTH__ 32"));
1441        assert!(has(&linux, "#define __INT_LEAST16_WIDTH__ 16"));
1442        // x86-64 glibc is where `int_fast16_t` is a `long`, and the width has to say so or a
1443        // program that switches on it picks the wrong branch.
1444        assert!(has(&linux, "#define __INT_FAST16_WIDTH__ 64"));
1445        assert!(has(&set_for("x86_64-unknown-linux-musl"), "#define __INT_FAST16_WIDTH__ 32"));
1446        // Windows has a thirty two bit `long` and a sixteen bit `wint_t`, and the pointer
1447        // sized types stay sixty four bits wide whatever `long` does.
1448        let windows = set_for("x86_64-pc-windows-msvc");
1449        assert!(has(&windows, "#define __LONG_WIDTH__ 32"));
1450        assert!(has(&windows, "#define __WINT_WIDTH__ 16"));
1451        assert!(has(&windows, "#define __SIZE_WIDTH__ 64"));
1452        assert!(has(&windows, "#define __INTMAX_WIDTH__ 64"));
1453    }
1454
1455    #[test]
1456    fn a_constant_maker_gets_the_suffix_its_width_needs_and_no_other() {
1457        // Found by diffing `-dM` against the system compiler. The 32 bit row was passing `U`
1458        // as its width suffix, which put a `U` on the signed macro and two on the unsigned
1459        // one, and `UINT32_C(1)` expanded to `1UU`, which is not a token.
1460        let linux = set_for("x86_64-unknown-linux-gnu");
1461        assert!(has(&linux, "#define __INT32_C(c) c"));
1462        assert!(has(&linux, "#define __UINT32_C(c) c ## U"));
1463        assert!(has(&linux, "#define __INT16_C(c) c"));
1464        // No `U` on the two narrow ones, because `uint8_t` and `uint16_t` promote to a
1465        // signed `int` and the constant has that type. gcc leaves it off for the same reason.
1466        assert!(has(&linux, "#define __UINT16_C(c) c"));
1467        assert!(has(&linux, "#define __UINT8_C(c) c"));
1468        // The wide ones do take a suffix, and the `U` goes in front of it.
1469        assert!(has(&linux, "#define __INT64_C(c) c ## L"));
1470        assert!(has(&linux, "#define __UINT64_C(c) c ## UL"));
1471        // Windows has a thirty two bit `long`, so its sixty four bit constants are `long long`.
1472        let windows = set_for("x86_64-pc-windows-msvc");
1473        assert!(has(&windows, "#define __INT64_C(c) c ## LL"));
1474        assert!(has(&windows, "#define __UINT64_C(c) c ## ULL"));
1475    }
1476
1477    #[test]
1478    fn the_symbol_prefix_is_defined_everywhere_including_where_it_is_empty() {
1479        // Empty is not the same as absent, because glibc stringifies it. Leaving it undefined
1480        // turns `__asm__ (__ASMNAME ("__xpg_strerror_r"))` into an asm name of
1481        // "__USER_LABEL_PREFIX__" "__xpg_strerror_r", which renames the function instead of
1482        // failing, and that is a bug found at link time or later.
1483        for triple in
1484            ["x86_64-unknown-linux-gnu", "aarch64-unknown-linux-gnu", "x86_64-pc-windows-msvc"]
1485        {
1486            assert!(has(&set_for(triple), "#define __USER_LABEL_PREFIX__ "), "{triple}");
1487        }
1488        // Mach-O keeps the underscore that ELF dropped.
1489        assert!(has(&set_for("aarch64-apple-darwin"), "#define __USER_LABEL_PREFIX__ _"));
1490    }
1491
1492    /// The set gcc defines that headers read and that are true here. Written out one line at a
1493    /// time rather than counted, because the value is the whole point of each of them: a header
1494    /// asking `#if __FINITE_MATH_ONLY__` wants the number and not the existence.
1495    #[test]
1496    fn the_toolchain_macros_gcc_defines_are_defined_with_gccs_values() {
1497        let linux = set_for("x86_64-unknown-linux-gnu");
1498        for line in [
1499            "#define __GNUC_EXECUTION_CHARSET_NAME \"UTF-8\"",
1500            "#define __GNUC_WIDE_EXECUTION_CHARSET_NAME \"UTF-32LE\"",
1501            "#define __GXX_ABI_VERSION 1021",
1502            "#define __REGISTER_PREFIX__ ",
1503            "#define __FINITE_MATH_ONLY__ 0",
1504            "#define __GCC_IEC_559 2",
1505            "#define __GCC_IEC_559_COMPLEX 2",
1506            "#define __GCC_CONSTRUCTIVE_SIZE 64",
1507            "#define __GCC_DESTRUCTIVE_SIZE 64",
1508            "#define __GCC_HAVE_SYNC_COMPARE_AND_SWAP_1 1",
1509            "#define __GCC_HAVE_SYNC_COMPARE_AND_SWAP_2 1",
1510            "#define __GCC_HAVE_SYNC_COMPARE_AND_SWAP_4 1",
1511            "#define __GCC_HAVE_SYNC_COMPARE_AND_SWAP_8 1",
1512            "#define __ATOMIC_HLE_ACQUIRE 65536",
1513            "#define __ATOMIC_HLE_RELEASE 131072",
1514            "#define __FXSR__ 1",
1515            "#define __MMX_WITH_SSE__ 1",
1516            "#define __code_model_small__ 1",
1517        ] {
1518            assert!(has(&linux, line), "{line}");
1519        }
1520        // The five that are the processor's rather than the compiler's stay on the processor.
1521        let arm = set_for("aarch64-unknown-linux-gnu");
1522        for name in ["__ATOMIC_HLE_ACQUIRE", "__FXSR__", "__MMX_WITH_SSE__", "__code_model_small__"]
1523        {
1524            assert!(!arm.contains(name), "{name}");
1525        }
1526        assert!(has(&arm, "#define __GCC_HAVE_SYNC_COMPARE_AND_SWAP_8 1"));
1527        // A wide character is sixteen bits on Windows, so a wide string is UTF-16 there.
1528        let windows = set_for("x86_64-pc-windows-msvc");
1529        assert!(has(&windows, "#define __GNUC_WIDE_EXECUTION_CHARSET_NAME \"UTF-16LE\""));
1530    }
1531
1532    #[test]
1533    fn the_memory_orders_are_there_even_without_atomics() {
1534        // musl's stdatomic.h writes `memory_order_relaxed = __ATOMIC_RELAXED` with no test
1535        // around it, so these are not a promise about `_Atomic`, they are the numbering the
1536        // builtins take, and a compiler without them prints an enumerator whose value is an
1537        // identifier.
1538        let linux = set_for("x86_64-unknown-linux-gnu");
1539        assert!(has(&linux, "#define __ATOMIC_RELAXED 0"));
1540        assert!(has(&linux, "#define __ATOMIC_SEQ_CST 5"));
1541        assert!(has(&linux, "#define __STDC_NO_ATOMICS__ 1"), "and we still have no _Atomic");
1542        assert!(has(&linux, "#define __GCC_ATOMIC_INT_LOCK_FREE 2"));
1543        assert!(has(&linux, "#define __GCC_ATOMIC_LLONG_LOCK_FREE 2"));
1544        assert!(has(&set_for("x86_64-pc-windows-msvc"), "#define __GCC_ATOMIC_LLONG_LOCK_FREE 2"));
1545    }
1546
1547    #[test]
1548    fn long_double_is_three_types_and_the_macros_say_which() {
1549        assert!(has(&set_for("x86_64-unknown-linux-gnu"), "#define __LDBL_MANT_DIG__ 64"));
1550        assert!(has(&set_for("aarch64-unknown-linux-gnu"), "#define __LDBL_MANT_DIG__ 113"));
1551        assert!(has(&set_for("aarch64-apple-darwin"), "#define __LDBL_MANT_DIG__ 53"));
1552    }
1553
1554    #[test]
1555    fn the_extended_floating_types_have_the_limits_their_formats_have() {
1556        // Every one of these but `_Float64x` is the same format on every target, which is the
1557        // point of the interchange types, so the limits are the same everywhere too.
1558        let linux = set_for("x86_64-unknown-linux-gnu");
1559        assert!(has(&linux, "#define __FLT16_MANT_DIG__ 11"));
1560        assert!(has(&linux, "#define __FLT32_MANT_DIG__ 24"));
1561        assert!(has(&linux, "#define __FLT64_MANT_DIG__ 53"));
1562        assert!(has(&linux, "#define __FLT128_MANT_DIG__ 113"));
1563        assert!(has(&linux, "#define __FLT32X_MANT_DIG__ 53"));
1564        // Each family writes its values with its own suffix, so a header that assigns one to an
1565        // object of the type gets the type back rather than a conversion.
1566        assert!(has(&linux, "#define __FLT16_MAX__ 6.55040000000000000000000000000000000e+4F16"));
1567        assert!(has(
1568            &linux,
1569            "#define __FLT32X_MIN__ 2.22507385850720138309023271733240406e-308F32x"
1570        ));
1571        // `_Float128x` is a type no target has, so gcc defines nothing for it and neither
1572        // does this.
1573        assert!(!linux.contains("__FLT128X_"));
1574    }
1575
1576    #[test]
1577    fn the_family_for_a_named_type_is_written_where_the_type_is_and_nowhere_else() {
1578        // gcc 13's rows, measured with the cross compilers: the half is on x86-64, AArch64 and
1579        // RISC-V, and the quad is on every one of the seven but armv7. A program asks the macro
1580        // to find out whether it may write the type, so a row where the two disagree is a header
1581        // that asks for a type the compiler then refuses.
1582        let has_family = |target: &str, prefix: &str| {
1583            set_for_tuple(target).contains(&format!("#define __{prefix}_MANT_DIG__ "))
1584        };
1585        assert!(has_family("x86_64-linux-gnu", "FLT16"));
1586        assert!(has_family("aarch64-linux-gnu", "FLT16"));
1587        assert!(has_family("riscv64-linux-gnu", "FLT16"));
1588        assert!(!has_family("i686-linux-gnu", "FLT16"));
1589        assert!(!has_family("s390x-linux-gnu", "FLT16"));
1590        assert!(!has_family("armv7-linux-gnueabihf", "FLT16"));
1591
1592        assert!(has_family("i686-linux-gnu", "FLT128"));
1593        assert!(has_family("s390x-linux-gnu", "FLT128"));
1594        assert!(!has_family("armv7-linux-gnueabihf", "FLT128"));
1595
1596        // The families every machine has are still there on the machine that has least, and so
1597        // is `_Float64x` on the machines that have a format for it.
1598        let arm = set_for_tuple("armv7-linux-gnueabihf");
1599        for prefix in ["FLT", "DBL", "LDBL", "FLT32", "FLT64", "FLT32X"] {
1600            assert!(arm.contains(&format!("#define __{prefix}_MANT_DIG__ ")), "__{prefix}_");
1601        }
1602        assert!(!arm.contains("__FLT64X_"));
1603    }
1604
1605    #[test]
1606    fn float64x_keeps_the_width_that_long_double_loses_on_apple() {
1607        // The two are the same eighty bit x87 format on x86-64 and part company everywhere
1608        // else, because `_Float64x` follows the processor and `long double` follows the ABI.
1609        let linux = set_for("x86_64-unknown-linux-gnu");
1610        assert!(has(&linux, "#define __FLT64X_MANT_DIG__ 64"));
1611        assert!(has(&linux, "#define __LDBL_MANT_DIG__ 64"));
1612        let mac = set_for("aarch64-apple-darwin");
1613        assert!(has(&mac, "#define __FLT64X_MANT_DIG__ 113"));
1614        assert!(has(&mac, "#define __LDBL_MANT_DIG__ 53"));
1615        let windows = set_for("x86_64-pc-windows-msvc");
1616        assert!(has(&windows, "#define __FLT64X_MANT_DIG__ 64"));
1617        assert!(has(&windows, "#define __LDBL_MANT_DIG__ 53"));
1618    }
1619
1620    #[test]
1621    fn the_largest_value_of_an_ieee_format_is_also_its_largest_normal_one() {
1622        // `NORM_MAX` is only ever smaller than `MAX` for a format that holds values above its
1623        // largest normal one, and no IEEE encoding does. The double-double does, which is why
1624        // the two are separate fields now, and no target here has one.
1625        let linux = set_for("x86_64-unknown-linux-gnu");
1626        for prefix in ["FLT", "DBL", "LDBL", "FLT16", "FLT32", "FLT64", "FLT128", "FLT32X"] {
1627            let value = |suffix: &str| {
1628                let name = format!("#define __{prefix}_{suffix}__ ");
1629                let line = linux
1630                    .lines()
1631                    .find(|line| line.starts_with(&name))
1632                    .unwrap_or_else(|| panic!("__{prefix}_{suffix}__ is defined"));
1633                line[name.len()..].to_owned()
1634            };
1635            assert_eq!(value("MAX"), value("NORM_MAX"), "__{prefix}_NORM_MAX__");
1636        }
1637    }
1638
1639    #[test]
1640    fn the_double_double_is_the_row_where_the_largest_value_is_not_the_largest_normal_one() {
1641        // No target here has a double-double `long double`, so this asks the row rather than the
1642        // macros. It is the reason `norm_max` is a field: a program that wants the largest value
1643        // it can still compute a full significand with wants `NORM_MAX`, and on PowerPC that is
1644        // a bit under half of `MAX`.
1645        let c = characteristics(Format::DoubleDouble);
1646        assert_ne!(c.max, c.norm_max);
1647        // `NORM_MAX` is two to the one thousand and twenty three, which is about half of `MAX`,
1648        // and `MAX` is a shade above `DBL_MAX` because the high half can be `DBL_MAX` and the low
1649        // half then adds to it. Both are what the reference prints.
1650        assert!(c.norm_max.starts_with("8.98846567431157953864652595394501e+307"));
1651        assert!(c.max.starts_with("1.7976931348623158"));
1652        // Epsilon is the odd one. The smallest value that changes a double-double near one is a
1653        // subnormal in the low half rather than one unit in the last place of anything, so it is
1654        // the same number as this format's own `DENORM_MIN`, which no other row can say.
1655        assert_eq!(c.epsilon, c.denorm_min);
1656        for format in [Format::Half, Format::Single, Format::Double, Format::X87Extended] {
1657            assert_ne!(characteristics(format).epsilon, characteristics(format).denorm_min);
1658        }
1659        // And it is not an IEC 60559 format, which only the brain float can also say.
1660        assert_eq!(c.is_iec_60559, "0");
1661    }
1662
1663    #[test]
1664    fn the_widest_bit_int_is_said_in_every_dialect() {
1665        // gcc defines it under `-std=c17` as well as `-std=c23`, and a header that reaches for
1666        // `_BitInt` tests the macro rather than the version, so an absent one reads as a
1667        // compiler without the type at all.
1668        let mut opts = Predef::new();
1669        let target = TargetInfo::new("x86_64-unknown-linux-gnu".parse().unwrap());
1670        assert!(has(&built_in(&target, &opts), "#define __BITINT_MAXWIDTH__ 128"));
1671        opts.std = Std::C17;
1672        assert!(has(&built_in(&target, &opts), "#define __BITINT_MAXWIDTH__ 128"));
1673    }
1674
1675    #[test]
1676    fn char_signedness_is_recorded_only_when_it_is_unsigned() {
1677        // Which is how GCC does it: the macro exists to mark the unusual case.
1678        assert!(has(&set_for("aarch64-unknown-linux-gnu"), "#define __CHAR_UNSIGNED__ 1"));
1679        assert!(!has(&set_for("x86_64-unknown-linux-gnu"), "#define __CHAR_UNSIGNED__ 1"));
1680    }
1681
1682    #[test]
1683    fn the_dialect_decides_the_standard_macros() {
1684        let mut opts = Predef::new();
1685        let target = TargetInfo::new("x86_64-unknown-linux-gnu".parse().unwrap());
1686        assert!(has(&built_in(&target, &opts), "#define __STDC_VERSION__ 202311L"));
1687        assert!(!has(&built_in(&target, &opts), "#define __STRICT_ANSI__ 1"));
1688        assert!(has(&built_in(&target, &opts), "#define linux 1"));
1689
1690        opts.gnu_extensions = false;
1691        assert!(has(&built_in(&target, &opts), "#define __STRICT_ANSI__ 1"));
1692        assert!(!has(&built_in(&target, &opts), "#define linux 1"), "not a reserved name");
1693
1694        opts.std = Std::C89;
1695        let c89 = built_in(&target, &opts);
1696        assert!(!c89.contains("__STDC_VERSION__"), "C89 does not define it at all");
1697        assert!(has(&c89, "#define __STDC__ 1"));
1698    }
1699
1700    /// The conditional feature macros are claims not to have something, and a claim that is
1701    /// not true changes what a header declares rather than turning anything off.
1702    #[test]
1703    fn the_only_things_claimed_missing_are_the_ones_that_are_missing() {
1704        let target = TargetInfo::new("x86_64-unknown-linux-gnu".parse().unwrap());
1705        let opts = Predef::new();
1706        let set = built_in(&target, &opts);
1707        assert!(has(&set, "#define __STDC_NO_ATOMICS__ 1"), "there is no stdatomic.h to include");
1708        assert!(has(&set, "#define __STDC_NO_THREADS__ 1"), "nor a threads.h");
1709        assert!(has(&set, "#define __STDC_NO_COMPLEX__ 1"), "the arithmetic is not lowered");
1710        assert!(!set.contains("__STDC_NO_VLA__"), "variable length arrays work");
1711    }
1712
1713    /// gcc's own `stdatomic.h` declares `atomic_char8_t` under `#ifdef __CHAR8_TYPE__`, so a
1714    /// compiler that defines it in C17 declares a type gcc does not and one that never defines
1715    /// it is missing one in C23. Both were caught by preprocessing that header both ways.
1716    #[test]
1717    fn the_type_behind_char8_t_is_defined_in_c23_and_in_no_dialect_before_it() {
1718        let target = TargetInfo::new("x86_64-unknown-linux-gnu".parse().unwrap());
1719        let mut opts = Predef::new();
1720        assert!(has(&built_in(&target, &opts), "#define __CHAR8_TYPE__ unsigned char"));
1721
1722        for older in [Std::C17, Std::C11, Std::C99, Std::C89] {
1723            opts.std = older;
1724            assert!(!built_in(&target, &opts).contains("__CHAR8_TYPE__"), "{older:?}");
1725        }
1726    }
1727
1728    /// glibc's `<stdc-predef.h>` is read before the first line of every translation unit and
1729    /// writes `#define __STDC_IEC_60559_BFP__ 201404L` whenever `__GCC_IEC_559` is positive.
1730    /// Any other value here is a redefinition with a different body, which is a warning the
1731    /// program did not ask for and which a configure script reads as a failed feature test.
1732    #[test]
1733    fn the_ieee_annex_macro_carries_the_value_glibcs_own_header_writes() {
1734        let target = TargetInfo::new("x86_64-unknown-linux-gnu".parse().unwrap());
1735        let mut opts = Predef::new();
1736        for std in [Std::C23, Std::C17, Std::C11, Std::C99, Std::C89] {
1737            opts.std = std;
1738            let set = built_in(&target, &opts);
1739            assert!(has(&set, "#define __STDC_IEC_60559_BFP__ 201404L"), "{std:?}");
1740            assert!(has(&set, "#define __STDC_IEC_60559_COMPLEX__ 201404L"), "{std:?}");
1741            // The two the library reads to decide whether to write the four above itself.
1742            assert!(has(&set, "#define __GCC_IEC_559 2"), "{std:?}");
1743            assert!(has(&set, "#define __GCC_IEC_559_COMPLEX 2"), "{std:?}");
1744        }
1745    }
1746
1747    #[test]
1748    fn the_optimizer_level_is_visible_to_the_preprocessor() {
1749        let target = TargetInfo::new("x86_64-unknown-linux-gnu".parse().unwrap());
1750        let mut opts = Predef::new();
1751        assert!(has(&built_in(&target, &opts), "#define __NO_INLINE__ 1"));
1752        assert!(!built_in(&target, &opts).contains("__OPTIMIZE__"));
1753
1754        opts.opt_level = OptLevel::O2;
1755        assert!(has(&built_in(&target, &opts), "#define __OPTIMIZE__ 1"));
1756        assert!(!built_in(&target, &opts).contains("__OPTIMIZE_SIZE__"));
1757
1758        opts.opt_level = OptLevel::Os;
1759        assert!(has(&built_in(&target, &opts), "#define __OPTIMIZE_SIZE__ 1"));
1760    }
1761
1762    #[test]
1763    fn a_command_line_define_with_no_value_is_one() {
1764        let mut opts = Predef::new();
1765        opts.defines = vec!["FOO".to_owned(), "BAR=2".to_owned(), "F(x)=x + 1".to_owned()];
1766        opts.undefines = vec!["__linux__".to_owned()];
1767        let text = command_line(&opts);
1768        assert!(has(&text, "#define FOO 1"));
1769        assert!(has(&text, "#define BAR 2"));
1770        assert!(has(&text, "#define F(x) x + 1"));
1771        // The undefine comes last, because `-U` beats `-D` whichever side of it it was on.
1772        assert!(text.trim_end().ends_with("#undef __linux__"));
1773    }
1774
1775    #[test]
1776    fn no_command_line_macros_is_no_file_at_all() {
1777        assert!(command_line(&Predef::new()).is_empty());
1778    }
1779
1780    #[test]
1781    fn a_date_is_spelled_the_way_the_standard_fixes() {
1782        // The epoch itself, and a day that needs the space padding the format asks for.
1783        let epoch = Timestamp::from_unix(0);
1784        assert_eq!(epoch.date, "Jan  1 1970");
1785        assert_eq!(epoch.time, "00:00:00");
1786        let leap = Timestamp::from_unix(1_709_164_800);
1787        assert_eq!(leap.date, "Feb 29 2024", "2024 is a leap year");
1788        let late = Timestamp::from_unix(1_735_689_599);
1789        assert_eq!(late.date, "Dec 31 2024");
1790        assert_eq!(late.time, "23:59:59");
1791    }
1792
1793    #[test]
1794    fn a_date_before_the_epoch_still_comes_out_right() {
1795        // Not because anyone compiles in 1969, but because the arithmetic that gets this
1796        // wrong is the same arithmetic that gets a time zone offset wrong.
1797        assert_eq!(Timestamp::from_unix(-1).date, "Dec 31 1969");
1798        assert_eq!(Timestamp::from_unix(-1).time, "23:59:59");
1799    }
1800
1801    #[test]
1802    fn the_gnuc_version_is_a_knob_rather_than_a_constant() {
1803        let target = TargetInfo::new("x86_64-unknown-linux-gnu".parse().unwrap());
1804        let mut opts = Predef::new();
1805        assert!(has(&built_in(&target, &opts), "#define __GNUC__ 7"));
1806        opts.gnuc = GnucVersion { major: 15, minor: 1, patch: 0 };
1807        assert!(has(&built_in(&target, &opts), "#define __GNUC__ 15"));
1808        assert!(has(&built_in(&target, &opts), "#define __GNUC_MINOR__ 1"));
1809    }
1810
1811    /// Which of the two inline macros is defined, over the two things that decide it.
1812    ///
1813    /// Exactly one of them is defined at a time, which is what a header reads: glibc's
1814    /// `__extern_inline` writes `extern __inline` under one and adds `__gnu_inline__` under the
1815    /// other, so both being defined or neither being defined is a header taking a path it was
1816    /// never meant to take.
1817    #[test]
1818    fn one_of_the_two_inline_macros_is_defined_and_three_things_can_pick_which() {
1819        let target = TargetInfo::new("x86_64-unknown-linux-gnu".parse().unwrap());
1820        let gnu = "#define __GNUC_GNU_INLINE__ 1";
1821        let stdc = "#define __GNUC_STDC_INLINE__ 1";
1822
1823        let mut opts = Predef::new();
1824        assert!(has(&built_in(&target, &opts), stdc));
1825        assert!(!has(&built_in(&target, &opts), gnu));
1826
1827        opts.gnu89_inline = true;
1828        assert!(has(&built_in(&target, &opts), gnu));
1829        assert!(!has(&built_in(&target, &opts), stdc));
1830
1831        // The dialect on its own, which is where the older reading came from.
1832        let mut opts = Predef::new();
1833        opts.std = Std::C89;
1834        assert!(has(&built_in(&target, &opts), gnu));
1835        assert!(!has(&built_in(&target, &opts), stdc));
1836    }
1837
1838    #[test]
1839    fn musl_and_glibc_disagree_about_the_fast_types_on_the_same_processor() {
1840        // The same x86-64 machine, two libcs, two answers. GCC built for glibc says `long int`
1841        // and GCC built for musl says `int`, because musl defines `int_fast16_t` as `int32_t`
1842        // everywhere. It shows in `stdatomic.h`, which GCC writes out of these macros, so
1843        // getting it wrong makes every atomic fast type the wrong width.
1844        let gnu = set_for("x86_64-unknown-linux-gnu");
1845        let musl = set_for("x86_64-unknown-linux-musl");
1846        assert!(has(&gnu, "#define __INT_FAST16_TYPE__ long int"));
1847        assert!(has(&gnu, "#define __INT_FAST32_TYPE__ long int"));
1848        assert!(has(&gnu, "#define __UINT_FAST16_TYPE__ long unsigned int"));
1849        assert!(has(&musl, "#define __INT_FAST16_TYPE__ int"));
1850        assert!(has(&musl, "#define __INT_FAST32_TYPE__ int"));
1851        assert!(has(&musl, "#define __UINT_FAST16_TYPE__ unsigned int"));
1852        // The limits have to move with the types or a header that checks them stops agreeing
1853        // with the header that uses them.
1854        assert!(has(&gnu, "#define __INT_FAST16_MAX__ 0x7fffffffffffffffL"));
1855        assert!(has(&musl, "#define __INT_FAST16_MAX__ 0x7fffffff"));
1856        assert!(has(&musl, "#define __UINT_FAST16_MAX__ 0xffffffffU"));
1857    }
1858
1859    #[test]
1860    fn the_libc_only_moves_the_two_fast_types_it_is_allowed_to_move() {
1861        // 8 and 64 are the same on both, and so is everything outside the fast family. A libc
1862        // is not a processor and this is the whole of what it is permitted to change here.
1863        let gnu = set_for("x86_64-unknown-linux-gnu");
1864        let musl = set_for("x86_64-unknown-linux-musl");
1865        for line in [
1866            "#define __INT_FAST8_TYPE__ signed char",
1867            "#define __INT_FAST64_TYPE__ long int",
1868            "#define __INT64_TYPE__ long int",
1869            "#define __SIZE_TYPE__ long unsigned int",
1870            "#define __SIZEOF_LONG__ 8",
1871            "#define __LP64__ 1",
1872        ] {
1873            assert!(has(&gnu, line), "glibc lost {line}");
1874            assert!(has(&musl, line), "musl lost {line}");
1875        }
1876    }
1877
1878    #[test]
1879    fn a_non_x86_target_has_int_sized_fast_types_whatever_the_libc() {
1880        // The `long` answer was always specific to x86-64. aarch64 glibc says `int` too, so
1881        // adding the libc axis must not have turned into a second way to say x86-64.
1882        let arm_gnu = set_for("aarch64-unknown-linux-gnu");
1883        let arm_musl = set_for("aarch64-unknown-linux-musl");
1884        assert!(has(&arm_gnu, "#define __INT_FAST16_TYPE__ int"));
1885        assert!(has(&arm_musl, "#define __INT_FAST16_TYPE__ int"));
1886    }
1887
1888    #[test]
1889    fn windows_is_the_one_target_where_the_two_middle_fast_types_differ_from_each_other() {
1890        // mingw's `stdint.h` declares `int_fast16_t` a `short` and `int_fast32_t` an `int`, and
1891        // x86_64-w64-mingw32-gcc says the same, so this is the one platform where the pair does
1892        // not share an answer.
1893        let windows = set_for("x86_64-pc-windows-gnu");
1894        assert!(has(&windows, "#define __INT_FAST16_TYPE__ short int"));
1895        assert!(has(&windows, "#define __UINT_FAST16_TYPE__ short unsigned int"));
1896        assert!(has(&windows, "#define __INT_FAST16_MAX__ 0x7fff"));
1897        assert!(has(&windows, "#define __UINT_FAST16_MAX__ 0xffff"));
1898        assert!(has(&windows, "#define __INT_FAST16_WIDTH__ 16"));
1899        assert!(has(&windows, "#define __INT_FAST32_TYPE__ int"));
1900        assert!(has(&windows, "#define __UINT_FAST32_TYPE__ unsigned int"));
1901        assert!(has(&windows, "#define __INT_FAST32_WIDTH__ 32"));
1902        // The two ends of the family are the same as everywhere.
1903        assert!(has(&windows, "#define __INT_FAST8_TYPE__ signed char"));
1904        assert!(has(&windows, "#define __INT_FAST64_TYPE__ long long int"));
1905    }
1906
1907    #[test]
1908    fn windows_answers_to_every_name_gcc_gives_it() {
1909        // The mingw tree reads more than one spelling of the platform and a missing one is a
1910        // declaration that quietly is not there: `winuser.h` guards `EndTask` with `#ifdef
1911        // WINNT` and `rpcdcep.h` guards six `I_Rpc` declarations with `#ifndef WINNT`.
1912        let windows = set_for("x86_64-pc-windows-gnu");
1913        let every = "_WIN32 __WIN32 __WIN32__ __WINNT __WINNT__ __MINGW32__ \
1914                     _WIN64 __WIN64 __WIN64__ __MINGW64__ __MSVCRT__ __SEH__ WIN32 WIN64 WINNT";
1915        for name in every.split_whitespace() {
1916            assert!(has(&windows, &format!("#define {name} 1")), "no {name}");
1917        }
1918        assert!(has(&windows, "#define _INTEGRAL_MAX_BITS 64"));
1919    }
1920
1921    #[test]
1922    fn a_thirty_two_bit_windows_is_not_told_its_pointer_is_sixty_four_bits_wide() {
1923        // `_WIN64` is about the pointer rather than the processor, and i686-w64-mingw32-gcc
1924        // defines neither it nor `__MINGW64__`, nor `__SEH__`, since the unwind records this
1925        // compiler writes are the sixty four bit format and a thirty two bit Windows unwinds
1926        // some other way. The target is made by hand because the three field triple has no
1927        // 32-bit row yet, so `i686-windows-gnu` predefines nothing at all and there is no other
1928        // way to reach this arm.
1929        let mut target = TargetInfo::new("x86_64-pc-windows-gnu".parse().expect("a triple"));
1930        target.pointer_width = 32;
1931        let windows = built_in(&target, &Predef::new());
1932        assert!(has(&windows, "#define _WIN32 1"));
1933        assert!(has(&windows, "#define __MINGW32__ 1"));
1934        for name in ["_WIN64", "__WIN64", "__WIN64__", "__MINGW64__", "__SEH__", "WIN64"] {
1935            assert!(!has(&windows, &format!("#define {name} 1")), "{name} on a 32 bit target");
1936        }
1937    }
1938
1939    #[test]
1940    fn the_three_unreserved_windows_names_need_the_gnu_dialect() {
1941        // `WIN32`, `WIN64` and `WINNT` are in the user's namespace, so gcc drops all three under
1942        // `-std=c11` and keeps the underscored ones. Windows code tests them anyway, the same
1943        // way portable Unix code still tests `linux`.
1944        let triple: Triple = "x86_64-pc-windows-gnu".parse().expect("a triple");
1945        let mut opts = Predef::new();
1946        opts.gnu_extensions = false;
1947        let strict = built_in(&TargetInfo::new(triple), &opts);
1948        for name in ["WIN32", "WIN64", "WINNT"] {
1949            assert!(!has(&strict, &format!("#define {name} 1")), "{name} under -std=c11");
1950        }
1951        assert!(has(&strict, "#define _WIN32 1"));
1952        assert!(has(&strict, "#define __WINNT__ 1"));
1953    }
1954}