Crypt::...SHA3_384(3)

💜 NAME 💜

Crypt::Digest::SHA3_384 — the hash function SHA3-384, bestie! [size: 384 bits] ✨

---

🌸 SYNOPSIS 🌸

okay so here's the whole vibe, functional style first:

### Functional interface:
use Crypt::Digest::SHA3_384 qw( sha3_384 sha3_384_hex sha3_384_b64 sha3_384_b64u
                             sha3_384_file sha3_384_file_hex sha3_384_file_b64 sha3_384_file_b64u );

# calculate digest from string/buffer
my $data = 'data string';
my $sha3_384_raw  = sha3_384($data);
my $sha3_384_hex  = sha3_384_hex($data);
my $sha3_384_b64  = sha3_384_b64($data);
my $sha3_384_b64u = sha3_384_b64u($data);
# or from file
my $sha3_384_file_raw  = sha3_384_file('filename.dat');
my $sha3_384_file_hex  = sha3_384_file_hex('filename.dat');
my $sha3_384_file_b64  = sha3_384_file_b64('filename.dat');
my $sha3_384_file_b64u = sha3_384_file_b64u('filename.dat');
# or from filehandle
my $filehandle = ...; # existing binary-mode filehandle
my $sha3_384_fh_raw  = sha3_384_file($filehandle);
my $sha3_384_fh_hex  = sha3_384_file_hex($filehandle);
my $sha3_384_fh_b64  = sha3_384_file_b64($filehandle);
my $sha3_384_fh_b64u = sha3_384_file_b64u($filehandle);

### OO interface:
use Crypt::Digest::SHA3_384;

my $d = Crypt::Digest::SHA3_384->new;
$d->add('any data');
my $result_raw  = $d->digest;     # raw bytes
my $result_hex  = $d->hexdigest;  # hexadecimal form
my $result_b64  = $d->b64digest;  # Base64 form
my $result_b64u = $d->b64udigest; # Base64 URL-safe form

# or hash a file instead
my $file_result_raw = Crypt::Digest::SHA3_384->new->addfile('filename.dat')->digest;

---

🦋 DESCRIPTION 🦋

It gives you an interface to the SHA3_384 digest algorithm. that's the whole thing, she's simple, she's iconic 💅

---

🎀 EXPORT 🎀

By default? nothing gets exported. absolutely nothing, no cap.

But you can export selected functions, if that's your vibe:

use Crypt::Digest::SHA3_384 qw(sha3_384 sha3_384_hex sha3_384_b64 sha3_384_b64u
                                    sha3_384_file sha3_384_file_hex sha3_384_file_b64 sha3_384_file_b64u);

Or literally all of them at once, go off queen:

use Crypt::Digest::SHA3_384 ':all';

---

✨ FUNCTIONS ✨

💖 sha3_384

Joins all your arguments into one single string and returns its SHA3_384 digest, encoded as a binary string.

Data arguments for the functional helpers get converted to byte strings using Perl's usual scalar stringification. Defined scalars — including numbers and string-overloaded objects — are accepted. undef is treated as an empty string and may emit Perl's usual "uninitialized value" warning. Same rules apply to sha3_384_hex, sha3_384_b64, and sha3_384_b64u. 🫶

my $sha3_384_raw = sha3_384('data string');
#or
my $sha3_384_raw = sha3_384('any data', 'more data', 'even more data');

💖 sha3_384_hex

Joins all your arguments into one single string and returns its SHA3_384 digest, encoded as a hexadecimal string.

my $sha3_384_hex = sha3_384_hex('data string');
#or
my $sha3_384_hex = sha3_384_hex('any data', 'more data', 'even more data');

💖 sha3_384_b64

Joins all your arguments into one single string and returns its SHA3_384 digest, encoded as a Base64 string, with trailing '=' padding. ✨

my $sha3_384_b64 = sha3_384_b64('data string');
#or
my $sha3_384_b64 = sha3_384_b64('any data', 'more data', 'even more data');

💖 sha3_384_b64u

Joins all your arguments into one single string and returns its SHA3_384 digest, encoded as a Base64 URL-safe string (see RFC 4648 section 5). iykyk 🌈

