<!-- GENERATED by docs/sphinx/bin/02-reference from Digest/SHA.rs (xs_hexdigest). Do not edit. -->

```{index} single: hexdigest; Digest::SHA function
```
```{index} single: Digest::SHA::hexdigest; Perl function
```

# hexdigest

Finalise the running hash and return the digest as a lowercase hex string.

Identical to `digest` except for encoding: the result is a string of
lowercase hexadecimal characters, twice the length of the raw digest
(40 chars for SHA-1, 64 for SHA-256, 128 for SHA-512, etc.). As with
`digest`, the object is automatically reset after the call.

## Synopsis

```perl
my $hex = $sha->hexdigest;
```

## What you get back

A string of `[0-9a-f]` characters of length `hashsize / 4`.

## Examples

```perl
my $sha = Digest::SHA->new(256);
$sha->add("abc");
print $sha->hexdigest;

## ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad

```

```perl
my $sha = Digest::SHA->new(1);
print $sha->hexdigest;

## da39a3ee5e6b4b0d3255bfef95601890afd80709   (empty-input SHA-1)

```

```perl
use Digest::SHA;
print Digest::SHA->new(512)->add("The quick brown fox")->hexdigest, "\n";
```

## Edge cases

- Auto-resets the object, same as `digest`.
- Called on an object with no input fed, returns the hex digest of the
  empty string (`da39a3ee…` for SHA-1, `e3b0c442…` for SHA-256).
- Called on a non-`Digest::SHA` object, returns `undef`.

## Differences from upstream

Fully compatible with upstream `Digest::SHA` {{ upstream.Digest_SHA }}.

## See also

- `digest` — raw-byte counterpart.
- `b64digest` — unpadded Base64 counterpart.
- `sha256_hex` — functional one-shot with the same output shape.