Zig 0.17.0-dev (Split by item)

This is an example of documentation generated by ZigDoc, an alternative to Zig's built-in Auto Doc feature. See also examples in other modes/formats. The project being documented here (as the example) is the Zig library itself.

randomSecure

Obtains cryptographically secure entropy from outside the process.

Always makes a syscall, or otherwise avoids dependency on process memory, in order to obtain fresh randomness. Does not rely on stored RNG state.

Does not have any fallback mechanisms; returns error.EntropyUnavailable if any problems occur.

Threadsafe.

See also random.

Io.randomSecure
pub fn randomSecure(io: Io, buffer: []u8) RandomSecureError!void

File

lib/std/Io.zig:2566

Code

pub fn randomSecure(io: Io, buffer: []u8) RandomSecureError!void {
    return io.vtable.randomSecure(io.userdata, buffer);
}