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.
SipHash128
SipHash function with 128-bit output.
Recommended parameters are:
(c_rounds=4, d_rounds=8) for conservative security; regular hash functions such as BLAKE2 or BLAKE3 are usually a better alternative.
(c_rounds=2, d_rounds=4) standard parameters.
(c_rounds=1, d_rounds=4) reduced-round function. Recommended to hash very short, similar strings, when a 128-bit PRF output is still required.
(c_rounds=1, d_rounds=3) reduced-round function. Faster, no known implications on its practical security level.
(c_rounds=1, d_rounds=2) fastest option, but the output may be distinguishable from random data with related keys or non-uniform input - not suitable as a PRF.
SipHash is not a traditional hash function. If the input includes untrusted content, a secret key is absolutely necessary.
siphash.SipHash128
pubfnSipHash128(comptimec_rounds: usize, comptimed_rounds: usize) type