Changeset 134ac5d in mainline for uspace/lib/pcut/src/internal.h

Timestamp:

2014-06-06T07:54:24Z (11 years ago)

Author:

Vojtech Horky <vojtechhorky@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

8db09e4

Parents:

eeb23f2d

Message:

Update PCUT to newest version

File:

• uspace/lib/pcut/src/internal.h (modified) (4 diffs)

uspace/lib/pcut/src/internal.h

@@ -27 +27 @@
  */
 
+/** @file
+ * Common definitions internally used in PCUT.
+ */
+
 #ifndef PCUT_INTERNAL_H_GUARD
 #define PCUT_INTERNAL_H_GUARD
 
-#include <pcut/test.h>
+#include <pcut/pcut.h>
 #include <stdlib.h>
 
@@ -69 +73 @@
 pcut_item_t *pcut_get_real_next(pcut_item_t *item);
 pcut_item_t *pcut_get_real(pcut_item_t *item);
-const char* pcut_run_test(pcut_test_func_t function);
-const char* pcut_run_setup_teardown(pcut_setup_func_t function);
 void pcut_print_tests(pcut_item_t *first);
 int pcut_is_arg_with_number(const char *arg, const char *opt, int *value);
@@ -78 +80 @@
 int pcut_run_test_single(pcut_item_t *test);
 
-extern pcut_item_t *pcut_current_test;
-extern pcut_item_t *pcut_current_suite;
-extern int pcut_running_test_now;
-extern int pcut_running_setup_now;
+int pcut_get_test_timeout(pcut_item_t *test);
 
+void pcut_failed_assertion(const char *message);
 void pcut_print_fail_message(const char *msg);
 
+/** Reporting callbacks structure. */
 typedef struct pcut_report_ops pcut_report_ops_t;
-/** Reporting callbacks structure. */
+
+/** @copydoc pcut_report_ops_t */
 struct pcut_report_ops {
         /** Initialize the reporting, given all tests. */
@@ -116 +118 @@
 void pcut_report_done(void);
 
+/* OS-dependent functions. */
 
+/** Tell whether two strings start with the same prefix.
+ *
+ * @param a First string.
+ * @param b Second string.
+ * @param len Length of common prefix.
+ * @return Whether first @p len characters of @p a are the same as in @p b.
+ */
 int pcut_str_start_equals(const char *a, const char *b, int len);
+
+/** Get size of string in bytes.
+ *
+ * @param s String in question.
+ * @return Size of @p s in bytes.
+ */
 int pcut_str_size(const char *s);
+
+/** Convert string to integer.
+ *
+ * @param s String with integer.
+ * @return Converted integer.
+ */
 int pcut_str_to_int(const char *s);
+
+/** Find character in a string.
+ *
+ * @param haystack Where to look for the @p needle.
+ * @param needle Character to find.
+ * @return String starting with @p needle.
+ * @retval NULL there is no @p needle in @p haystack.
+ */
 char *pcut_str_find_char(const char *haystack, const char needle);