Merge branch

[YACASL2.git] / include / hash.h

diff --git a/include/hash.h b/include/hash.h
index 16f02b2..817e8e9 100644 (file)
--- a/include/hash.h
+++ b/include/hash.h
@@ -1,17 +1,34 @@
-/* ハッシュ共用体の型 */
+#ifndef YACASL2_HASH_INCLUDED
+#define YACASL2_HASH_INCLUDED
+
+/**
+ * @brief ハッシュ共用体の数値
+ */
 typedef enum {
-    CHARS = 0,
-    INT = 1,
+    CHARS = 0,                  /**<char型のデータ */
+    INT = 1,                    /**<int型のデータ  */
 } UTYPE;
 
-/* ハッシュ共用体 */
+/**
+ * @brief ハッシュ共用体のデータ型
+ */
 typedef struct {
-    UTYPE type;
+    UTYPE type;                 /**<ハッシュ値の元データのデータ型 */
     union {
-        char *s;
-        int i;
-    } val;
+        char *s;                /**<char型のデータ */
+        int i;                  /**<int型のデータ */
+    } val;                      /**<ハッシュ値の元データ */
 } HKEY;
 
-/* ハッシュ値を取得する */
+/**
+ * @brief ハッシュ値を取得する
+ *
+ * @return ハッシュ値
+ *
+ * @param keyc キーの数
+ * @param *keyv[] キーを表す配列
+ * @param tabsize テーブルのサイズ
+ */
 unsigned hash(int keyc, HKEY *keyv[], int tabsize);
+
+#endif