This class represents a SHA‐384 digest that can be updated as additional data is provided.

Synopsis

Declared in <bdlde_sha2.h>

class Sha384;

Description

More generally, this class supports a complete set of value semantic operations, including copy construction, assignment, equality comparison, and ostream printing. (A precise operational definition of when two instances have the same value can be found in the description of operator== for the class.) This container is exception neutral with no guarantee of rollback: if an exception is thrown during the invocation of a method on a pre‐existing instance, the class is left in a valid state, but its value is undefined. In no event is memory leaked. Finally, aliasing (e.g., using all or part of an object as both source and destination) is supported in all cases.

Member Functions

Name

Description

Sha384 [constructor]

Constructors

loadDigest

Load the value of this SHA‐2 digest into the specified result.

loadDigestAndReset

Load the current value of this SHA‐2 digest into the specified result and set the value of this SHA‐2 digest to the value provided by the default constructor.

print

Format the current value of this SHA‐2 digest to the specified output stream and return a reference to the modifiable stream.

reset

Reset the value of this SHA‐2 digest to the value provided by the default constructor.

update

Update the value of this SHA‐2 digest to incorporate the specified data having the specified length in bytes. If the current state is the default state, the resultant value of this SHA‐2 digest is the application of the SHA‐2 algorithm upon the currently given data of the given length. If this digest has been previously provided data and has not been subsequently reset, the current state is not the default state and the resultant value is equivalent to applying the SHA‐2 algorithm upon the concatenation of all the provided data. The behavior is undefined unless the range [data, data + length)] is a valid range. Note that if data is 0, then length must also be 0.

Static Data Members

Name

Description

k_DIGEST_SIZE

The size (in bytes) of the output

Friends

Name

Description

BloombergLP::bdlde::operator==

Return true if the specified lhs and rhs SHA digests have the same value, and false otherwise. Two digests have the same value if, after applying any number of equivalent updates to both (possibly including no updates), the values obtained from their respective loadDigest methods are identical.

Non-Member Functions

Name

Description

operator!=

Return true if the specified lhs and rhs SHA digests do not have the same value, and false otherwise. Two digests do not have the same value if there exists a set of updates (possibly including the empty set) that, if applied to both, lead to different values being obtained from their respective loadDigest methods.

Created with MrDocs