started to add doxygen comments

diff --git a/source/string/str.h b/source/string/str.h
index e748bf27f7799c2d3e76ab86bd47f24a6291ee87..4d5354445cc2006729233333065281ae8d207e94 100644 (file)
--- a/source/string/str.h
+++ b/source/string/str.h
@@ -21,18 +21,37 @@ struct str_t;
 /** A safe string data structure */
 typedef struct str_t str_t;
 
+/**
+ * @brief Create a new string with the contents of the C style string.
+ *
+ * @param p_cstr The C string to copy.
+ *
+ * @return Pointer to the newly constructed string.
+ */
 str_t* str_new(const char* p_cstr);
+
 size_t str_size(str_t* p_str);
+
 const char* str_cstr(str_t* p_str);
+
 str_t* str_copy(str_t* p_str);
+
 char str_at(str_t* p_str, size_t index);
+
 str_t* str_set(str_t* p_str, size_t index, char val);
+
 str_t* str_concat(str_t* p_str1, str_t* p_str2);
+
 str_t* str_insert(str_t* p_str1, size_t index, str_t* p_str2);
+
 str_t* str_erase(str_t* p_str, size_t start, size_t end);
+
 str_t* str_substr(str_t* p_str, size_t start, size_t end);
+
 int str_compare(str_t* p_str1, str_t* p_str2);
+
 size_t str_find(str_t* p_str1, str_t* p_str2);
+
 size_t str_rfind(str_t* p_str1, str_t* p_str2);
 
 #ifdef __cplusplus

diff --git a/tests/test_str.c b/tests/test_str.c
index 5b32f2c6d156db8c9f4e021f8304df1f1708a535..084a6ad348932630bababe7cc7a90abf1e38c7c9 100644 (file)
--- a/tests/test_str.c
+++ b/tests/test_str.c
@@ -40,6 +40,7 @@ TEST_SUITE(String) {
         str_t* p_str2 = str_copy(p_str1);
         CHECK(p_str1 != p_str2);
         CHECK(0 == strcmp(str_cstr(p_str1), str_cstr(p_str2)));
+        CHECK(3 == str_size(p_str));
         mem_release(p_str1);
         mem_release(p_str2);
     }
@@ -77,8 +78,8 @@ TEST_SUITE(String) {
         str_t* p_str2 = str_set(p_str1, 2, 'd');
         CHECK(p_str1 != p_str2);
         CHECK(0 == strcmp(str_cstr(p_str1),"abc"));
-        CHECK(0 == strcmp(str_cstr(p_str2),"abd"));
         CHECK(3 == str_size(p_str1));
+        CHECK(0 == strcmp(str_cstr(p_str2),"abd"));
         CHECK(3 == str_size(p_str2));
         mem_release(p_str1);
         mem_release(p_str2);