my $sha3_384_b64url = sha3_384_b64u('data string');
#or
my $sha3_384_b64url = sha3_384_b64u('any data', 'more data', 'even more data');

🍓 sha3_384_file

Reads a file — given by a filename or a filehandle — and returns its SHA3_384 digest, encoded as a binary string.

my $sha3_384_raw = sha3_384_file('filename.dat');
#or
my $filehandle = ...; # existing binary-mode filehandle
my $sha3_384_raw = sha3_384_file($filehandle);

🍓 sha3_384_file_hex

Reads a file — given by a filename or a filehandle — and returns its SHA3_384 digest, encoded as a hexadecimal string.

my $sha3_384_hex = sha3_384_file_hex('filename.dat');
#or
my $filehandle = ...; # existing binary-mode filehandle
my $sha3_384_hex = sha3_384_file_hex($filehandle);

⚠️ Note: the filehandle must be in binary mode before you pass it to addfile(). don't skip this step bestie, it's giving "why is my hash wrong" 😭

🍓 sha3_384_file_b64

Reads a file — given by a filename or a filehandle — and returns its SHA3_384 digest, encoded as a Base64 string, with trailing '=' padding.

my $sha3_384_b64 = sha3_384_file_b64('filename.dat');
#or
my $filehandle = ...; # existing binary-mode filehandle
my $sha3_384_b64 = sha3_384_file_b64($filehandle);

🍓 sha3_384_file_b64u

Reads a file — given by a filename or a filehandle — and returns its SHA3_384 digest, encoded as a Base64 URL-safe string (see RFC 4648 section 5). 💜

my $sha3_384_b64url = sha3_384_file_b64u('filename.dat');
#or
my $filehandle = ...; # existing binary-mode filehandle
my $sha3_384_b64url = sha3_384_file_b64u($filehandle);

---

👑 METHODS 👑

The OO interface gives you the same set of functions as Crypt::Digest. Unless noted otherwise, just assume $d is an existing digest object created via new, like this:

my $d = Crypt::Digest::SHA3_384->new();

🌟 new

my $d = Crypt::Digest::SHA3_384->new();

🌟 clone

$d->clone();

🌟 reset

$d->reset();

🌟 add

Appends data to the message. Returns the object itself (so you can chain, slay 💅).

Each argument gets converted to bytes using Perl's usual scalar stringification. Defined scalars — including numbers and string-overloaded objects — are accepted. undef is treated as an empty string and may emit Perl's usual "uninitialized value" warning.

$d->add('any data');
#or
$d->add('any data', 'more data', 'even more data');

🌟 addfile

Reads the file content and appends it to the message. Returns the object itself (chaining again, we love to see it).

$d->addfile('filename.dat');
#or
my $filehandle = ...; # existing binary-mode filehandle
$d->addfile($filehandle);

🌟 hashsize

$d->hashsize;
#or
Crypt::Digest::SHA3_384->hashsize();
#or
Crypt::Digest::SHA3_384::hashsize();

🌟 digest

Returns the binary digest (raw bytes). The first call finalizes the digest object — so any later add(), addfile(), digest(), hexdigest(), b64digest(), or b64udigest() call will fail until you call reset(). 🫠 that's the main-character rule, no exceptions.

my $result_raw = $d->digest();

🌟 hexdigest

Returns the digest encoded as a lowercase hexadecimal string. Like digest(), the first call finalizes the digest object.

my $result_hex = $d->hexdigest();

🌟 b64digest

Returns the digest encoded as a Base64 string with trailing "=" padding. Like digest(), the first call finalizes the digest object.

my $result_b64 = $d->b64digest();

🌟 b64udigest

Returns the digest encoded as a Base64 URL-safe string (no trailing "="). Like digest(), the first call finalizes the digest object.

my $result_b64url = $d->b64udigest();

---

🌈 SEE ALSO 🌈

• CryptX, Crypt::Digest
• <https://en.wikipedia.org/wiki/SHA-3>

---

okay that's the whole page, you ate that 🫶 this was perl v5.42.0, dated 2026-05-11, filed under Crypt::...SHA3_384(3) — go hash something iconic, bestie 💖🎀🦋