#include <bslh_siphashalgorithm.h>

Public Types
enum	{ k_SEED_LENGTH = 16 }

typedef Uint64	result_type
	Typedef indicating the value type returned by this algorithm.

Public Member Functions
	SipHashAlgorithm (const char *seed)

	~SipHashAlgorithm ()=default

void	operator() (const void *data, size_t numBytes)

result_type	computeHash ()

Detailed Description

This class wraps an implementation of the "SipHash" algorithm in an interface that is usable in the modular hashing system in bslh.

See bslh_siphashalgorithm

Member Typedef Documentation

◆ result_type

typedef Uint64 bslh::SipHashAlgorithm::result_type

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Enumerator
k_SEED_LENGTH

Constructor & Destructor Documentation

◆ SipHashAlgorithm()

bslh::SipHashAlgorithm::SipHashAlgorithm ( const char * seed )

explicit

Create a bslh::SipHashAlgorithm, seeded with a 128-bit (k_SEED_LENGTH bytes) seed pointed to by the specified seed. Each bit of the supplied seed will contribute to the final hash produced by computeHash(). The behaviour is undefined unless seed points to at least 16 bytes of initialized memory. Note that if data in seed is not random, all guarantees of security and Denial of Service (DoS) protection are void.

◆ ~SipHashAlgorithm()

bslh::SipHashAlgorithm::~SipHashAlgorithm ( )

default

Member Function Documentation

◆ computeHash()

result_type bslh::SipHashAlgorithm::computeHash ( )

Return the finalized version of the hash that has been accumulated. Note that this changes the internal state of the object, so calling computeHash() multiple times in a row will return different results, and only the first result returned will match the expected result of the algorithm. Also note that a value will be returned, even if data has not been passed into operator()

◆ operator()()

void bslh::SipHashAlgorithm::operator()	(	const void *	data,
		size_t	numBytes
	)

Incorporate the specified data, of at least the specified numBytes, into the internal state of the hashing algorithm. Every bit of data incorporated into the internal state of the algorithm will contribute to the final hash produced by computeHash(). The same hash will be produced regardless of whether a sequence of bytes is passed in all at once or through multiple calls to this member function. Input where numBytes is 0 will have no effect on the internal state of the algorithm. The behaviour is undefined unless data points to a valid memory location with at least numBytes bytes of initialized memory.

Member Data Documentation

◆ d_alignment

Uint64 bslh::SipHashAlgorithm::d_alignment

◆ d_buf

unsigned char bslh::SipHashAlgorithm::d_buf[8]

Used to buffer data until we have enough to do a full round of computation as specified by the algorithm.

The documentation for this class was generated from the following file:

bslh_siphashalgorithm.h

Public Types

Public Member Functions