Download
97 lines 2.6 KiBCModified 2026-01-21 raw
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
/**
 * Copyright (c) 2006-2026 LOVE Development Team
 *
 * This software is provided 'as-is', without any express or implied
 * warranty.  In no event will the authors be held liable for any damages
 * arising from the use of this software.
 *
 * Permission is granted to anyone to use this software for any purpose,
 * including commercial applications, and to alter it and redistribute it
 * freely, subject to the following restrictions:
 *
 * 1. The origin of this software must not be misrepresented; you must not
 *    claim that you wrote the original software. If you use this software
 *    in a product, an acknowledgment in the product documentation would be
 *    appreciated but is not required.
 * 2. Altered source versions must be plainly marked as such, and must not be
 *    misrepresented as being the original software.
 * 3. This notice may not be removed or altered from any source distribution.
 **/

#pragma once

// LOVE
#include "common/Data.h"
#include "common/StringMap.h"
#include "common/int.h"

namespace love
{
namespace data
{

class HashFunction
{
public:

	enum Function
	{
		FUNCTION_MD5,
		FUNCTION_SHA1,
		FUNCTION_SHA224,
		FUNCTION_SHA256,
		FUNCTION_SHA384,
		FUNCTION_SHA512,
		FUNCTION_MAX_ENUM
	};

	struct Value
	{
		char data[64]; // Maximum possible size (SHA512).
		size_t size;
	};

	/**
	 * Get a HashFunction instance for the given function.
	 *
	 * @param[in] function The selected hash function.
	 * @return An instance of HashFunction for the given function, or NULL if
	 *         not available.
	 **/
	static HashFunction *getHashFunction(Function function);

	virtual ~HashFunction() {}

	/**
	 * Hash the input, producing an set of bytes as output.
	 *
	 * @param[in] function The selected hash function.
	 * @param[in] input The input data to hash.
	 * @param[in] length The length of the input data.
	 * @param[out] output The result of the hash function.
	 **/
	virtual void hash(Function function, const char *input, uint64 length, Value &output) const = 0;

	/**
	 * @param[in] function The requested hash function.
	 * @return Whether this HashFunction instance implements the given function.
	 **/
	virtual bool isSupported(Function function) const = 0;

	static bool getConstant(const char *in, Function &out);
	static bool getConstant(const Function &in, const char *&out);
	static std::vector<std::string> getConstants(Function);

protected:

	HashFunction() {}

private:

	static StringMap<Function, FUNCTION_MAX_ENUM>::Entry functionEntries[];
	static StringMap<Function, FUNCTION_MAX_ENUM> functionNames;

}; // HashFunction

} // data
} // love