跳转到内容
标准库Zig 0.17.0官方原文
源码std/Random/Pcg.zig

第 1 行

PCG32 - http://www.pcg-random.org/

伪随机数生成器

字段

s: u64
i: u64

std.Random.Pcg.default_multiplier

常量

第 8 行

std.Random.Pcg.fill

函数

第 51 行

pub fn fill(self: *Pcg, buf: []u8) void

参数

self: *Pcg
buf: []u8

用法示例

test fill {
    var r = Pcg.init(0);
    const s0: u64 = 0x9394bf54ce5d79de;
    const s1: u64 = 0x84e9c579ef59bbf7;
    r.seedTwo(s0, s1);

    const seq = [_]u32{
        2881561918,
        3063928540,
        1199791034,
        2487695858,
        1479648952,
        3247963454,
    };

    var i: u32 = 0;
    while (i < seq.len) : (i += 2) {
        var buf0: [8]u8 = undefined;
        std.mem.writeInt(u32, buf0[0..4], seq[i], .little);
        std.mem.writeInt(u32, buf0[4..8], seq[i + 1], .little);

        var buf1: [7]u8 = undefined;
        r.fill(&buf1);

        try std.testing.expect(std.mem.eql(u8, buf0[0..7], buf1[0..]));
    }
}

std.Random.Pcg.init

函数

第 13 行

pub fn init(init_s: u64) Pcg

参数

init_s: u64

std.Random.Pcg.next

函数

第 27 行

fn next(self: *Pcg) u32

参数

self: *Pcg

std.Random.Pcg.Pcg

别名

第 6 行

别名目标 std.Random.Pcg

std.Random.Pcg.random

函数

第 23 行

pub fn random(self: *Pcg) std.Random

参数

self: *Pcg

std.Random.Pcg.seed

函数

第 37 行

fn seed(self: *Pcg, init_s: u64) void

参数

self: *Pcg
init_s: u64

std.Random.Pcg.seedTwo

函数

第 43 行

fn seedTwo(self: *Pcg, init_s: u64, init_i: u64) void

参数

self: *Pcg
init_s: u64
init_i: u64

std.Random.Pcg.std

别名

第 5 行

别名目标 std

源码

std/Random/Pcg.zig

//! PCG32 - http://www.pcg-random.org/
//!
//! 伪随机数生成器

const std = @import("std");
const Pcg = @This();

const default_multiplier = 6364136223846793005;

s: u64,
i: u64,

pub fn init(init_s: u64) Pcg {
    var pcg = Pcg{
        .s = undefined,
        .i = undefined,
    };

    pcg.seed(init_s);
    return pcg;
}

pub fn random(self: *Pcg) std.Random {
    return std.Random.init(self, fill);
}

fn next(self: *Pcg) u32 {
    const l = self.s;
    self.s = l *% default_multiplier +% (self.i | 1);

    const xor_s: u32 = @truncate(((l >> 18) ^ l) >> 27);
    const rot: u32 = @intCast(l >> 59);

    return (xor_s >> @as(u5, @intCast(rot))) | (xor_s << @as(u5, @intCast((0 -% rot) & 31)));
}

fn seed(self: *Pcg, init_s: u64) void {
    // Pcg 需要 128 位种子。
    var gen = std.Random.SplitMix64.init(init_s);
    self.seedTwo(gen.next(), gen.next());
}

fn seedTwo(self: *Pcg, init_s: u64, init_i: u64) void {
    self.s = 0;
    self.i = (init_s << 1) | 1;
    self.s = self.s *% default_multiplier +% self.i;
    self.s +%= init_i;
    self.s = self.s *% default_multiplier +% self.i;
}

pub fn fill(self: *Pcg, buf: []u8) void {
    var i: usize = 0;
    const aligned_len = buf.len - (buf.len & 3);

    // 完整的 4 字节片段。
    while (i < aligned_len) : (i += 4) {
        var n = self.next();
        comptime var j: usize = 0;
        inline while (j < 4) : (j += 1) {
            buf[i + j] = @as(u8, @truncate(n));
            n >>= 8;
        }
    }

    // 剩余部分。(截断流)
    if (i != buf.len) {
        var n = self.next();
        while (i < buf.len) : (i += 1) {
            buf[i] = @as(u8, @truncate(n));
            n >>= 8;
        }
    }
}

test "sequence" {
    var r = Pcg.init(0);
    const s0: u64 = 0x9394bf54ce5d79de;
    const s1: u64 = 0x84e9c579ef59bbf7;
    r.seedTwo(s0, s1);

    const seq = [_]u32{
        2881561918,
        3063928540,
        1199791034,
        2487695858,
        1479648952,
        3247963454,
    };

    for (seq) |s| {
        try std.testing.expect(s == r.next());
    }
}

test fill {
    var r = Pcg.init(0);
    const s0: u64 = 0x9394bf54ce5d79de;
    const s1: u64 = 0x84e9c579ef59bbf7;
    r.seedTwo(s0, s1);

    const seq = [_]u32{
        2881561918,
        3063928540,
        1199791034,
        2487695858,
        1479648952,
        3247963454,
    };

    var i: u32 = 0;
    while (i < seq.len) : (i += 2) {
        var buf0: [8]u8 = undefined;
        std.mem.writeInt(u32, buf0[0..4], seq[i], .little);
        std.mem.writeInt(u32, buf0[4..8], seq[i + 1], .little);

        var buf1: [7]u8 = undefined;
        r.fill(&buf1);

        try std.testing.expect(std.mem.eql(u8, buf0[0..7], buf1[0..]));
    }
}