<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="cutter-Assertions">
<refmeta>
<refentrytitle role="top_of_page" id="cutter-Assertions.top_of_page">Assertions</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  CUTTER Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Assertions</refname>
<refpurpose>Checks that your program works as you expect.</refpurpose>
</refnamediv>

<refsynopsisdiv id="cutter-Assertions.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis><link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert">cut_assert</link>                          (<parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> expression</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-equal">cut_assert_equal</link>                    (function,
                                                         expected,
                                                         actual,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-boolean">cut_assert_equal_boolean</link>            (<parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> expected</parameter>,
                                                         <parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-equal-char">cut_assert_equal_char</link>               (expected,
                                                         actual,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-double">cut_assert_equal_double</link>             (<parameter><link linkend="double"><type>double</type></link> expected</parameter>,
                                                         <parameter><link linkend="double"><type>double</type></link> error</parameter>,
                                                         <parameter><link linkend="double"><type>double</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-equal-file-raw">cut_assert_equal_file_raw</link>           (expected,
                                                         actual,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-fixture-data-string">cut_assert_equal_fixture_data_string</link>
                                                        (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="void"><type>void</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-int">cut_assert_equal_int</link>                (<parameter><link linkend="int"><type>int</type></link> expected</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-equal-int-fast16">cut_assert_equal_int_fast16</link>         (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-int-fast32">cut_assert_equal_int_fast32</link>         (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-int-fast64">cut_assert_equal_int_fast64</link>         (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-int-fast8">cut_assert_equal_int_fast8</link>          (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-int-least16">cut_assert_equal_int_least16</link>        (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-int-least32">cut_assert_equal_int_least32</link>        (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-int-least64">cut_assert_equal_int_least64</link>        (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-int-least8">cut_assert_equal_int_least8</link>         (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-intmax">cut_assert_equal_intmax</link>             (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-intptr">cut_assert_equal_intptr</link>             (expected,
                                                         actual,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-memory">cut_assert_equal_memory</link>             (<parameter>const <link linkend="void"><type>void</type></link> *expected</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> expected_size</parameter>,
                                                         <parameter>const <link linkend="void"><type>void</type></link> *actual</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> actual_size</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-pointer">cut_assert_equal_pointer</link>            (<parameter>const <link linkend="void"><type>void</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="void"><type>void</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-size">cut_assert_equal_size</link>               (<parameter><link linkend="size-t"><type>size_t</type></link> expected</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-equal-sockaddr">cut_assert_equal_sockaddr</link>           (expected,
                                                         actual,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-string">cut_assert_equal_string</link>             (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-string-array">cut_assert_equal_string_array</link>       (<parameter><link linkend="char"><type>char</type></link> **expected</parameter>,
                                                         <parameter><link linkend="char"><type>char</type></link> **actual</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-string-array-with-free">cut_assert_equal_string_array_with_free</link>
                                                        (<parameter><link linkend="char"><type>char</type></link> **expected</parameter>,
                                                         <parameter><link linkend="char"><type>char</type></link> **actual</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-string-or-null">cut_assert_equal_string_or_null</link>     (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-string-with-free">cut_assert_equal_string_with_free</link>   (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-substring">cut_assert_equal_substring</link>          (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> length</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-equal-uint">cut_assert_equal_uint</link>               (<parameter>unsigned <link linkend="int"><type>int</type></link> expected</parameter>,
                                                         <parameter>unsigned <link linkend="int"><type>int</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-equal-uint-fast16">cut_assert_equal_uint_fast16</link>        (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-uint-fast32">cut_assert_equal_uint_fast32</link>        (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-uint-fast64">cut_assert_equal_uint_fast64</link>        (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-uint-fast8">cut_assert_equal_uint_fast8</link>         (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-uint-least16">cut_assert_equal_uint_least16</link>       (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-uint-least32">cut_assert_equal_uint_least32</link>       (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-uint-least64">cut_assert_equal_uint_least64</link>       (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-uint-least8">cut_assert_equal_uint_least8</link>        (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-uintmax">cut_assert_equal_uintmax</link>            (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-equal-uintptr">cut_assert_equal_uintptr</link>            (expected,
                                                         actual,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-errno">cut_assert_errno</link>                    (<parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-exist-path">cut_assert_exist_path</link>               (<parameter>const <link linkend="char"><type>char</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-false">cut_assert_false</link>                    (<parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> expression</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-file-exist">cut_assert_file_exist</link>               (<parameter>const <link linkend="char"><type>char</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-match">cut_assert_match</link>                    (<parameter>const <link linkend="char"><type>char</type></link> *pattern</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-match-with-free">cut_assert_match_with_free</link>          (<parameter>const <link linkend="char"><type>char</type></link> *pattern</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-not-equal-boolean">cut_assert_not_equal_boolean</link>        (<parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> expected</parameter>,
                                                         <parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-not-equal-char">cut_assert_not_equal_char</link>           (expected,
                                                         actual,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-not-equal-double">cut_assert_not_equal_double</link>         (<parameter><link linkend="double"><type>double</type></link> expected</parameter>,
                                                         <parameter><link linkend="double"><type>double</type></link> error</parameter>,
                                                         <parameter><link linkend="double"><type>double</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-not-equal-file-raw">cut_assert_not_equal_file_raw</link>       (expected,
                                                         actual,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-not-equal-int">cut_assert_not_equal_int</link>            (<parameter><link linkend="int"><type>int</type></link> expected</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-not-equal-int-fast16">cut_assert_not_equal_int_fast16</link>     (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-int-fast32">cut_assert_not_equal_int_fast32</link>     (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-int-fast64">cut_assert_not_equal_int_fast64</link>     (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-int-fast8">cut_assert_not_equal_int_fast8</link>      (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-int-least16">cut_assert_not_equal_int_least16</link>    (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-int-least32">cut_assert_not_equal_int_least32</link>    (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-int-least64">cut_assert_not_equal_int_least64</link>    (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-int-least8">cut_assert_not_equal_int_least8</link>     (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-intmax">cut_assert_not_equal_intmax</link>         (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-intptr">cut_assert_not_equal_intptr</link>         (expected,
                                                         actual,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-not-equal-memory">cut_assert_not_equal_memory</link>         (<parameter>const <link linkend="void"><type>void</type></link> *expected</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> expected_size</parameter>,
                                                         <parameter>const <link linkend="void"><type>void</type></link> *actual</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> actual_size</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-not-equal-size">cut_assert_not_equal_size</link>           (<parameter><link linkend="size-t"><type>size_t</type></link> expected</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-not-equal-string">cut_assert_not_equal_string</link>         (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-not-equal-substring">cut_assert_not_equal_substring</link>      (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> length</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-not-equal-uint">cut_assert_not_equal_uint</link>           (<parameter>unsigned <link linkend="int"><type>int</type></link> expected</parameter>,
                                                         <parameter>unsigned <link linkend="int"><type>int</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-not-equal-uint-fast16">cut_assert_not_equal_uint_fast16</link>    (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-uint-fast32">cut_assert_not_equal_uint_fast32</link>    (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-uint-fast64">cut_assert_not_equal_uint_fast64</link>    (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-uint-fast8">cut_assert_not_equal_uint_fast8</link>     (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-uint-least16">cut_assert_not_equal_uint_least16</link>   (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-uint-least32">cut_assert_not_equal_uint_least32</link>   (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-uint-least64">cut_assert_not_equal_uint_least64</link>   (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-uint-least8">cut_assert_not_equal_uint_least8</link>    (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-uintmax">cut_assert_not_equal_uintmax</link>        (expected,
                                                         actual,
                                                         ...)
#define             <link linkend="cut-assert-not-equal-uintptr">cut_assert_not_equal_uintptr</link>        (expected,
                                                         actual,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-not-exist-path">cut_assert_not_exist_path</link>           (<parameter>const <link linkend="char"><type>char</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-not-null">cut_assert_not_null</link>                 (<parameter>const <link linkend="void"><type>void</type></link> *expression</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-null">cut_assert_null</link>                     (<parameter>const <link linkend="void"><type>void</type></link> *expression</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-null-string">cut_assert_null_string</link>              (<parameter>const <link linkend="char"><type>char</type></link> *string</parameter>,
                                                         <parameter>...</parameter>);
#define             <link linkend="cut-assert-operator">cut_assert_operator</link>                 (lhs,
                                                         operator,
                                                         rhs,
                                                         ...)
#define             <link linkend="cut-assert-operator-double">cut_assert_operator_double</link>          (lhs,
                                                         operator,
                                                         rhs,
                                                         ...)
#define             <link linkend="cut-assert-operator-int">cut_assert_operator_int</link>             (lhs,
                                                         operator,
                                                         rhs,
                                                         ...)
#define             <link linkend="cut-assert-operator-size">cut_assert_operator_size</link>            (lhs,
                                                         operator,
                                                         rhs,
                                                         ...)
#define             <link linkend="cut-assert-operator-uint">cut_assert_operator_uint</link>            (lhs,
                                                         operator,
                                                         rhs,
                                                         ...)
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-path-exist">cut_assert_path_exist</link>               (<parameter>const <link linkend="char"><type>char</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-path-not-exist">cut_assert_path_not_exist</link>           (<parameter>const <link linkend="char"><type>char</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-assert-true">cut_assert_true</link>                     (<parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> expression</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-error">cut_error</link>                           (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-error-errno">cut_error_errno</link>                     (<parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-fail">cut_fail</link>                            (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-notify">cut_notify</link>                          (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-omit">cut_omit</link>                            (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-pend">cut_pend</link>                            (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-pending">cut_pending</link>                         (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="cut-return">cut_return</link>                          (<parameter><type>void</type></parameter>);
</synopsis>
</refsynopsisdiv>

<refsect1 id="cutter-Assertions.description" role="desc">
<title role="desc.title">Description</title>
<para>
To check that your program works as you expect, you use
<link linkend="cut-assert-XXX"><function>cut_assert_XXX()</function></link> where you want to check expected value
is got.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_equal_int(3, 1 + 2);
</programlisting></informalexample>
</para>
</refsect1>
<refsect1 id="cutter-Assertions.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="cut-assert" role="function">
<title>cut_assert ()</title>
<indexterm zone="cut-assert"><primary>cut_assert</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert                          (<parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> expression</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expression</parameter> is not 0 or <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
</para>
<para>
e.g.:
<informalexample><programlisting>
char *string;
string = malloc(16);
cut_assert(string);
</programlisting></informalexample>
</para>
<para>
<informalexample><programlisting>
MyObject *object;
object = my_object_new();
cut_assert(object, cut_message("my_object_new() should not be failed"));
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>expression</parameter>&#160;:</term>
<listitem><simpara>the expression to be checked.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-equal" role="macro">
<title>cut_assert_equal()</title>
<indexterm zone="cut-assert-equal"><primary>cut_assert_equal</primary></indexterm>
<programlisting>#define             cut_assert_equal(function, expected, actual, ...)</programlisting>
<para>
Passes if <parameter>function</parameter>(<parameter>expected</parameter>, <parameter>actual</parameter>) returns <link linkend="CUT-TRUE:CAPS"><literal>CUT_TRUE</literal></link>.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_equal(!strcmp, "abc", "abc"); -> Pass
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>function</parameter>&#160;:</term>
<listitem><simpara>a function that compares <parameter>actual</parameter> with <parameter>expected</parameter>.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-equal-boolean" role="function" condition="since:1.0.7">
<title>cut_assert_equal_boolean ()</title>
<indexterm zone="cut-assert-equal-boolean" role="1.0.7"><primary>cut_assert_equal_boolean</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_boolean            (<parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> expected</parameter>,
                                                         <parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if both of <parameter>expected</parameter> and <parameter>actual</parameter> are <link linkend="CUT-TRUE:CAPS"><literal>CUT_TRUE</literal></link>
value or both of <parameter>expected</parameter> and <parameter>actual</parameter> are <link linkend="CUT-FALSE:CAPS"><literal>CUT_FALSE</literal></link>
value.
</para>
<para>
e.g.:
<informalexample><programlisting>
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
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>the expected boolean.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>the actual boolean.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.7</para></refsect2>
<refsect2 id="cut-assert-equal-char" role="macro" condition="since:1.1.3">
<title>cut_assert_equal_char()</title>
<indexterm zone="cut-assert-equal-char" role="1.1.3"><primary>cut_assert_equal_char</primary></indexterm>
<programlisting>#define             cut_assert_equal_char(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> ==  <parameter>actual</parameter>.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_equal_char('a', 'a'); -> Pass
cut_assert_equal_char('a', 'b'); -> Fail
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected char value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual char value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.3</para></refsect2>
<refsect2 id="cut-assert-equal-double" role="function">
<title>cut_assert_equal_double ()</title>
<indexterm zone="cut-assert-equal-double"><primary>cut_assert_equal_double</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_double             (<parameter><link linkend="double"><type>double</type></link> expected</parameter>,
                                                         <parameter><link linkend="double"><type>double</type></link> error</parameter>,
                                                         <parameter><link linkend="double"><type>double</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if (<parameter>expected</parameter> - <parameter>error</parameter>) &lt;= <parameter>actual</parameter> &lt;= (<parameter>expected</parameter> + <parameter>error</parameter>).
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected float value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>a float value that specifies error range.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual float value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-equal-file-raw" role="macro" condition="since:1.1.4">
<title>cut_assert_equal_file_raw()</title>
<indexterm zone="cut-assert-equal-file-raw" role="1.1.4"><primary>cut_assert_equal_file_raw</primary></indexterm>
<programlisting>#define             cut_assert_equal_file_raw(expected, actual, ...)</programlisting>
<para>
Passes if the content of <parameter>expected</parameter> == the content of <parameter>actual</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>a path.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>a path.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.4</para></refsect2>
<refsect2 id="cut-assert-equal-fixture-data-string" role="function" condition="since:1.0.2">
<title>cut_assert_equal_fixture_data_string ()</title>
<indexterm zone="cut-assert-equal-fixture-data-string" role="1.0.2"><primary>cut_assert_equal_fixture_data_string</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_fixture_data_string
                                                        (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="void"><type>void</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected</parameter> == cut_get_fixture_data_string(<parameter>path</parameter>, ...).
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected string.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara>a first element of the path to the fixture data.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>remaining elements in path. <link linkend="NULL:CAPS"><literal>NULL</literal></link> terminated.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.2</para></refsect2>
<refsect2 id="cut-assert-equal-int" role="function">
<title>cut_assert_equal_int ()</title>
<indexterm zone="cut-assert-equal-int"><primary>cut_assert_equal_int</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_int                (<parameter><link linkend="int"><type>int</type></link> expected</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-equal-int-fast16" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_int_fast16()</title>
<indexterm zone="cut-assert-equal-int-fast16" role="1.1.0"><primary>cut_assert_equal_int_fast16</primary></indexterm>
<programlisting>#define             cut_assert_equal_int_fast16(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-int-fast32" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_int_fast32()</title>
<indexterm zone="cut-assert-equal-int-fast32" role="1.1.0"><primary>cut_assert_equal_int_fast32</primary></indexterm>
<programlisting>#define             cut_assert_equal_int_fast32(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-int-fast64" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_int_fast64()</title>
<indexterm zone="cut-assert-equal-int-fast64" role="1.1.0"><primary>cut_assert_equal_int_fast64</primary></indexterm>
<programlisting>#define             cut_assert_equal_int_fast64(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-int-fast8" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_int_fast8()</title>
<indexterm zone="cut-assert-equal-int-fast8" role="1.1.0"><primary>cut_assert_equal_int_fast8</primary></indexterm>
<programlisting>#define             cut_assert_equal_int_fast8(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-int-least16" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_int_least16()</title>
<indexterm zone="cut-assert-equal-int-least16" role="1.1.0"><primary>cut_assert_equal_int_least16</primary></indexterm>
<programlisting>#define             cut_assert_equal_int_least16(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-int-least32" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_int_least32()</title>
<indexterm zone="cut-assert-equal-int-least32" role="1.1.0"><primary>cut_assert_equal_int_least32</primary></indexterm>
<programlisting>#define             cut_assert_equal_int_least32(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-int-least64" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_int_least64()</title>
<indexterm zone="cut-assert-equal-int-least64" role="1.1.0"><primary>cut_assert_equal_int_least64</primary></indexterm>
<programlisting>#define             cut_assert_equal_int_least64(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-int-least8" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_int_least8()</title>
<indexterm zone="cut-assert-equal-int-least8" role="1.1.0"><primary>cut_assert_equal_int_least8</primary></indexterm>
<programlisting>#define             cut_assert_equal_int_least8(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-intmax" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_intmax()</title>
<indexterm zone="cut-assert-equal-intmax" role="1.1.0"><primary>cut_assert_equal_intmax</primary></indexterm>
<programlisting>#define             cut_assert_equal_intmax(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-intptr" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_intptr()</title>
<indexterm zone="cut-assert-equal-intptr" role="1.1.0"><primary>cut_assert_equal_intptr</primary></indexterm>
<programlisting>#define             cut_assert_equal_intptr(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-memory" role="function">
<title>cut_assert_equal_memory ()</title>
<indexterm zone="cut-assert-equal-memory"><primary>cut_assert_equal_memory</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_memory             (<parameter>const <link linkend="void"><type>void</type></link> *expected</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> expected_size</parameter>,
                                                         <parameter>const <link linkend="void"><type>void</type></link> *actual</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> actual_size</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected_size</parameter> == <parameter>actual_size</parameter> and
memcmp(<parameter>expected</parameter>, <parameter>actual</parameter>, <parameter>expected_size</parameter>) == 0.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected data.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>expected_size</parameter>&#160;:</term>
<listitem><simpara>a size of <parameter>expected</parameter>.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual data.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual_size</parameter>&#160;:</term>
<listitem><simpara>a size of <parameter>actual</parameter>.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-equal-pointer" role="function" condition="since:1.0">
<title>cut_assert_equal_pointer ()</title>
<indexterm zone="cut-assert-equal-pointer" role="1.0"><primary>cut_assert_equal_pointer</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_pointer            (<parameter>const <link linkend="void"><type>void</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="void"><type>void</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected pointer.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual pointer.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0</para></refsect2>
<refsect2 id="cut-assert-equal-size" role="function" condition="since:1.0.6">
<title>cut_assert_equal_size ()</title>
<indexterm zone="cut-assert-equal-size" role="1.0.6"><primary>cut_assert_equal_size</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_size               (<parameter><link linkend="size-t"><type>size_t</type></link> expected</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected size_t value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual size_t value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.6</para></refsect2>
<refsect2 id="cut-assert-equal-sockaddr" role="macro" condition="since:1.1.1">
<title>cut_assert_equal_sockaddr()</title>
<indexterm zone="cut-assert-equal-sockaddr" role="1.1.1"><primary>cut_assert_equal_sockaddr</primary></indexterm>
<programlisting>#define             cut_assert_equal_sockaddr(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This assertion can be disabled by defining CUT_DISABLE_SOCKET_SUPPORT.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected socket address.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual socket address.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.1</para></refsect2>
<refsect2 id="cut-assert-equal-string" role="function">
<title>cut_assert_equal_string ()</title>
<indexterm zone="cut-assert-equal-string"><primary>cut_assert_equal_string</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_string             (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if both <parameter>expected</parameter> and <parameter>actual</parameter> are <link linkend="NULL:CAPS"><literal>NULL</literal></link> or
strcmp(<parameter>expected</parameter>, <parameter>actual</parameter>) == 0.
</para>
<para>
e.g.:
<informalexample><programlisting>
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
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-equal-string-array" role="function">
<title>cut_assert_equal_string_array ()</title>
<indexterm zone="cut-assert-equal-string-array"><primary>cut_assert_equal_string_array</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_string_array       (<parameter><link linkend="char"><type>char</type></link> **expected</parameter>,
                                                         <parameter><link linkend="char"><type>char</type></link> **actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if both <parameter>expected</parameter> and <parameter>actual</parameter> are not <link linkend="NULL:CAPS"><literal>NULL</literal></link> and
have same content (<link linkend="strcmp"><function>strcmp()</function></link> == 0) strings.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated array of strings.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated array of strings.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-equal-string-array-with-free" role="function" condition="since:0.9">
<title>cut_assert_equal_string_array_with_free ()</title>
<indexterm zone="cut-assert-equal-string-array-with-free" role="0.9"><primary>cut_assert_equal_string_array_with_free</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_string_array_with_free
                                                        (<parameter><link linkend="char"><type>char</type></link> **expected</parameter>,
                                                         <parameter><link linkend="char"><type>char</type></link> **actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if both <parameter>expected</parameter> and <parameter>actual</parameter> are not <link linkend="NULL:CAPS"><literal>NULL</literal></link> and
have same content (<link linkend="strcmp"><function>strcmp()</function></link> == 0) strings.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated array of strings.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated array of strings that are freed.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 0.9</para></refsect2>
<refsect2 id="cut-assert-equal-string-or-null" role="function" condition="deprecated:0.3: Use cut_assert_equal_string() instead.">
<title>cut_assert_equal_string_or_null ()</title>
<indexterm zone="cut-assert-equal-string-or-null" role="deprecated"><primary>cut_assert_equal_string_or_null</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_string_or_null     (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<warning><para><literal>cut_assert_equal_string_or_null</literal> has been deprecated since version 0.3 and should not be used in newly-written code. Use <link linkend="cut-assert-equal-string"><function>cut_assert_equal_string()</function></link> instead.</para></warning>
<variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-equal-string-with-free" role="function" condition="since:0.3">
<title>cut_assert_equal_string_with_free ()</title>
<indexterm zone="cut-assert-equal-string-with-free" role="0.3"><primary>cut_assert_equal_string_with_free</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_string_with_free   (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if both <parameter>expected</parameter> and <parameter>actual</parameter> are <link linkend="NULL:CAPS"><literal>NULL</literal></link> or
strcmp(<parameter>expected</parameter>, <parameter>actual</parameter>) == 0.
</para>
<para>
See also <link linkend="cut-assert-equal-string"><function>cut_assert_equal_string()</function></link> for examples.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual string value that is freed.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 0.3</para></refsect2>
<refsect2 id="cut-assert-equal-substring" role="function" condition="since:1.0.7">
<title>cut_assert_equal_substring ()</title>
<indexterm zone="cut-assert-equal-substring" role="1.0.7"><primary>cut_assert_equal_substring</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_substring          (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> length</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if (1) both <parameter>expected</parameter> and <parameter>actual</parameter> are <link linkend="NULL:CAPS"><literal>NULL</literal></link> and
<parameter>length</parameter> == 1 or (2) strncmp(<parameter>expected</parameter>, <parameter>actual</parameter>, <parameter>length</parameter>)
== 0.
</para>
<para>
e.g.:
<informalexample><programlisting>
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
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>length</parameter>&#160;:</term>
<listitem><simpara>compared string length.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.7</para></refsect2>
<refsect2 id="cut-assert-equal-uint" role="function">
<title>cut_assert_equal_uint ()</title>
<indexterm zone="cut-assert-equal-uint"><primary>cut_assert_equal_uint</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_equal_uint               (<parameter>unsigned <link linkend="int"><type>int</type></link> expected</parameter>,
                                                         <parameter>unsigned <link linkend="int"><type>int</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-equal-uint-fast16" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_uint_fast16()</title>
<indexterm zone="cut-assert-equal-uint-fast16" role="1.1.0"><primary>cut_assert_equal_uint_fast16</primary></indexterm>
<programlisting>#define             cut_assert_equal_uint_fast16(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-uint-fast32" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_uint_fast32()</title>
<indexterm zone="cut-assert-equal-uint-fast32" role="1.1.0"><primary>cut_assert_equal_uint_fast32</primary></indexterm>
<programlisting>#define             cut_assert_equal_uint_fast32(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-uint-fast64" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_uint_fast64()</title>
<indexterm zone="cut-assert-equal-uint-fast64" role="1.1.0"><primary>cut_assert_equal_uint_fast64</primary></indexterm>
<programlisting>#define             cut_assert_equal_uint_fast64(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-uint-fast8" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_uint_fast8()</title>
<indexterm zone="cut-assert-equal-uint-fast8" role="1.1.0"><primary>cut_assert_equal_uint_fast8</primary></indexterm>
<programlisting>#define             cut_assert_equal_uint_fast8(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-uint-least16" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_uint_least16()</title>
<indexterm zone="cut-assert-equal-uint-least16" role="1.1.0"><primary>cut_assert_equal_uint_least16</primary></indexterm>
<programlisting>#define             cut_assert_equal_uint_least16(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-uint-least32" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_uint_least32()</title>
<indexterm zone="cut-assert-equal-uint-least32" role="1.1.0"><primary>cut_assert_equal_uint_least32</primary></indexterm>
<programlisting>#define             cut_assert_equal_uint_least32(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-uint-least64" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_uint_least64()</title>
<indexterm zone="cut-assert-equal-uint-least64" role="1.1.0"><primary>cut_assert_equal_uint_least64</primary></indexterm>
<programlisting>#define             cut_assert_equal_uint_least64(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-uint-least8" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_uint_least8()</title>
<indexterm zone="cut-assert-equal-uint-least8" role="1.1.0"><primary>cut_assert_equal_uint_least8</primary></indexterm>
<programlisting>#define             cut_assert_equal_uint_least8(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-uintmax" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_uintmax()</title>
<indexterm zone="cut-assert-equal-uintmax" role="1.1.0"><primary>cut_assert_equal_uintmax</primary></indexterm>
<programlisting>#define             cut_assert_equal_uintmax(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-equal-uintptr" role="macro" condition="since:1.1.0">
<title>cut_assert_equal_uintptr()</title>
<indexterm zone="cut-assert-equal-uintptr" role="1.1.0"><primary>cut_assert_equal_uintptr</primary></indexterm>
<programlisting>#define             cut_assert_equal_uintptr(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> == <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-errno" role="function" condition="since:0.8">
<title>cut_assert_errno ()</title>
<indexterm zone="cut-assert-errno" role="0.8"><primary>cut_assert_errno</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_errno                    (<parameter>...</parameter>);</programlisting>
<para>
Passes if errno is 0.
</para>
<para>
e.g.:
<informalexample><programlisting>
count = write(stdout, buffer, strlen(buffer));
cut_assert_errno("Failed to write");            -> Pass when count != -1
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 0.8</para></refsect2>
<refsect2 id="cut-assert-exist-path" role="function" condition="since:1.1.5">
<title>cut_assert_exist_path ()</title>
<indexterm zone="cut-assert-exist-path" role="1.1.5"><primary>cut_assert_exist_path</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_exist_path               (<parameter>const <link linkend="char"><type>char</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>path</parameter> exists. It may or may not be a regular file.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_exist_path("/tmp");             -> Pass on many environment
cut_assert_exist_path("/non-existent");    -> Fail
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara>the path to test.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.5</para></refsect2>
<refsect2 id="cut-assert-false" role="function" condition="since:0.9">
<title>cut_assert_false ()</title>
<indexterm zone="cut-assert-false" role="0.9"><primary>cut_assert_false</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_false                    (<parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> expression</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expression</parameter> is 0 or <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>expression</parameter>&#160;:</term>
<listitem><simpara>the expression to be checked.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 0.9</para></refsect2>
<refsect2 id="cut-assert-file-exist" role="function" condition="deprecated:1.0.2: Use cut_assert_path_exist() instead.|since:0.9">
<title>cut_assert_file_exist ()</title>
<indexterm zone="cut-assert-file-exist" role="deprecated"><primary>cut_assert_file_exist</primary></indexterm><indexterm zone="cut-assert-file-exist" role="0.9"><primary>cut_assert_file_exist</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_file_exist               (<parameter>const <link linkend="char"><type>char</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<warning><para><literal>cut_assert_file_exist</literal> has been deprecated since version 1.0.2 and should not be used in newly-written code. Use <link linkend="cut-assert-path-exist"><function>cut_assert_path_exist()</function></link> instead.</para></warning>
<para>
Passes if <parameter>path</parameter> exists. It may or may not be a regular file.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_file_exist("/tmp");             -> Pass on many environment
cut_assert_file_exist("/non-existent");    -> Fail
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara>the path to test.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 0.9</para></refsect2>
<refsect2 id="cut-assert-match" role="function" condition="since:1.0">
<title>cut_assert_match ()</title>
<indexterm zone="cut-assert-match" role="1.0"><primary>cut_assert_match</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_match                    (<parameter>const <link linkend="char"><type>char</type></link> *pattern</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>pattern</parameter> matches <parameter>string</parameter>.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_match("^abc", "abc");            -> Pass
cut_assert_match("^abc", " abc");           -> Fail
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>pattern</parameter>&#160;:</term>
<listitem><simpara>the regular expression pattern.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>the string to be matched.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0</para></refsect2>
<refsect2 id="cut-assert-match-with-free" role="function" condition="since:1.0">
<title>cut_assert_match_with_free ()</title>
<indexterm zone="cut-assert-match-with-free" role="1.0"><primary>cut_assert_match_with_free</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_match_with_free          (<parameter>const <link linkend="char"><type>char</type></link> *pattern</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>pattern</parameter> matches <parameter>string</parameter>. See <link linkend="cut-assert-match"><function>cut_assert_match()</function></link>
for detail.
</para><variablelist role="params">
<varlistentry><term><parameter>pattern</parameter>&#160;:</term>
<listitem><simpara>the regular expression as string.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>the string to be matched that is freed.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-boolean" role="function" condition="since:1.0.7">
<title>cut_assert_not_equal_boolean ()</title>
<indexterm zone="cut-assert-not-equal-boolean" role="1.0.7"><primary>cut_assert_not_equal_boolean</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_not_equal_boolean        (<parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> expected</parameter>,
                                                         <parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected</parameter> is <link linkend="CUT-TRUE:CAPS"><literal>CUT_TRUE</literal></link> value
but <parameter>actual</parameter> is <link linkend="CUT-FALSE:CAPS"><literal>CUT_FALSE</literal></link> value or <parameter>expected</parameter> is
<link linkend="CUT-FALSE:CAPS"><literal>CUT_FALSE</literal></link> value but <parameter>actual</parameter> is <link linkend="CUT-TRUE:CAPS"><literal>CUT_TRUE</literal></link> value.
</para>
<para>
e.g.:
<informalexample><programlisting>
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
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>the expected boolean.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>the actual boolean.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.7</para></refsect2>
<refsect2 id="cut-assert-not-equal-char" role="macro" condition="since:1.1.3">
<title>cut_assert_not_equal_char()</title>
<indexterm zone="cut-assert-not-equal-char" role="1.1.3"><primary>cut_assert_not_equal_char</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_char(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_not_equal_char('a', 'b'); -> Pass
cut_assert_not_equal_char('a', 'a'); -> Fail
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected char value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual char value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.3</para></refsect2>
<refsect2 id="cut-assert-not-equal-double" role="function" condition="since:1.0.7">
<title>cut_assert_not_equal_double ()</title>
<indexterm zone="cut-assert-not-equal-double" role="1.0.7"><primary>cut_assert_not_equal_double</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_not_equal_double         (<parameter><link linkend="double"><type>double</type></link> expected</parameter>,
                                                         <parameter><link linkend="double"><type>double</type></link> error</parameter>,
                                                         <parameter><link linkend="double"><type>double</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>actual</parameter> &lt; (<parameter>expected</parameter> - <parameter>error</parameter>) &amp;&amp; (<parameter>expected</parameter> + <parameter>error</parameter>) &lt; <parameter>actual</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected float value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>a float value that specifies error range.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual float value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.7</para></refsect2>
<refsect2 id="cut-assert-not-equal-file-raw" role="macro" condition="since:1.1.4">
<title>cut_assert_not_equal_file_raw()</title>
<indexterm zone="cut-assert-not-equal-file-raw" role="1.1.4"><primary>cut_assert_not_equal_file_raw</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_file_raw(expected, actual, ...)</programlisting>
<para>
Passes if the content of <parameter>expected</parameter> != the content of <parameter>actual</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>a path.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>a path.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.4</para></refsect2>
<refsect2 id="cut-assert-not-equal-int" role="function" condition="since:1.0.7">
<title>cut_assert_not_equal_int ()</title>
<indexterm zone="cut-assert-not-equal-int" role="1.0.7"><primary>cut_assert_not_equal_int</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_not_equal_int            (<parameter><link linkend="int"><type>int</type></link> expected</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.7</para></refsect2>
<refsect2 id="cut-assert-not-equal-int-fast16" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_int_fast16()</title>
<indexterm zone="cut-assert-not-equal-int-fast16" role="1.1.0"><primary>cut_assert_not_equal_int_fast16</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_int_fast16(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-int-fast32" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_int_fast32()</title>
<indexterm zone="cut-assert-not-equal-int-fast32" role="1.1.0"><primary>cut_assert_not_equal_int_fast32</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_int_fast32(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-int-fast64" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_int_fast64()</title>
<indexterm zone="cut-assert-not-equal-int-fast64" role="1.1.0"><primary>cut_assert_not_equal_int_fast64</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_int_fast64(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-int-fast8" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_int_fast8()</title>
<indexterm zone="cut-assert-not-equal-int-fast8" role="1.1.0"><primary>cut_assert_not_equal_int_fast8</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_int_fast8(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-int-least16" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_int_least16()</title>
<indexterm zone="cut-assert-not-equal-int-least16" role="1.1.0"><primary>cut_assert_not_equal_int_least16</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_int_least16(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-int-least32" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_int_least32()</title>
<indexterm zone="cut-assert-not-equal-int-least32" role="1.1.0"><primary>cut_assert_not_equal_int_least32</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_int_least32(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-int-least64" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_int_least64()</title>
<indexterm zone="cut-assert-not-equal-int-least64" role="1.1.0"><primary>cut_assert_not_equal_int_least64</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_int_least64(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-int-least8" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_int_least8()</title>
<indexterm zone="cut-assert-not-equal-int-least8" role="1.1.0"><primary>cut_assert_not_equal_int_least8</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_int_least8(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-intmax" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_intmax()</title>
<indexterm zone="cut-assert-not-equal-intmax" role="1.1.0"><primary>cut_assert_not_equal_intmax</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_intmax(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-intptr" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_intptr()</title>
<indexterm zone="cut-assert-not-equal-intptr" role="1.1.0"><primary>cut_assert_not_equal_intptr</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_intptr(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-memory" role="function" condition="since:1.0.7">
<title>cut_assert_not_equal_memory ()</title>
<indexterm zone="cut-assert-not-equal-memory" role="1.0.7"><primary>cut_assert_not_equal_memory</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_not_equal_memory         (<parameter>const <link linkend="void"><type>void</type></link> *expected</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> expected_size</parameter>,
                                                         <parameter>const <link linkend="void"><type>void</type></link> *actual</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> actual_size</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected_size</parameter> != <parameter>actual_size</parameter> or
memcmp(<parameter>expected</parameter>, <parameter>actual</parameter>, <parameter>expected_size</parameter>) != 0.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected data.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>expected_size</parameter>&#160;:</term>
<listitem><simpara>a size of <parameter>expected</parameter>.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual data.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual_size</parameter>&#160;:</term>
<listitem><simpara>a size of <parameter>actual</parameter>.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.7</para></refsect2>
<refsect2 id="cut-assert-not-equal-size" role="function" condition="since:1.0.7">
<title>cut_assert_not_equal_size ()</title>
<indexterm zone="cut-assert-not-equal-size" role="1.0.7"><primary>cut_assert_not_equal_size</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_not_equal_size           (<parameter><link linkend="size-t"><type>size_t</type></link> expected</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected size_t value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual size_t value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.7</para></refsect2>
<refsect2 id="cut-assert-not-equal-string" role="function" condition="since:1.0.7">
<title>cut_assert_not_equal_string ()</title>
<indexterm zone="cut-assert-not-equal-string" role="1.0.7"><primary>cut_assert_not_equal_string</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_not_equal_string         (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if one of <parameter>expected</parameter> and <parameter>actual</parameter> is <link linkend="NULL:CAPS"><literal>NULL</literal></link> or
strcmp(<parameter>expected</parameter>, <parameter>actual</parameter>) != 0.
</para>
<para>
e.g.:
<informalexample><programlisting>
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
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.7</para></refsect2>
<refsect2 id="cut-assert-not-equal-substring" role="function" condition="since:1.0.7">
<title>cut_assert_not_equal_substring ()</title>
<indexterm zone="cut-assert-not-equal-substring" role="1.0.7"><primary>cut_assert_not_equal_substring</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_not_equal_substring      (<parameter>const <link linkend="char"><type>char</type></link> *expected</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *actual</parameter>,
                                                         <parameter><link linkend="size-t"><type>size_t</type></link> length</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if (1) one of <parameter>expected</parameter> and <parameter>actual</parameter> is <link linkend="NULL:CAPS"><literal>NULL</literal></link> or
(2) strncmp(<parameter>expected</parameter>, <parameter>actual</parameter>, <parameter>length</parameter>) != 0.
</para>
<para>
e.g.:
<informalexample><programlisting>
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
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual string value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>length</parameter>&#160;:</term>
<listitem><simpara>compared string length.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.7</para></refsect2>
<refsect2 id="cut-assert-not-equal-uint" role="function" condition="since:1.0.7">
<title>cut_assert_not_equal_uint ()</title>
<indexterm zone="cut-assert-not-equal-uint" role="1.0.7"><primary>cut_assert_not_equal_uint</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_not_equal_uint           (<parameter>unsigned <link linkend="int"><type>int</type></link> expected</parameter>,
                                                         <parameter>unsigned <link linkend="int"><type>int</type></link> actual</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.7</para></refsect2>
<refsect2 id="cut-assert-not-equal-uint-fast16" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_uint_fast16()</title>
<indexterm zone="cut-assert-not-equal-uint-fast16" role="1.1.0"><primary>cut_assert_not_equal_uint_fast16</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_uint_fast16(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-uint-fast32" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_uint_fast32()</title>
<indexterm zone="cut-assert-not-equal-uint-fast32" role="1.1.0"><primary>cut_assert_not_equal_uint_fast32</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_uint_fast32(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-uint-fast64" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_uint_fast64()</title>
<indexterm zone="cut-assert-not-equal-uint-fast64" role="1.1.0"><primary>cut_assert_not_equal_uint_fast64</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_uint_fast64(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-uint-fast8" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_uint_fast8()</title>
<indexterm zone="cut-assert-not-equal-uint-fast8" role="1.1.0"><primary>cut_assert_not_equal_uint_fast8</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_uint_fast8(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-uint-least16" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_uint_least16()</title>
<indexterm zone="cut-assert-not-equal-uint-least16" role="1.1.0"><primary>cut_assert_not_equal_uint_least16</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_uint_least16(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-uint-least32" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_uint_least32()</title>
<indexterm zone="cut-assert-not-equal-uint-least32" role="1.1.0"><primary>cut_assert_not_equal_uint_least32</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_uint_least32(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-uint-least64" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_uint_least64()</title>
<indexterm zone="cut-assert-not-equal-uint-least64" role="1.1.0"><primary>cut_assert_not_equal_uint_least64</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_uint_least64(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-uint-least8" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_uint_least8()</title>
<indexterm zone="cut-assert-not-equal-uint-least8" role="1.1.0"><primary>cut_assert_not_equal_uint_least8</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_uint_least8(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-uintmax" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_uintmax()</title>
<indexterm zone="cut-assert-not-equal-uintmax" role="1.1.0"><primary>cut_assert_not_equal_uintmax</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_uintmax(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-equal-uintptr" role="macro" condition="since:1.1.0">
<title>cut_assert_not_equal_uintptr()</title>
<indexterm zone="cut-assert-not-equal-uintptr" role="1.1.0"><primary>cut_assert_not_equal_uintptr</primary></indexterm>
<programlisting>#define             cut_assert_not_equal_uintptr(expected, actual, ...)</programlisting>
<para>
Passes if <parameter>expected</parameter> != <parameter>actual</parameter>.
</para>
<para>
This function is available only when
CUT_SUPPORT_C99_STDINT_TYPES is defined.
</para><variablelist role="params">
<varlistentry><term><parameter>expected</parameter>&#160;:</term>
<listitem><simpara>an expected unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actual</parameter>&#160;:</term>
<listitem><simpara>an actual unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.0</para></refsect2>
<refsect2 id="cut-assert-not-exist-path" role="function" condition="since:1.1.5">
<title>cut_assert_not_exist_path ()</title>
<indexterm zone="cut-assert-not-exist-path" role="1.1.5"><primary>cut_assert_not_exist_path</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_not_exist_path           (<parameter>const <link linkend="char"><type>char</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>path</parameter> doesn't exist.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_not_exist_path("/non-existent");    -> Pass on many environment
cut_assert_not_exist_path("/tmp");             -> Fail
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara>the path to test.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.1.5</para></refsect2>
<refsect2 id="cut-assert-not-null" role="function">
<title>cut_assert_not_null ()</title>
<indexterm zone="cut-assert-not-null"><primary>cut_assert_not_null</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_not_null                 (<parameter>const <link linkend="void"><type>void</type></link> *expression</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expression</parameter> is not <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>expression</parameter>&#160;:</term>
<listitem><simpara>the expression to be checked.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-null" role="function">
<title>cut_assert_null ()</title>
<indexterm zone="cut-assert-null"><primary>cut_assert_null</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_null                     (<parameter>const <link linkend="void"><type>void</type></link> *expression</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expression</parameter> is <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>expression</parameter>&#160;:</term>
<listitem><simpara>the expression to be checked.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-null-string" role="function" condition="since:0.3">
<title>cut_assert_null_string ()</title>
<indexterm zone="cut-assert-null-string" role="0.3"><primary>cut_assert_null_string</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_null_string              (<parameter>const <link linkend="char"><type>char</type></link> *string</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>string</parameter> is <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>string</parameter>&#160;:</term>
<listitem><simpara>the string to be checked.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 0.3</para></refsect2>
<refsect2 id="cut-assert-operator" role="macro">
<title>cut_assert_operator()</title>
<indexterm zone="cut-assert-operator"><primary>cut_assert_operator</primary></indexterm>
<programlisting>#define             cut_assert_operator(lhs, operator, rhs, ...)</programlisting>
<para>
Passes if (<parameter>lhs</parameter> <parameter>operator</parameter> <parameter>rhs</parameter>) is TRUE.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_operator(1, &lt;, 2) -> (1 &lt; 2);
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>lhs</parameter>&#160;:</term>
<listitem><simpara>a left hand side value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>operator</parameter>&#160;:</term>
<listitem><simpara>a binary operator.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>rhs</parameter>&#160;:</term>
<listitem><simpara>a right hand side value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-operator-double" role="macro" condition="since:1.0.5">
<title>cut_assert_operator_double()</title>
<indexterm zone="cut-assert-operator-double" role="1.0.5"><primary>cut_assert_operator_double</primary></indexterm>
<programlisting>#define             cut_assert_operator_double(lhs, operator, rhs, ...)</programlisting>
<para>
Passes if (<parameter>lhs</parameter> <parameter>operator</parameter> <parameter>rhs</parameter>) is TRUE.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_operator_double(1.1, &lt;, 2.2) -> (1.1 &lt; 2.2);
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>lhs</parameter>&#160;:</term>
<listitem><simpara>a left hand side double value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>operator</parameter>&#160;:</term>
<listitem><simpara>a binary operator.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>rhs</parameter>&#160;:</term>
<listitem><simpara>a right hand side double value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</para></refsect2>
<refsect2 id="cut-assert-operator-int" role="macro">
<title>cut_assert_operator_int()</title>
<indexterm zone="cut-assert-operator-int"><primary>cut_assert_operator_int</primary></indexterm>
<programlisting>#define             cut_assert_operator_int(lhs, operator, rhs, ...)</programlisting>
<para>
Passes if (<parameter>lhs</parameter> <parameter>operator</parameter> <parameter>rhs</parameter>) is TRUE.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_operator_int(1, &lt;, 2) -> (1 &lt; 2);
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>lhs</parameter>&#160;:</term>
<listitem><simpara>a left hand side integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>operator</parameter>&#160;:</term>
<listitem><simpara>a binary operator.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>rhs</parameter>&#160;:</term>
<listitem><simpara>a right hand side integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-assert-operator-size" role="macro" condition="since:1.0.5">
<title>cut_assert_operator_size()</title>
<indexterm zone="cut-assert-operator-size" role="1.0.5"><primary>cut_assert_operator_size</primary></indexterm>
<programlisting>#define             cut_assert_operator_size(lhs, operator, rhs, ...)</programlisting>
<para>
Passes if (<parameter>lhs</parameter> <parameter>operator</parameter> <parameter>rhs</parameter>) is TRUE.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_operator_size(1, &lt;, 2) -> (1 &lt; 2);
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>lhs</parameter>&#160;:</term>
<listitem><simpara>a left hand side size_t value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>operator</parameter>&#160;:</term>
<listitem><simpara>a binary operator.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>rhs</parameter>&#160;:</term>
<listitem><simpara>a right hand side size_t value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</para></refsect2>
<refsect2 id="cut-assert-operator-uint" role="macro" condition="since:1.0.5">
<title>cut_assert_operator_uint()</title>
<indexterm zone="cut-assert-operator-uint" role="1.0.5"><primary>cut_assert_operator_uint</primary></indexterm>
<programlisting>#define             cut_assert_operator_uint(lhs, operator, rhs, ...)</programlisting>
<para>
Passes if (<parameter>lhs</parameter> <parameter>operator</parameter> <parameter>rhs</parameter>) is TRUE.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_operator_uint(1, &lt;, 2) -> (1 &lt; 2);
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>lhs</parameter>&#160;:</term>
<listitem><simpara>a left hand side unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>operator</parameter>&#160;:</term>
<listitem><simpara>a binary operator.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>rhs</parameter>&#160;:</term>
<listitem><simpara>a right hand side unsigned integer value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</para></refsect2>
<refsect2 id="cut-assert-path-exist" role="function" condition="deprecated:1.1.5: Use cut_assert_exist_path() instead.|since:1.0.2">
<title>cut_assert_path_exist ()</title>
<indexterm zone="cut-assert-path-exist" role="deprecated"><primary>cut_assert_path_exist</primary></indexterm><indexterm zone="cut-assert-path-exist" role="1.0.2"><primary>cut_assert_path_exist</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_path_exist               (<parameter>const <link linkend="char"><type>char</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<warning><para><literal>cut_assert_path_exist</literal> has been deprecated since version 1.1.5 and should not be used in newly-written code. Use <link linkend="cut-assert-exist-path"><function>cut_assert_exist_path()</function></link> instead.</para></warning>
<para>
Passes if <parameter>path</parameter> exists. It may or may not be a regular file.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_path_exist("/tmp");             -> Pass on many environment
cut_assert_path_exist("/non-existent");    -> Fail
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara>the path to test.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.2</para></refsect2>
<refsect2 id="cut-assert-path-not-exist" role="function" condition="deprecated:1.1.5: Use cut_assert_not_exist_path() instead.|since:1.0.2">
<title>cut_assert_path_not_exist ()</title>
<indexterm zone="cut-assert-path-not-exist" role="deprecated"><primary>cut_assert_path_not_exist</primary></indexterm><indexterm zone="cut-assert-path-not-exist" role="1.0.2"><primary>cut_assert_path_not_exist</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_path_not_exist           (<parameter>const <link linkend="char"><type>char</type></link> *path</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<warning><para><literal>cut_assert_path_not_exist</literal> has been deprecated since version 1.1.5 and should not be used in newly-written code. Use <link linkend="cut-assert-not-exist-path"><function>cut_assert_not_exist_path()</function></link> instead.</para></warning>
<para>
Passes if <parameter>path</parameter> doesn't exist.
</para>
<para>
e.g.:
<informalexample><programlisting>
cut_assert_path_not_exist("/non-existent");    -> Pass on many environment
cut_assert_path_not_exist("/tmp");             -> Fail
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara>the path to test.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.2</para></refsect2>
<refsect2 id="cut-assert-true" role="function" condition="since:0.9">
<title>cut_assert_true ()</title>
<indexterm zone="cut-assert-true" role="0.9"><primary>cut_assert_true</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_assert_true                     (<parameter><link linkend="cut-boolean"><type>cut_boolean</type></link> expression</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Passes if <parameter>expression</parameter> is <link linkend="CUT-TRUE:CAPS"><literal>CUT_TRUE</literal></link> value (not 0 or <link linkend="NULL:CAPS"><literal>NULL</literal></link>).
</para><variablelist role="params">
<varlistentry><term><parameter>expression</parameter>&#160;:</term>
<listitem><simpara>the expression to be checked.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 0.9</para></refsect2>
<refsect2 id="cut-error" role="function">
<title>cut_error ()</title>
<indexterm zone="cut-error"><primary>cut_error</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_error                           (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Raises an error with message.
</para><variablelist role="params">
<varlistentry><term><parameter>format</parameter>&#160;:</term>
<listitem><simpara>the message format. See the <link linkend="printf"><function>printf()</function></link> documentation.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>the parameters to insert into the format string.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-error-errno" role="function" condition="since:1.0.2">
<title>cut_error_errno ()</title>
<indexterm zone="cut-error-errno" role="1.0.2"><primary>cut_error_errno</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_error_errno                     (<parameter>...</parameter>);</programlisting>
<para>
e.g.:
<informalexample><programlisting>
void
setup (void)
{
    mkdir("tmp", 0700);
    cut_error_errno("Failed to make tmp directory");
      -> Error when tmp directory isn't made successfully.
}
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>optional message. See <link linkend="cut-message"><function>cut_message()</function></link> for details.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.2</para></refsect2>
<refsect2 id="cut-fail" role="function">
<title>cut_fail ()</title>
<indexterm zone="cut-fail"><primary>cut_fail</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_fail                            (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Raises a failure with message.
</para><variablelist role="params">
<varlistentry><term><parameter>format</parameter>&#160;:</term>
<listitem><simpara>the message format. See the <link linkend="printf"><function>printf()</function></link> documentation.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>the parameters to insert into the format string.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-notify" role="function">
<title>cut_notify ()</title>
<indexterm zone="cut-notify"><primary>cut_notify</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_notify                          (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Leaves a notification message. The test is continued.
</para><variablelist role="params">
<varlistentry><term><parameter>format</parameter>&#160;:</term>
<listitem><simpara>the message format. See the <link linkend="printf"><function>printf()</function></link> documentation.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>the parameters to insert into the format string.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-omit" role="function" condition="since:0.8">
<title>cut_omit ()</title>
<indexterm zone="cut-omit" role="0.8"><primary>cut_omit</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_omit                            (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Omit the test.
</para>
<para>
e.g.:
<informalexample><programlisting>
if (version &lt; 2.0)
  cut_omit("Require &gt;= 2.0");
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>format</parameter>&#160;:</term>
<listitem><simpara>the message format. See the <link linkend="printf"><function>printf()</function></link> documentation.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>the parameters to insert into the format string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 0.8</para></refsect2>
<refsect2 id="cut-pend" role="function">
<title>cut_pend ()</title>
<indexterm zone="cut-pend"><primary>cut_pend</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_pend                            (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<para>
Marks the test is pending with message. The test is
stopped.
</para><variablelist role="params">
<varlistentry><term><parameter>format</parameter>&#160;:</term>
<listitem><simpara>the message format. See the <link linkend="printf"><function>printf()</function></link> documentation.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>the parameters to insert into the format string.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-pending" role="function" condition="deprecated:0.4: Use cut_pend() instead.">
<title>cut_pending ()</title>
<indexterm zone="cut-pending" role="deprecated"><primary>cut_pending</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_pending                         (<parameter>const <link linkend="char"><type>char</type></link> *format</parameter>,
                                                         <parameter>...</parameter>);</programlisting>
<warning><para><literal>cut_pending</literal> has been deprecated since version 0.4 and should not be used in newly-written code. Use <link linkend="cut-pend"><function>cut_pend()</function></link> instead.</para></warning>
<para>
Marks the test is pending with message. The test is
stopped.
</para><variablelist role="params">
<varlistentry><term><parameter>format</parameter>&#160;:</term>
<listitem><simpara>the message format. See the <link linkend="printf"><function>printf()</function></link> documentation.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara>the parameters to insert into the format string.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="cut-return" role="function" condition="since:1.0.6">
<title>cut_return ()</title>
<indexterm zone="cut-return" role="1.0.6"><primary>cut_return</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                cut_return                          (<parameter><type>void</type></parameter>);</programlisting>
<para>
Finish the test.
</para>
<para>
e.g.:
<informalexample><programlisting>
static void
sub_xxx (void)
{
  some_assertions();
  if (no_need_more_test)
    cut_return();
  some_assertions();
}

void
test_xxx (void)
{
   some_assertions();
   cut_trace(sub_xxx());
   some_assertions();
}
</programlisting></informalexample>
</para><para role="since">Since 1.0.6</para></refsect2>

</refsect1>

</refentry>
