//! drand48 functions are based off a 48-bit lcg prng: https://pubs.opengroup.org/onlinepubs/9799919799/functions/drand48.html const std = @import("std"); const common = @import("../common.zig"); const builtin = @import("builtin"); const Lcg = std.Random.lcg.Wrapping(u48); comptime { if (builtin.target.isMuslLibC() or builtin.target.isWasiLibC()) { @export(&erand48, .{ .name = "erand48", .linkage = common.linkage, .visibility = common.visibility }); @export(&jrand48, .{ .name = "jrand48", .linkage = common.linkage, .visibility = common.visibility }); @export(&nrand48, .{ .name = "nrand48", .linkage = common.linkage, .visibility = common.visibility }); @export(&drand48, .{ .name = "drand48", .linkage = common.linkage, .visibility = common.visibility }); @export(&lrand48, .{ .name = "lrand48", .linkage = common.linkage, .visibility = common.visibility }); @export(&mrand48, .{ .name = "mrand48", .linkage = common.linkage, .visibility = common.visibility }); @export(&lcong48, .{ .name = "lcong48", .linkage = common.linkage, .visibility = common.visibility }); @export(&seed48, .{ .name = "seed48", .linkage = common.linkage, .visibility = common.visibility }); @export(&srand48, .{ .name = "srand48", .linkage = common.linkage, .visibility = common.visibility }); } } // NOTE: all "magic" numbers and tests are extracted and adapted from the source above const default_multiplier = 0x5DEECE66D; const default_addend = 0xB; var lcg: Lcg = .init(0, default_multiplier, default_addend); var seed48_xi: [3]c_ushort = undefined; fn erand48(xsubi: *[3]c_ushort) callconv(.c) f64 { const xi = @as(u48, @as(u16, @truncate(xsubi[0])) | (@as(u48, @as(u16, @truncate(xsubi[1])))) << 16) | (@as(u48, @as(u16, @truncate(xsubi[2]))) << 32); var separate_lcg: Lcg = .init(xi, lcg.a, lcg.c); const next_xi = separate_lcg.next(); xsubi.* = .{ @truncate(next_xi & 0xFFFF), @truncate((next_xi >> 16) & 0xFFFF), @truncate((next_xi >> 32) & 0xFFFF) }; return @as(f64, @bitCast(0x3ff0000000000000 | (@as(u64, next_xi) << 4))) - 1.0; } fn jrand48(xsubi: *[3]c_ushort) callconv(.c) c_long { const xi = @as(u48, @as(u16, @truncate(xsubi[0])) | (@as(u48, @as(u16, @truncate(xsubi[1])))) << 16) | (@as(u48, @as(u16, @truncate(xsubi[2]))) << 32); var separate_lcg: Lcg = .init(xi, lcg.a, lcg.c); const next_xi = separate_lcg.next(); xsubi.* = .{ @truncate(next_xi & 0xFFFF), @truncate((next_xi >> 16) & 0xFFFF), @truncate((next_xi >> 32) & 0xFFFF) }; return @as(i32, @bitCast(@as(u32, @truncate(next_xi >> 16)))); } fn nrand48(xsubi: *[3]c_ushort) callconv(.c) c_long { const xi = @as(u48, @as(u16, @truncate(xsubi[0])) | (@as(u48, @as(u16, @truncate(xsubi[1])))) << 16) | (@as(u48, @as(u16, @truncate(xsubi[2]))) << 32); var separate_lcg: Lcg = .init(xi, lcg.a, lcg.c); const next_xi = separate_lcg.next(); xsubi.* = .{ @truncate(next_xi & 0xFFFF), @truncate((next_xi >> 16) & 0xFFFF), @truncate((next_xi >> 32) & 0xFFFF) }; return @intCast(next_xi >> 17); // a c_long is always at least 32-bits, this is never UB } fn drand48() callconv(.c) f64 { return @as(f64, @bitCast(0x3ff0000000000000 | (@as(u64, lcg.next()) << 4))) - 1.0; } fn lrand48() callconv(.c) c_long { return @intCast(lcg.next() >> 17); } fn mrand48() callconv(.c) c_long { return @as(i32, @bitCast(@as(u32, @truncate(lcg.next() >> 16)))); } // 0..3 is `Xi`, 3..6 is `a`, 6 is `c` // first low 16-bits, then mid, then high. fn lcong48(param: *[7]c_ushort) callconv(.c) void { lcg.xi = (@as(u48, @as(u16, @truncate(param[0]))) | (@as(u48, @as(u16, @truncate(param[1])))) << 16) | (@as(u48, @as(u16, @truncate(param[2]))) << 32); lcg.a = (@as(u48, @as(u16, @truncate(param[3]))) | (@as(u48, @as(u16, @truncate(param[4])))) << 16) | (@as(u48, @as(u16, @truncate(param[5]))) << 32); lcg.c = @as(u16, @truncate(param[6])); } fn seed48(seed16v: *[3]c_ushort) callconv(.c) *[3]c_ushort { seed48_xi = .{ @truncate(lcg.xi & 0xFFFF), @truncate((lcg.xi >> 16) & 0xFFFF), @truncate((lcg.xi >> 32) & 0xFFFF) }; const xi = (@as(u48, @as(u16, @truncate(seed16v[0]))) | (@as(u48, @as(u16, @truncate(seed16v[1])))) << 16) | (@as(u48, @as(u16, @truncate(seed16v[2]))) << 32); lcg = .init(xi, default_multiplier, default_addend); return &seed48_xi; } fn srand48(seedval: c_long) callconv(.c) void { const xi = (@as(u32, @truncate(@as(c_ulong, @bitCast(seedval)))) << 16) | 0x330E; lcg = .init(xi, default_multiplier, default_addend); } test erand48 { var xsubi: [3]c_ushort = .{ 37174, 64810, 11603 }; try std.testing.expectApproxEqAbs(0.8965, erand48(&xsubi), 0.0005); try std.testing.expectEqualSlices(c_ushort, &.{ 22537, 47966, 58735 }, &xsubi); try std.testing.expectApproxEqAbs(0.3375, erand48(&xsubi), 0.0005); try std.testing.expectEqualSlices(c_ushort, &.{ 37344, 32911, 22119 }, &xsubi); try std.testing.expectApproxEqAbs(0.6475, erand48(&xsubi), 0.0005); try std.testing.expectEqualSlices(c_ushort, &.{ 23659, 29872, 42445 }, &xsubi); try std.testing.expectApproxEqAbs(0.5005, erand48(&xsubi), 0.0005); try std.testing.expectEqualSlices(c_ushort, &.{ 31642, 7875, 32802 }, &xsubi); try std.testing.expectApproxEqAbs(0.5065, erand48(&xsubi), 0.0005); try std.testing.expectEqualSlices(c_ushort, &.{ 64669, 14399, 33170 }, &xsubi); } test jrand48 { var xsubi: [3]c_ushort = .{ 25175, 11052, 45015 }; try std.testing.expectEqual(1699503220, jrand48(&xsubi)); try std.testing.expectEqualSlices(c_ushort, &.{ 2326, 23668, 25932 }, &xsubi); try std.testing.expectEqual(-992276007, jrand48(&xsubi)); try std.testing.expectEqualSlices(c_ushort, &.{ 41577, 4569, 50395 }, &xsubi); try std.testing.expectEqual(-19535776, jrand48(&xsubi)); try std.testing.expectEqualSlices(c_ushort, &.{ 31936, 59488, 65237 }, &xsubi); try std.testing.expectEqual(79438377, jrand48(&xsubi)); try std.testing.expectEqualSlices(c_ushort, &.{ 40395, 8745, 1212 }, &xsubi); try std.testing.expectEqual(-1258917728, jrand48(&xsubi)); try std.testing.expectEqualSlices(c_ushort, &.{ 37242, 28832, 46326 }, &xsubi); } test nrand48 { var xsubi: [3]c_ushort = .{ 546, 33817, 23389 }; try std.testing.expectEqual(914920692, nrand48(&xsubi)); try std.testing.expectEqualSlices(c_ushort, &.{ 29829, 10728, 27921 }, &xsubi); try std.testing.expectEqual(754104482, nrand48(&xsubi)); try std.testing.expectEqualSlices(c_ushort, &.{ 6828, 28997, 23013 }, &xsubi); try std.testing.expectEqual(609453945, nrand48(&xsubi)); try std.testing.expectEqualSlices(c_ushort, &.{ 58183, 3826, 18599 }, &xsubi); try std.testing.expectEqual(1878644360, nrand48(&xsubi)); try std.testing.expectEqualSlices(c_ushort, &.{ 36678, 44304, 57331 }, &xsubi); try std.testing.expectEqual(2114923686, nrand48(&xsubi)); try std.testing.expectEqualSlices(c_ushort, &.{ 58585, 22861, 64542 }, &xsubi); }