/*
==============================================================================
This file is part of the JUCE library.
Copyright (c) 2015 - ROLI Ltd.
Permission is granted to use this software under the terms of either:
a) the GPL v2 (or any later version)
b) the Affero GPL v3
Details of these licenses can be found at: www.gnu.org/licenses
JUCE is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
------------------------------------------------------------------------------
To release a closed-source product which uses JUCE, commercial licenses are
available: visit www.juce.com for more information.
==============================================================================
*/
#ifndef JUCE_WHIRLPOOL_H_INCLUDED
#define JUCE_WHIRLPOOL_H_INCLUDED
//==============================================================================
/**
Whirlpool hash class.
The Whirlpool algorithm was developed by
Paulo S. L. M. Barreto and
Vincent Rijmen.
See
P.S.L.M. Barreto, V. Rijmen,
"The Whirlpool hashing function"
NESSIE submission, 2000 (tweaked version, 2001),
https://www.cosic.esat.kuleuven.ac.be/nessie/workshop/submissions/whirlpool.zip
@see SHA256, MD5
*/
class JUCE_API Whirlpool
{
public:
//==============================================================================
/** Creates an empty Whirlpool object.
The default constructor just creates a hash filled with zeros. (This is not
equal to the hash of an empty block of data).
*/
Whirlpool() noexcept;
/** Destructor. */
~Whirlpool() noexcept;
/** Creates a copy of another Whirlpool. */
Whirlpool (const Whirlpool& other) noexcept;
/** Copies another Whirlpool. */
Whirlpool& operator= (const Whirlpool& other) noexcept;
//==============================================================================
/** Creates a hash from a block of raw data. */
explicit Whirlpool (const MemoryBlock&);
/** Creates a hash from a block of raw data. */
Whirlpool (const void* data, size_t numBytes);
/** Creates a hash from the contents of a stream.
This will read from the stream until the stream is exhausted, or until
maxBytesToRead bytes have been read. If maxBytesToRead is negative, the entire
stream will be read.
*/
Whirlpool (InputStream& input, int64 maxBytesToRead = -1);
/** Reads a file and generates the hash of its contents.
If the file can't be opened, the hash will be left uninitialised
(i.e. full of zeros).
*/
explicit Whirlpool (const File& file);
/** Creates a checksum from a UTF-8 buffer.
E.g.
@code Whirlpool checksum (myString.toUTF8());
@endcode
*/
explicit Whirlpool (CharPointer_UTF8 utf8Text) noexcept;
//==============================================================================
/** Returns the hash as a 64-byte block of data. */
MemoryBlock getRawData() const;
/** Returns the checksum as a 128-digit hex string. */
String toHexString() const;
//==============================================================================
bool operator== (const Whirlpool&) const noexcept;
bool operator!= (const Whirlpool&) const noexcept;
private:
//==============================================================================
uint8 result [64];
void process (const void*, size_t);
JUCE_LEAK_DETECTOR (Whirlpool)
};
#endif // JUCE_WHIRLPOOL_H_INCLUDED