authorgravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2026-01-06 14:49:22-08:00
committergravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2026-01-07 11:03:37-08:00
loga136890accfc3b269b6eaa9139bae829ef36cc6b
tree6f39f1891594c6c804ab13d4ee135db011e4bb07
parente23bec700c0899aeda9a63e5906b5f74dc49512c

std.Io.random: clarify doc comments

1 files changed, 4 insertions(+), 3 deletions(-)

lib/std/Io.zig+4-3
...@@ -2246,13 +2246,14 @@ pub fn unlockStderr(io: Io) void {...@@ -2246,13 +2246,14 @@ pub fn unlockStderr(io: Io) void {
2246 return io.vtable.unlockStderr(io.userdata);2246 return io.vtable.unlockStderr(io.userdata);
2247}2247}
22482248
2249/// Obtains entropy.2249/// Obtains entropy from a cryptographically secure pseudo-random number
2250/// generator.
2250///2251///
2251/// The implementation *may* store RNG state in process memory and use it to2252/// The implementation *may* store RNG state in process memory and use it to
2252/// fill `buffer`.2253/// fill `buffer`.
2253///2254///
2254/// The degree to which the entropy is cryptographically secure is determined2255/// The randomness is seeded by `randomSecure`, or a less secure mechanism upon
2255/// by the `Io` implementation.2256/// failure.
2256///2257///
2257/// Threadsafe.2258/// Threadsafe.
2258///2259///