Compile Variables

Compile variables are accessible by importing the "builtin" package, which the compiler makes available to every Zig source file. It contains compile-time constants such as the current target, endianness, and release mode.

compile_variables.zig

  1. const builtin = @import("builtin");
  2. const separator = if (builtin.os.tag == .windows) '\\' else '/';

Example of what is imported with @import("builtin"):

@import(“builtin”)

  1. const std = @import("std");
  2. /// Zig version. When writing code that supports multiple versions of Zig, prefer
  3. /// feature detection (i.e. with `@hasDecl` or `@hasField`) over version checks.
  4. pub const zig_version = std.SemanticVersion.parse(zig_version_string) catch unreachable;
  5. pub const zig_version_string = "0.12.0";
  6. pub const zig_backend = std.builtin.CompilerBackend.stage2_llvm;
  8. pub const output_mode = std.builtin.OutputMode.Obj;
  9. pub const link_mode = std.builtin.LinkMode.static;
  10. pub const is_test = false;
  11. pub const single_threaded = false;
  12. pub const abi = std.Target.Abi.gnu;
  13. pub const cpu: std.Target.Cpu = .{
  14.     .arch = .x86_64,
  15.     .model = &std.Target.x86.cpu.znver2,
  16.     .features = std.Target.x86.featureSet(&[_]std.Target.x86.Feature{
  17.         .@"64bit",
  18.         .adx,
  19.         .aes,
  20.         .allow_light_256_bit,
  21.         .avx,
  22.         .avx2,
  23.         .bmi,
  24.         .bmi2,
  25.         .branchfusion,
  26.         .clflushopt,
  27.         .clwb,
  28.         .clzero,
  29.         .cmov,
  30.         .crc32,
  31.         .cx16,
  32.         .cx8,
  33.         .f16c,
  34.         .fast_15bytenop,
  35.         .fast_bextr,
  36.         .fast_lzcnt,
  37.         .fast_movbe,
  38.         .fast_scalar_fsqrt,
  39.         .fast_scalar_shift_masks,
  40.         .fast_variable_perlane_shuffle,
  41.         .fast_vector_fsqrt,
  42.         .fma,
  43.         .fsgsbase,
  44.         .fxsr,
  45.         .lzcnt,
  46.         .mmx,
  47.         .movbe,
  48.         .mwaitx,
  49.         .nopl,
  50.         .pclmul,
  51.         .popcnt,
  52.         .prfchw,
  53.         .rdpid,
  54.         .rdpru,
  55.         .rdrnd,
  56.         .rdseed,
  57.         .sahf,
  58.         .sbb_dep_breaking,
  59.         .sha,
  60.         .slow_shld,
  61.         .sse,
  62.         .sse2,
  63.         .sse3,
  64.         .sse4_1,
  65.         .sse4_2,
  66.         .sse4a,
  67.         .ssse3,
  68.         .vzeroupper,
  69.         .wbnoinvd,
  70.         .x87,
  71.         .xsave,
  72.         .xsavec,
  73.         .xsaveopt,
  74.         .xsaves,
  75.     }),
  76. };
  77. pub const os = std.Target.Os{
  78.     .tag = .linux,
  79.     .version_range = .{ .linux = .{
  80.         .range = .{
  81.             .min = .{
  82.                 .major = 5,
  83.                 .minor = 10,
  84.                 .patch = 0,
  85.             },
  86.             .max = .{
  87.                 .major = 5,
  88.                 .minor = 10,
  89.                 .patch = 0,
  90.             },
  91.         },
  92.         .glibc = .{
  93.             .major = 2,
  94.             .minor = 31,
  95.             .patch = 0,
  96.         },
  97.     }},
  98. };
  99. pub const target: std.Target = .{
  100.     .cpu = cpu,
  101.     .os = os,
  102.     .abi = abi,
  103.     .ofmt = object_format,
  104.     .dynamic_linker = std.Target.DynamicLinker.init("/lib64/ld-linux-x86-64.so.2"),
  105. };
  106. pub const object_format = std.Target.ObjectFormat.elf;
  107. pub const mode = std.builtin.OptimizeMode.Debug;
  108. pub const link_libc = false;
  109. pub const link_libcpp = false;
  110. pub const have_error_return_tracing = true;
  111. pub const valgrind_support = true;
  112. pub const sanitize_thread = false;
  113. pub const position_independent_code = false;
  114. pub const position_independent_executable = false;
  115. pub const strip_debug_info = false;
  116. pub const code_model = std.builtin.CodeModel.default;
  117. pub const omit_frame_pointer = false;

See also: