From: Brian Norris <banorris@uci.edu>
Date: Sat, 11 Aug 2012 01:11:12 +0000 (-0700)
Subject: hashtable: document get_safe_ptr()
X-Git-Url: http://demsky.eecs.uci.edu/git/?a=commitdiff_plain;h=9e438bd5e9eec9cc1fb9d158f394f8998fd10cf2;p=c11tester.git

hashtable: document get_safe_ptr()
---

diff --git a/hashtable.h b/hashtable.h
index b4054ec8..8302000b 100644
--- a/hashtable.h
+++ b/hashtable.h
@@ -152,7 +152,16 @@ template<typename _Key, typename _Val, typename _KeyInt, int _Shift=0, void * (*
 		size++;
 	}
 
-	/** Put a key entry into the table. */
+	/**
+	 * @brief Get a valid pointer to a value corresponding to a given key
+	 *
+	 * Ensure that key is present in the hash table, then return a pointer
+	 * to its value bin. This may require either creating a new bin for
+	 * this key (with a default-constructed value) or simply locating and
+	 * returning a pointer to an existing value.
+	 * @param key The key to check
+	 * @return A pointer to the value in the table
+	 */
 	_Val * get_safe_ptr(_Key key) {
 		if (size > threshold)
 			resize(capacity << 1);