Added.

[silc.git] / lib / silcutil / silcutil.h

diff --git a/lib/silcutil/silcutil.h b/lib/silcutil/silcutil.h
index c6b0d43f1938fb34d6bbba40f6d494cb222aa3f5..e62e768d15d0bede90cb82b3f191969e0ea07bde 100644 (file)
--- a/lib/silcutil/silcutil.h
+++ b/lib/silcutil/silcutil.h
@@ -156,8 +156,7 @@ char *silc_format(char *fmt, ...);
  *
  *    Basic has function to hash strings. May be used with the SilcHashTable.
  *    Note that this lowers the characters of the string (with tolower()) so
- *    this is used usually with nicknames, channel and server names to provide
- *    case insensitive keys.
+ *    this can be used to provide case-insensitive hashing.
  *
  ***/
 SilcUInt32 silc_hash_string(void *key, void *user_context);
@@ -251,8 +250,8 @@ SilcUInt32 silc_hash_data(void *key, void *user_context);
  *
  * DESCRIPTION
  *
- *    Compares two strings. It may be used as SilcHashTable comparison
- *    function.
+ *    Compares two strings. This ignores the case while comparing.  It may
+ *    be used as SilcHashTable comparison function.
  *
  ***/
 SilcBool silc_hash_string_compare(void *key1, void *key2, void *user_context);
@@ -449,4 +448,36 @@ char *silc_get_real_name();
 void silc_hexdump(const unsigned char *data, SilcUInt32 data_len,
                  FILE *output);
 
+/****f* silcutil/SilcUtilAPI/silc_hex2data
+ *
+ * SYNOPSIS
+ *
+ *    SilcBool silc_hex2data(const char *hex, unsigned char *data,
+ *                           SilcUInt32 data_size, SilcUInt32 *ret_data_len);
+ *
+ * DESCRIPTION
+ *
+ *    Converts HEX character string to binary data.  Each HEX numbers must
+ *    have two characters in the `hex' string.
+ *
+ ***/
+SilcBool silc_hex2data(const char *hex, unsigned char *data,
+                      SilcUInt32 data_size, SilcUInt32 *ret_data_len);
+
+/****f* silcutil/SilcUtilAPI/silc_data2hex
+ *
+ * SYNOPSIS
+ *
+ *    SilcBool silc_data2hex(const unsigned char *data, SilcUInt32 data_len,
+ *                           char *hex, SilcUInt32 hex_size);
+ *
+ * DESCRIPTION
+ *
+ *    Converts binary data to HEX string.  This NULL terminates the `hex'
+ *    buffer automatically.
+ *
+ ***/
+SilcBool silc_data2hex(const unsigned char *data, SilcUInt32 data_len,
+                      char *hex, SilcUInt32 hex_size);
+
 #endif /* !SILCUTIL_H */