From 0086b162aa6c4b4f9ed98ff7c9f2f31dbe039944 Mon Sep 17 00:00:00 2001
From: Sadie Powell
Date: Sat, 13 Jan 2024 17:45:42 +0000
Subject: Add Hex::Decode as a complement for Hex::Encode.

---
 include/stringutils.h | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

(limited to 'include/stringutils.h')

diff --git a/include/stringutils.h b/include/stringutils.h
index 7032ea75f..854b62647 100644
--- a/include/stringutils.h
+++ b/include/stringutils.h
@@ -79,6 +79,26 @@ namespace Hex
 	/** The table used for encoding as an upper-case hexadecimal string. */
 	inline constexpr const char* TABLE_UPPER = "0123456789ABCDEF";
 
+	/** Decodes a hexadecimal-encoded byte array.
+	 * @param data The byte array to decode from.
+	 * @param length The length of the byte array.
+	 * @param separator If non-zero then the character hexadecimal digits are separated with.
+	 * @param table The index table to use for decoding.
+	 * @return The decoded form of the specified data.
+	 */
+	CoreExport std::string Decode(const void* data, size_t length, const char* table = nullptr, char separator = 0);
+
+	/** Decodes a hexadecimal-encoded string.
+	 * @param data The string to decode from.
+	 * @param table The index table to use for decoding.
+	 * @param separator If non-zero then the character hexadecimal digits are separated with.
+	 * @return The decoded form of the specified data.
+	 */
+	inline std::string Decode(const std::string& data, const char* table = nullptr, char separator = 0)
+	{
+		return Decode(data.c_str(), data.length(), table, separator);
+	}
+
 	/** Encodes a byte array using hexadecimal encoding.
 	 * @param data The byte array to encode from.
 	 * @param length The length of the byte array.
-- 
cgit v1.3.1-10-gc9f91