Zig 0.17.0-dev (Split by item)

Shortcut keys
?
Show these tips
S
Focus search field
Esc
Clear focus & close tips
U
Jump to source code
↑
Move up in search results
↓
Move down in search results
↵
Go to active search result
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 standard library. Public Function

randomSecure

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

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.

Params

  • io: Io
  • buffer: []u8

File

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