Stdlib.Digest(3)

🌸 NAME 🌸

Stdlib.Digest — no description 💅 (that's literally what it says, bestie, the manpage gives us nothing here)

---

🦋 Module

Module Stdlib.Digest

📓 Documentation

Module Digest : (module Stdlib__Digest)

---

✨ Basic functions ✨

Okay so the functions in this section use the MD5 hash function to make 128-bit digests (16 bytes). MD5 is not cryptographically secure — no cap, it's just not. So like, do not use these for security-sensitive applications, fr fr. The BLAKE2 functions further down are cryptographically secure, those are the ones you want for that 🫶

• type t = string — the type of digests: 16-byte strings. That's the whole vibe.
• val compare : t -> t -> int — the comparison function for 16-byte digests, with the same specification as compare and the implementation shared with String.compare. Along with the type t, this function compare is what lets the module Digest be passed as an argument to the functors Set.Make and Map.Make. Slay. ✨ Since 4.00
• val equal : t -> t -> bool — the equal function for 16-byte digests. 🎀 Since 4.03
• val string : string -> t — return the digest of the given string.
• val bytes : bytes -> t — return the digest of the given byte sequence. 🦋 Since 4.02
• val substring : string -> int -> int -> t — Digest.substring s ofs len returns the digest of the substring of s starting at index ofs and containing len characters.
• val subbytes : bytes -> int -> int -> t — Digest.subbytes s ofs len returns the digest of the subsequence of s starting at index ofs and containing len bytes. 💜 Since 4.02
• val channel : in_channel -> int -> t — if len is nonnegative, Digest.channel ic len reads len characters from channel ic and returns their digest, or raises End_of_file if end-of-file is reached before len characters are read. If len is negative, Digest.channel ic len reads all characters from ic until end-of-file is reached and returns their digest. iykyk 😌
• val file : string -> t — return the digest of the file whose name is given.
• val output : out_channel -> t -> unit — write a digest on the given output channel.
• val input : in_channel -> t — read a digest from the given input channel.
• val to_hex : t -> string — return the printable hexadecimal representation of the given digest.

Raises Invalid_argument if the argument is not exactly 16 bytes. ⚠️ like, exactly 16, no negotiations.

• val of_hex : string -> t — convert a hexadecimal representation back into the corresponding digest. 🌈 Since 5.2

Raises Invalid_argument if the argument is not exactly 32 hexadecimal characters. 🫠

• val from_hex : string -> t — same function as Digest.of_hex. 🍓 Since 4.00

---

🧚 Generic interface 🧚

• module type S = sig end — the signature for a hash function that produces digests of length hash_length from character strings, byte arrays, and files. 👑 Since 5.2

---

🔥 Specific hash functions 🔥

• module BLAKE128 : S — BLAKE128 is the BLAKE2b hash function producing 128-bit (16-byte) digests. It is cryptographically secure. However — and this is the important bit, bestie — the small size of the digests enables brute-force attacks in 2{^64} attempts. 💀 Since 5.2
• module BLAKE256 : S — BLAKE256 is the BLAKE2b hash function producing 256-bit (32-byte) digests. It is cryptographically secure, and the digests are large enough to thwart brute-force attacks. main character energy honestly 💖 Since 5.2
• module BLAKE512 : S — BLAKE512 is the BLAKE2b hash function producing 512-bit (64-byte) digests. It is cryptographically secure, and the digests are large enough to thwart brute-force attacks. ✨ Since 5.2
• module MD5 : S — MD5 is the MD5 hash function. It produces 128-bit (16-byte) digests and is not cryptographically secure at all. It should be used only for compatibility with earlier designs that mandate the use of MD5. 🙈 Since 5.2

---

okay that's the whole page, bestie — no behind-the-scenes lore, no secret extra functions, this is the entire vibe check 💅

---

this iconic little doc was served up by OCamldoc on 2026-06-22, for Stdlib.Digest(3) — stay hydrated and hash responsibly 🫶✨