Sha1¶

1

import "std/crypto/sha1";

Sha1 struct¶

SHA-1 message digest, as specified in RFC 3174.

SHA-1 is considered cryptographically broken: chosen-prefix collisions are computationally feasible. It is provided for interoperability with existing formats and protocols (git object ids, legacy certificates, older signature schemes) only. Never use it for new security-relevant work - reach for std/crypto/sha256 instead.

The digest is computed incrementally, so arbitrarily large messages can be fed in chunk by chunk:

spice Sha1 hasher; hasher.update("Hello, "); hasher.update("World!"); printf("%s\n", hasher.finalize().getRaw()); // 0a0a9f2a6772942557ab5355d76af442f8f65e01

For one-shot use, the free sha1 functions wrap the same steps in a single call.

Constructors¶

ctor¶

1

public p Sha1.ctor()

Construct a hasher that is ready to consume the first message byte

Methods¶

reset¶

1

public p Sha1.reset()

Discard any consumed input and return to the initial state, ready for a new message

update¶

1

public p Sha1.update(const byte[] data, unsigned long length)

Feed the given raw bytes into the digest

Parameters

update¶

1

public p Sha1.update(string data)

Feed the chars of the given raw string into the digest, excluding the null terminator

Parameters

update¶

1

public p Sha1.update(const String& data)

Feed the chars of the given string into the digest

Parameters

finalizeInto¶

1

public p Sha1.finalizeInto(byte[] digest)

Complete the digest and write its 20 raw bytes to the given output array. The hasher is reset afterwards, so it can be reused for the next message.

Parameters

finalize¶

1

public f<String> Sha1.finalize()

Complete the digest and return it as a lowercase hex string. The hasher is reset afterwards, so it can be reused for the next message.

Returns: String — Digest as 40 lowercase hex chars

getDigestSize¶

1

public inline f<unsigned long> Sha1.getDigestSize()

Retrieve the number of bytes a SHA-1 digest occupies

Returns: unsigned long — Digest size in bytes

getBlockSize¶

1

public inline f<unsigned long> Sha1.getBlockSize()

Retrieve the number of bytes SHA-1 consumes per compression step

Returns: unsigned long — Block size in bytes

Functions¶

sha1¶

1

public f<String> sha1(string input)

Compute the SHA-1 digest of the given raw string

Parameters

Returns: String — Digest as 40 lowercase hex chars

sha1¶

1

public f<String> sha1(const String& input)

Compute the SHA-1 digest of the given string

Parameters

Returns: String — Digest as 40 lowercase hex chars

sha1¶

1

public f<String> sha1(const byte[] input, unsigned long length)

Compute the SHA-1 digest of the given raw bytes

Parameters

Returns: String — Digest as 40 lowercase hex chars