![]() |
![]() |
![]() |
Cutter Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
void cut_assert (cut_boolean expression
,...
); #define cut_assert_equal (function, expected, actual, ...) void cut_assert_equal_boolean (cut_boolean expected
,cut_boolean actual
,...
); #define cut_assert_equal_char (expected, actual, ...) void cut_assert_equal_double (double expected
,double error
,double actual
,...
); #define cut_assert_equal_file_raw (expected, actual, ...) void cut_assert_equal_fixture_data_string (const char *expected
,const void *path
,...
); void cut_assert_equal_int (int expected
,int actual
,...
); #define cut_assert_equal_int_fast16 (expected, actual, ...) #define cut_assert_equal_int_fast32 (expected, actual, ...) #define cut_assert_equal_int_fast64 (expected, actual, ...) #define cut_assert_equal_int_fast8 (expected, actual, ...) #define cut_assert_equal_int_least16 (expected, actual, ...) #define cut_assert_equal_int_least32 (expected, actual, ...) #define cut_assert_equal_int_least64 (expected, actual, ...) #define cut_assert_equal_int_least8 (expected, actual, ...) #define cut_assert_equal_intmax (expected, actual, ...) #define cut_assert_equal_intptr (expected, actual, ...) void cut_assert_equal_memory (const void *expected
,size_t expected_size
,const void *actual
,size_t actual_size
,...
); void cut_assert_equal_pointer (const void *expected
,const void *actual
,...
); void cut_assert_equal_size (size_t expected
,size_t actual
,...
); #define cut_assert_equal_sockaddr (expected, actual, ...) void cut_assert_equal_string (const char *expected
,const char *actual
,...
); void cut_assert_equal_string_array (char **expected
,char **actual
,...
); void cut_assert_equal_string_array_with_free (char **expected
,char **actual
,...
); void cut_assert_equal_string_or_null (const char *expected
,const char *actual
,...
); void cut_assert_equal_string_with_free (const char *expected
,const char *actual
,...
); void cut_assert_equal_substring (const char *expected
,const char *actual
,size_t length
,...
); void cut_assert_equal_uint (unsigned int expected
,unsigned int actual
,...
); #define cut_assert_equal_uint_fast16 (expected, actual, ...) #define cut_assert_equal_uint_fast32 (expected, actual, ...) #define cut_assert_equal_uint_fast64 (expected, actual, ...) #define cut_assert_equal_uint_fast8 (expected, actual, ...) #define cut_assert_equal_uint_least16 (expected, actual, ...) #define cut_assert_equal_uint_least32 (expected, actual, ...) #define cut_assert_equal_uint_least64 (expected, actual, ...) #define cut_assert_equal_uint_least8 (expected, actual, ...) #define cut_assert_equal_uintmax (expected, actual, ...) #define cut_assert_equal_uintptr (expected, actual, ...) void cut_assert_errno (...
); void cut_assert_exist_path (const char *path
,...
); void cut_assert_false (cut_boolean expression
,...
); void cut_assert_file_exist (const char *path
,...
); void cut_assert_match (const char *pattern
,const char *actual
,...
); void cut_assert_match_with_free (const char *pattern
,const char *actual
,...
); void cut_assert_not_equal_boolean (cut_boolean expected
,cut_boolean actual
,...
); #define cut_assert_not_equal_char (expected, actual, ...) void cut_assert_not_equal_double (double expected
,double error
,double actual
,...
); #define cut_assert_not_equal_file_raw (expected, actual, ...) void cut_assert_not_equal_int (int expected
,int actual
,...
); #define cut_assert_not_equal_int_fast16 (expected, actual, ...) #define cut_assert_not_equal_int_fast32 (expected, actual, ...) #define cut_assert_not_equal_int_fast64 (expected, actual, ...) #define cut_assert_not_equal_int_fast8 (expected, actual, ...) #define cut_assert_not_equal_int_least16 (expected, actual, ...) #define cut_assert_not_equal_int_least32 (expected, actual, ...) #define cut_assert_not_equal_int_least64 (expected, actual, ...) #define cut_assert_not_equal_int_least8 (expected, actual, ...) #define cut_assert_not_equal_intmax (expected, actual, ...) #define cut_assert_not_equal_intptr (expected, actual, ...) void cut_assert_not_equal_memory (const void *expected
,size_t expected_size
,const void *actual
,size_t actual_size
,...
); void cut_assert_not_equal_size (size_t expected
,size_t actual
,...
); void cut_assert_not_equal_string (const char *expected
,const char *actual
,...
); void cut_assert_not_equal_substring (const char *expected
,const char *actual
,size_t length
,...
); void cut_assert_not_equal_uint (unsigned int expected
,unsigned int actual
,...
); #define cut_assert_not_equal_uint_fast16 (expected, actual, ...) #define cut_assert_not_equal_uint_fast32 (expected, actual, ...) #define cut_assert_not_equal_uint_fast64 (expected, actual, ...) #define cut_assert_not_equal_uint_fast8 (expected, actual, ...) #define cut_assert_not_equal_uint_least16 (expected, actual, ...) #define cut_assert_not_equal_uint_least32 (expected, actual, ...) #define cut_assert_not_equal_uint_least64 (expected, actual, ...) #define cut_assert_not_equal_uint_least8 (expected, actual, ...) #define cut_assert_not_equal_uintmax (expected, actual, ...) #define cut_assert_not_equal_uintptr (expected, actual, ...) void cut_assert_not_exist_path (const char *path
,...
); void cut_assert_not_null (const void *expression
,...
); void cut_assert_null (const void *expression
,...
); void cut_assert_null_string (const char *string
,...
); #define cut_assert_operator (lhs, operator, rhs, ...) #define cut_assert_operator_double (lhs, operator, rhs, ...) #define cut_assert_operator_int (lhs, operator, rhs, ...) #define cut_assert_operator_size (lhs, operator, rhs, ...) #define cut_assert_operator_uint (lhs, operator, rhs, ...) void cut_assert_path_exist (const char *path
,...
); void cut_assert_path_not_exist (const char *path
,...
); void cut_assert_true (cut_boolean expression
,...
); void cut_error (const char *format
,...
); void cut_error_errno (...
); void cut_fail (const char *format
,...
); void cut_notify (const char *format
,...
); void cut_omit (const char *format
,...
); void cut_pend (const char *format
,...
); void cut_pending (const char *format
,...
); void cut_return (void
);
To check that your program works as you expect, you use
cut_assert_XXX()
where you want to check expected value
is got.
e.g.:
cut_assert_equal_int(3, 1 + 2);
void cut_assert (cut_boolean expression
,...
);
Passes if expression
is not 0 or NULL
.
e.g.:
char *string; string = malloc(16); cut_assert(string);
MyObject *object; object = my_object_new(); cut_assert(object, cut_message("my_object_new() should not be failed"));
|
the expression to be checked. |
|
optional message. See cut_message() for details. |
#define cut_assert_equal(function, expected, actual, ...)
Passes if function
(expected
, actual
) returns CUT_TRUE
.
e.g.:
cut_assert_equal(!strcmp, "abc", "abc"); -> Pass
|
a function that compares actual with expected . |
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details. |
void cut_assert_equal_boolean (cut_boolean expected
,cut_boolean actual
,...
);
Passes if both of expected
and actual
are CUT_TRUE
value or both of expected
and actual
are CUT_FALSE
value.
e.g.:
cut_assert_equal_boolean(CUT_TRUE, CUT_TRUE); -> Pass cut_assert_equal_boolean(CUT_FALSE, CUT_FALSE); -> Pass cut_assert_equal_boolean(CUT_TRUE, CUT_FALSE); -> Fail
|
the expected boolean. |
|
the actual boolean. |
|
optional message. See cut_message() for details. |
Since 1.0.7
#define cut_assert_equal_char(expected, actual, ...)
Passes if expected
== actual
.
e.g.:
cut_assert_equal_char('a', 'a'); -> Pass cut_assert_equal_char('a', 'b'); -> Fail
|
an expected char value. |
|
an actual char value. |
|
optional message. See cut_message() for details. |
Since 1.1.3
void cut_assert_equal_double (double expected
,double error
,double actual
,...
);
Passes if (expected
- error
) <= actual
<= (expected
+ error
).
|
an expected float value. |
|
a float value that specifies error range. |
|
an actual float value. |
|
optional message. See cut_message() for details. |
#define cut_assert_equal_file_raw(expected, actual, ...)
Passes if the content of expected
== the content of actual
.
|
a path. |
|
a path. |
|
optional message. See cut_message() for details. |
Since 1.1.4
void cut_assert_equal_fixture_data_string (const char *expected
,const void *path
,...
);
Passes if expected
== cut_get_fixture_data_string(path
, ...).
|
an expected string. |
|
a first element of the path to the fixture data. |
|
remaining elements in path. NULL terminated. |
Since 1.0.2
void cut_assert_equal_int (int expected
,int actual
,...
);
Passes if expected
== actual
.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
#define cut_assert_equal_int_fast16(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_int_fast32(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_int_fast64(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_int_fast8(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_int_least16(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_int_least32(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_int_least64(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_int_least8(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_intmax(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_intptr(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
void cut_assert_equal_memory (const void *expected
,size_t expected_size
,const void *actual
,size_t actual_size
,...
);
Passes if expected_size
== actual_size
and
memcmp(expected
, actual
, expected_size
) == 0.
|
an expected data. |
|
a size of expected . |
|
an actual data. |
|
a size of actual . |
|
optional message. See cut_message() for details. |
void cut_assert_equal_pointer (const void *expected
,const void *actual
,...
);
Passes if expected
== actual
.
|
an expected pointer. |
|
an actual pointer. |
|
optional message. See cut_message() for details. |
Since 1.0
void cut_assert_equal_size (size_t expected
,size_t actual
,...
);
Passes if expected
== actual
.
|
an expected size_t value. |
|
an actual size_t value. |
|
optional message. See cut_message() for details. |
Since 1.0.6
#define cut_assert_equal_sockaddr(expected, actual, ...)
Passes if expected
== actual
.
This assertion can be disabled by defining CUT_DISABLE_SOCKET_SUPPORT.
|
an expected socket address. |
|
an actual socket address. |
|
optional message. See cut_message() for details. |
Since 1.1.1
void cut_assert_equal_string (const char *expected
,const char *actual
,...
);
Passes if both expected
and actual
are NULL
or
strcmp(expected
, actual
) == 0.
e.g.:
cut_assert_equal_string("abc", "abc"); -> Pass cut_assert_equal_string(NULL, NULL); -> Pass cut_assert_equal_string("abc", "ABC"); -> Fail cut_assert_equal_string("abc", NULL); -> Fail cut_assert_equal_string(NULL, "abc"); -> Fail
|
an expected string value. |
|
an actual string value. |
|
optional message. See cut_message() for details. |
void cut_assert_equal_string_array (char **expected
,char **actual
,...
);
Passes if both expected
and actual
are not NULL
and
have same content (strcmp()
== 0) strings.
|
an expected NULL -terminated array of strings. |
|
an actual NULL -terminated array of strings. |
|
optional message. See cut_message() for details. |
void cut_assert_equal_string_array_with_free (char **expected
,char **actual
,...
);
Passes if both expected
and actual
are not NULL
and
have same content (strcmp()
== 0) strings.
|
an expected NULL -terminated array of strings. |
|
an actual NULL -terminated array of strings that are freed. |
|
optional message. See cut_message() for details. |
Since 0.9
void cut_assert_equal_string_or_null (const char *expected
,const char *actual
,...
);
cut_assert_equal_string_or_null
has been deprecated since version 0.3 and should not be used in newly-written code. Use cut_assert_equal_string()
instead.
|
an expected string value. |
|
an actual string value. |
|
optional message. See cut_message() for details. |
void cut_assert_equal_string_with_free (const char *expected
,const char *actual
,...
);
Passes if both expected
and actual
are NULL
or
strcmp(expected
, actual
) == 0.
See also cut_assert_equal_string()
for examples.
|
an expected string value. |
|
an actual string value that is freed. |
|
optional message. See cut_message() for details. |
Since 0.3
void cut_assert_equal_substring (const char *expected
,const char *actual
,size_t length
,...
);
Passes if (1) both expected
and actual
are NULL
and
length
== 1 or (2) strncmp(expected
, actual
, length
)
== 0.
e.g.:
cut_assert_equal_substring("abcdef", "abcDEF", 3); -> Pass cut_assert_equal_substring(NULL, NULL, 0); -> Pass cut_assert_equal_substring(NULL, NULL, 3); -> Fail cut_assert_equal_substring("abc", "ABC", 3); -> Fail cut_assert_equal_substring("abc", NULL, 3); -> Fail cut_assert_equal_substring(NULL, "abc", 3); -> Fail
|
an expected string value. |
|
an actual string value. |
|
compared string length. |
|
optional message. See cut_message() for details. |
Since 1.0.7
void cut_assert_equal_uint (unsigned int expected
,unsigned int actual
,...
);
Passes if expected
== actual
.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
#define cut_assert_equal_uint_fast16(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_uint_fast32(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_uint_fast64(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_uint_fast8(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_uint_least16(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_uint_least32(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_uint_least64(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_uint_least8(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_uintmax(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_equal_uintptr(expected, actual, ...)
Passes if expected
== actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
void cut_assert_errno (...
);
Passes if errno is 0.
e.g.:
count = write(stdout, buffer, strlen(buffer)); cut_assert_errno("Failed to write"); -> Pass when count != -1
|
optional message. See cut_message() for details. |
Since 0.8
void cut_assert_exist_path (const char *path
,...
);
Passes if path
exists. It may or may not be a regular file.
e.g.:
cut_assert_exist_path("/tmp"); -> Pass on many environment cut_assert_exist_path("/non-existent"); -> Fail
|
the path to test. |
|
optional message. See cut_message() for details. |
Since 1.1.5
void cut_assert_false (cut_boolean expression
,...
);
Passes if expression
is 0 or NULL
.
|
the expression to be checked. |
|
optional message. See cut_message() for details. |
Since 0.9
void cut_assert_file_exist (const char *path
,...
);
cut_assert_file_exist
has been deprecated since version 1.0.2 and should not be used in newly-written code. Use cut_assert_path_exist()
instead.
Passes if path
exists. It may or may not be a regular file.
e.g.:
cut_assert_file_exist("/tmp"); -> Pass on many environment cut_assert_file_exist("/non-existent"); -> Fail
|
the path to test. |
|
optional message. See cut_message() for details. |
Since 0.9
void cut_assert_match (const char *pattern
,const char *actual
,...
);
Passes if pattern
matches string
.
e.g.:
cut_assert_match("^abc", "abc"); -> Pass cut_assert_match("^abc", " abc"); -> Fail
|
the regular expression pattern. |
|
the string to be matched. |
|
optional message. See cut_message() for details. |
Since 1.0
void cut_assert_match_with_free (const char *pattern
,const char *actual
,...
);
Passes if pattern
matches string
. See cut_assert_match()
for detail.
|
the regular expression as string. |
|
the string to be matched that is freed. |
|
optional message. See cut_message() for details. |
Since 1.0
void cut_assert_not_equal_boolean (cut_boolean expected
,cut_boolean actual
,...
);
Passes if expected
is CUT_TRUE
value
but actual
is CUT_FALSE
value or expected
is
CUT_FALSE
value but actual
is CUT_TRUE
value.
e.g.:
cut_assert_not_equal_boolean(CUT_TRUE, CUT_TRUE); -> Fail cut_assert_not_equal_boolean(CUT_FALSE, CUT_FALSE); -> Fail cut_assert_not_equal_boolean(CUT_TRUE, CUT_FALSE); -> Pass
|
the expected boolean. |
|
the actual boolean. |
|
optional message. See cut_message() for details. |
Since 1.0.7
#define cut_assert_not_equal_char(expected, actual, ...)
Passes if expected
!= actual
.
e.g.:
cut_assert_not_equal_char('a', 'b'); -> Pass cut_assert_not_equal_char('a', 'a'); -> Fail
|
an expected char value. |
|
an actual char value. |
|
optional message. See cut_message() for details. |
Since 1.1.3
void cut_assert_not_equal_double (double expected
,double error
,double actual
,...
);
Passes if actual
< (expected
- error
) && (expected
+ error
) < actual
.
|
an expected float value. |
|
a float value that specifies error range. |
|
an actual float value. |
|
optional message. See cut_message() for details. |
Since 1.0.7
#define cut_assert_not_equal_file_raw(expected, actual, ...)
Passes if the content of expected
!= the content of actual
.
|
a path. |
|
a path. |
|
optional message. See cut_message() for details. |
Since 1.1.4
void cut_assert_not_equal_int (int expected
,int actual
,...
);
Passes if expected
!= actual
.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.0.7
#define cut_assert_not_equal_int_fast16(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_int_fast32(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_int_fast64(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_int_fast8(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_int_least16(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_int_least32(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_int_least64(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_int_least8(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_intmax(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_intptr(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected integer value. |
|
an actual integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
void cut_assert_not_equal_memory (const void *expected
,size_t expected_size
,const void *actual
,size_t actual_size
,...
);
Passes if expected_size
!= actual_size
or
memcmp(expected
, actual
, expected_size
) != 0.
|
an expected data. |
|
a size of expected . |
|
an actual data. |
|
a size of actual . |
|
optional message. See cut_message() for details. |
Since 1.0.7
void cut_assert_not_equal_size (size_t expected
,size_t actual
,...
);
Passes if expected
!= actual
.
|
an expected size_t value. |
|
an actual size_t value. |
|
optional message. See cut_message() for details. |
Since 1.0.7
void cut_assert_not_equal_string (const char *expected
,const char *actual
,...
);
Passes if one of expected
and actual
is NULL
or
strcmp(expected
, actual
) != 0.
e.g.:
cut_assert_not_equal_string("abc", NULL); -> Pass cut_assert_not_equal_string(NULL, "abc"); -> Pass cut_assert_not_equal_string("abc", "ABC"); -> Pass cut_assert_not_equal_string("abc", "abc"); -> Fail cut_assert_not_equal_string(NULL, NULL); -> Fail
|
an expected string value. |
|
an actual string value. |
|
optional message. See cut_message() for details. |
Since 1.0.7
void cut_assert_not_equal_substring (const char *expected
,const char *actual
,size_t length
,...
);
Passes if (1) one of expected
and actual
is NULL
or
(2) strncmp(expected
, actual
, length
) != 0.
e.g.:
cut_assert_not_equal_substring("abc", "ABC", 3); -> Pass cut_assert_not_equal_substring("abc", NULL, 3); -> Pass cut_assert_not_equal_substring(NULL, "abc", 3); -> Pass cut_assert_not_equal_substring("abcdef", "abcDEF", 3); -> Fail cut_assert_not_equal_substring(NULL, NULL, 0); -> Fail cut_assert_not_equal_substring(NULL, NULL, 3); -> Fail
|
an expected string value. |
|
an actual string value. |
|
compared string length. |
|
optional message. See cut_message() for details. |
Since 1.0.7
void cut_assert_not_equal_uint (unsigned int expected
,unsigned int actual
,...
);
Passes if expected
!= actual
.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.0.7
#define cut_assert_not_equal_uint_fast16(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_uint_fast32(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_uint_fast64(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_uint_fast8(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_uint_least16(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_uint_least32(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_uint_least64(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_uint_least8(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_uintmax(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
#define cut_assert_not_equal_uintptr(expected, actual, ...)
Passes if expected
!= actual
.
This function is available only when CUT_SUPPORT_C99_STDINT_TYPES is defined.
|
an expected unsigned integer value. |
|
an actual unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.1.0
void cut_assert_not_exist_path (const char *path
,...
);
Passes if path
doesn't exist.
e.g.:
cut_assert_not_exist_path("/non-existent"); -> Pass on many environment cut_assert_not_exist_path("/tmp"); -> Fail
|
the path to test. |
|
optional message. See cut_message() for details. |
Since 1.1.5
void cut_assert_not_null (const void *expression
,...
);
Passes if expression
is not NULL
.
|
the expression to be checked. |
|
optional message. See cut_message() for details. |
void cut_assert_null (const void *expression
,...
);
Passes if expression
is NULL
.
|
the expression to be checked. |
|
optional message. See cut_message() for details. |
void cut_assert_null_string (const char *string
,...
);
Passes if string
is NULL
.
|
the string to be checked. |
|
optional message. See cut_message() for details. |
Since 0.3
#define cut_assert_operator(lhs, operator, rhs, ...)
Passes if (lhs
operator
rhs
) is TRUE.
e.g.:
cut_assert_operator(1, <, 2) -> (1 < 2);
|
a left hand side value. |
|
a binary operator. |
|
a right hand side value. |
|
optional message. See cut_message() for details. |
#define cut_assert_operator_double(lhs, operator, rhs, ...)
Passes if (lhs
operator
rhs
) is TRUE.
e.g.:
cut_assert_operator_double(1.1, <, 2.2) -> (1.1 < 2.2);
|
a left hand side double value. |
|
a binary operator. |
|
a right hand side double value. |
|
optional message. See cut_message() for details. |
Since 1.0.5
#define cut_assert_operator_int(lhs, operator, rhs, ...)
Passes if (lhs
operator
rhs
) is TRUE.
e.g.:
cut_assert_operator_int(1, <, 2) -> (1 < 2);
|
a left hand side integer value. |
|
a binary operator. |
|
a right hand side integer value. |
|
optional message. See cut_message() for details. |
#define cut_assert_operator_size(lhs, operator, rhs, ...)
Passes if (lhs
operator
rhs
) is TRUE.
e.g.:
cut_assert_operator_size(1, <, 2) -> (1 < 2);
|
a left hand side size_t value. |
|
a binary operator. |
|
a right hand side size_t value. |
|
optional message. See cut_message() for details. |
Since 1.0.5
#define cut_assert_operator_uint(lhs, operator, rhs, ...)
Passes if (lhs
operator
rhs
) is TRUE.
e.g.:
cut_assert_operator_uint(1, <, 2) -> (1 < 2);
|
a left hand side unsigned integer value. |
|
a binary operator. |
|
a right hand side unsigned integer value. |
|
optional message. See cut_message() for details. |
Since 1.0.5
void cut_assert_path_exist (const char *path
,...
);
cut_assert_path_exist
has been deprecated since version 1.1.5 and should not be used in newly-written code. Use cut_assert_exist_path()
instead.
Passes if path
exists. It may or may not be a regular file.
e.g.:
cut_assert_path_exist("/tmp"); -> Pass on many environment cut_assert_path_exist("/non-existent"); -> Fail
|
the path to test. |
|
optional message. See cut_message() for details. |
Since 1.0.2
void cut_assert_path_not_exist (const char *path
,...
);
cut_assert_path_not_exist
has been deprecated since version 1.1.5 and should not be used in newly-written code. Use cut_assert_not_exist_path()
instead.
Passes if path
doesn't exist.
e.g.:
cut_assert_path_not_exist("/non-existent"); -> Pass on many environment cut_assert_path_not_exist("/tmp"); -> Fail
|
the path to test. |
|
optional message. See cut_message() for details. |
Since 1.0.2
void cut_assert_true (cut_boolean expression
,...
);
Passes if expression
is CUT_TRUE
value (not 0 or NULL
).
|
the expression to be checked. |
|
optional message. See cut_message() for details. |
Since 0.9
void cut_error (const char *format
,...
);
Raises an error with message.
|
the message format. See the printf() documentation. |
|
the parameters to insert into the format string. |
void cut_error_errno (...
);
e.g.:
void setup (void) { mkdir("tmp", 0700); cut_error_errno("Failed to make tmp directory"); -> Error when tmp directory isn't made successfully. }
|
optional message. See cut_message() for details. |
Since 1.0.2
void cut_fail (const char *format
,...
);
Raises a failure with message.
|
the message format. See the printf() documentation. |
|
the parameters to insert into the format string. |
void cut_notify (const char *format
,...
);
Leaves a notification message. The test is continued.
|
the message format. See the printf() documentation. |
|
the parameters to insert into the format string. |
void cut_omit (const char *format
,...
);
Omit the test.
e.g.:
if (version < 2.0) cut_omit("Require >= 2.0");
|
the message format. See the printf() documentation. |
|
the parameters to insert into the format string. |
Since 0.8
void cut_pend (const char *format
,...
);
Marks the test is pending with message. The test is stopped.
|
the message format. See the printf() documentation. |
|
the parameters to insert into the format string. |
void cut_pending (const char *format
,...
);
cut_pending
has been deprecated since version 0.4 and should not be used in newly-written code. Use cut_pend()
instead.
Marks the test is pending with message. The test is stopped.
|
the message format. See the printf() documentation. |
|
the parameters to insert into the format string. |