<?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-Assertion-Utilities-for-GList">
<refmeta>
<refentrytitle role="top_of_page" id="cutter-Assertion-Utilities-for-GList.top_of_page">Assertion Utilities for GList</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>CUTTER Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Assertion Utilities for GList</refname>
<refpurpose>Utilities to write assertions related
to <link linkend="GList"><type>GList</type></link> more easily.</refpurpose>
</refnamediv>

<refsect1 id="cutter-Assertion-Utilities-for-GList.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_return" colwidth="150px"/>
<colspec colname="functions_name"/>
<tbody>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gcut-list-equal">gcut_list_equal</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gcut-list-inspect">gcut_list_inspect</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gcut-list-equal-int">gcut_list_equal_int</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gcut-list-inspect-int">gcut_list_inspect_int</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gcut-list-equal-uint">gcut_list_equal_uint</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gcut-list-inspect-uint">gcut_list_inspect_uint</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gcut-list-equal-string">gcut_list_equal_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gcut-list-inspect-string">gcut_list_inspect_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gcut-list-inspect-object">gcut_list_inspect_object</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gcut-list-inspect-enum">gcut_list_inspect_enum</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gcut-list-inspect-flags">gcut_list_inspect_flags</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gcut-list-int-equal">gcut_list_int_equal</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gcut-list-int-inspect">gcut_list_int_inspect</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gcut-list-uint-equal">gcut_list_uint_equal</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gcut-list-uint-inspect">gcut_list_uint_inspect</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gcut-list-string-equal">gcut_list_string_equal</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gcut-list-string-inspect">gcut_list_string_inspect</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gcut-list-object-inspect">gcut_list_object_inspect</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gcut-list-enum-inspect">gcut_list_enum_inspect</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gcut-list-flags-inspect">gcut_list_flags_inspect</link><phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>


<refsect1 id="cutter-Assertion-Utilities-for-GList.description" role="desc">
<title role="desc.title">Description</title>
<para>To write assertions, you need to check equality and show
expected and actual values.</para>
<para>The utilities help you to write assertions that are
related to <link linkend="GList"><type>GList</type></link>.</para>

</refsect1>
<refsect1 id="cutter-Assertion-Utilities-for-GList.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gcut-list-equal" role="function" condition="since:1.0.5">
<title>gcut_list_equal&#160;()</title>
<indexterm zone="gcut-list-equal" role="1.0.5"><primary>gcut_list_equal</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gcut_list_equal (<parameter>const <link linkend="GList"><type>GList</type></link> *list1</parameter>,
                 <parameter>const <link linkend="GList"><type>GList</type></link> *list2</parameter>,
                 <parameter><link linkend="GEqualFunc"><type>GEqualFunc</type></link> equal_func</parameter>);</programlisting>
<para>Compares two <link linkend="GList"><type>GList</type></link>, <parameter>list1</parameter>
 and <parameter>list2</parameter>
. <parameter>equal_func</parameter>
 is
called for each corresponding values of <parameter>list1</parameter>
 and <parameter>list2</parameter>
.</para>
<para>e.g.:</para>
<informalexample><programlisting><![CDATA[
TODO
]]></programlisting></informalexample>
<para></para>
<refsect3 id="gcut-list-equal.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list1</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>list2</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>equal_func</para></entry>
<entry role="parameter_description"><para>a function that compares two values.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-equal.returns" role="returns">
<title>Returns</title>
<para> TRUE if all corresponding values of <parameter>list1</parameter>
and
<parameter>list2</parameter>
are reported TRUE by <parameter>equal_func</parameter>
, FALSE otherwise.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>
<refsect2 id="gcut-list-inspect" role="function" condition="since:1.0.5">
<title>gcut_list_inspect&#160;()</title>
<indexterm zone="gcut-list-inspect" role="1.0.5"><primary>gcut_list_inspect</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gcut_list_inspect (<parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>,
                   <parameter><link linkend="GCutInspectFunction"><type>GCutInspectFunction</type></link> inspect_func</parameter>,
                   <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);</programlisting>
<para>Inspects <parameter>list</parameter>
. Each value of <parameter>list</parameter>
 is inspected by
<parameter>inspect_func</parameter>
. The returned string should be freed when
no longer needed.</para>
<para>e.g.:</para>
<informalexample><programlisting><![CDATA[
TODO
]]></programlisting></informalexample>
<para></para>
<refsect3 id="gcut-list-inspect.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>inspect_func</para></entry>
<entry role="parameter_description"><para>a function that inspects each value.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>user data to pass to the function.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-inspect.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>
<refsect2 id="gcut-list-equal-int" role="function" condition="since:1.0.6">
<title>gcut_list_equal_int&#160;()</title>
<indexterm zone="gcut-list-equal-int" role="1.0.6"><primary>gcut_list_equal_int</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gcut_list_equal_int (<parameter>const <link linkend="GList"><type>GList</type></link> *list1</parameter>,
                     <parameter>const <link linkend="GList"><type>GList</type></link> *list2</parameter>);</programlisting>
<para>Compares two <link linkend="GList"><type>GList</type></link>, <parameter>list1</parameter>
 and <parameter>list2</parameter>
. <parameter>list1</parameter>
 and <parameter>list2</parameter>

should be <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link>.</para>
<refsect3 id="gcut-list-equal-int.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list1</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>list2</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-equal-int.returns" role="returns">
<title>Returns</title>
<para> TRUE if all corresponding integers of <parameter>list1</parameter>
and
<parameter>list2</parameter>
are same value, FALSE otherwise.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.6">1.0.6</link></para></refsect2>
<refsect2 id="gcut-list-inspect-int" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_int&#160;()</title>
<indexterm zone="gcut-list-inspect-int" role="1.0.6"><primary>gcut_list_inspect_int</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gcut_list_inspect_int (<parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);</programlisting>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link>. The
returned string should be freed when no longer needed.</para>
<refsect3 id="gcut-list-inspect-int.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-inspect-int.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.6">1.0.6</link></para></refsect2>
<refsect2 id="gcut-list-equal-uint" role="function" condition="since:1.0.6">
<title>gcut_list_equal_uint&#160;()</title>
<indexterm zone="gcut-list-equal-uint" role="1.0.6"><primary>gcut_list_equal_uint</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gcut_list_equal_uint (<parameter>const <link linkend="GList"><type>GList</type></link> *list1</parameter>,
                      <parameter>const <link linkend="GList"><type>GList</type></link> *list2</parameter>);</programlisting>
<para>Compares two <link linkend="GList"><type>GList</type></link>, <parameter>list1</parameter>
 and <parameter>list2</parameter>
. <parameter>list1</parameter>
 and <parameter>list2</parameter>

should be <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link>.</para>
<refsect3 id="gcut-list-equal-uint.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list1</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>list2</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-equal-uint.returns" role="returns">
<title>Returns</title>
<para> TRUE if all corresponding unsigned integers of
<parameter>list1</parameter>
and <parameter>list2</parameter>
are same value, FALSE otherwise.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.6">1.0.6</link></para></refsect2>
<refsect2 id="gcut-list-inspect-uint" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_uint&#160;()</title>
<indexterm zone="gcut-list-inspect-uint" role="1.0.6"><primary>gcut_list_inspect_uint</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gcut_list_inspect_uint (<parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);</programlisting>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link>. The
returned string should be freed when no longer needed.</para>
<refsect3 id="gcut-list-inspect-uint.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-inspect-uint.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.6">1.0.6</link></para></refsect2>
<refsect2 id="gcut-list-equal-string" role="function" condition="since:1.0.6">
<title>gcut_list_equal_string&#160;()</title>
<indexterm zone="gcut-list-equal-string" role="1.0.6"><primary>gcut_list_equal_string</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gcut_list_equal_string (<parameter>const <link linkend="GList"><type>GList</type></link> *list1</parameter>,
                        <parameter>const <link linkend="GList"><type>GList</type></link> *list2</parameter>);</programlisting>
<para>Compares two <link linkend="GList"><type>GList</type></link>, <parameter>list1</parameter>
 and <parameter>list2</parameter>
. <parameter>list1</parameter>
 and <parameter>list2</parameter>

should be <link linkend="GList"><type>GList</type></link> of string.</para>
<refsect3 id="gcut-list-equal-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list1</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of string to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>list2</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of string to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-equal-string.returns" role="returns">
<title>Returns</title>
<para> TRUE if all corresponding string of <parameter>list1</parameter>
and
<parameter>list2</parameter>
are same content string, FALSE otherwise.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.6">1.0.6</link></para></refsect2>
<refsect2 id="gcut-list-inspect-string" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_string&#160;()</title>
<indexterm zone="gcut-list-inspect-string" role="1.0.6"><primary>gcut_list_inspect_string</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gcut_list_inspect_string (<parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);</programlisting>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of string. The
returned string should be freed when no longer needed.</para>
<refsect3 id="gcut-list-inspect-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of string to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-inspect-string.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.6">1.0.6</link></para></refsect2>
<refsect2 id="gcut-list-inspect-object" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_object&#160;()</title>
<indexterm zone="gcut-list-inspect-object" role="1.0.6"><primary>gcut_list_inspect_object</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gcut_list_inspect_object (<parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);</programlisting>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of <link linkend="GObject"><type>GObject</type></link>. The
returned string should be freed when no longer needed.</para>
<refsect3 id="gcut-list-inspect-object.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="GObject"><type>GObject</type></link> to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-inspect-object.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.6">1.0.6</link></para></refsect2>
<refsect2 id="gcut-list-inspect-enum" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_enum&#160;()</title>
<indexterm zone="gcut-list-inspect-enum" role="1.0.6"><primary>gcut_list_inspect_enum</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gcut_list_inspect_enum (<parameter><link linkend="GType"><type>GType</type></link> type</parameter>,
                        <parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);</programlisting>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of enum value of
<link linkend="GEnum"><type>GEnum</type></link>. The returned string should be freed when no
longer needed.</para>
<refsect3 id="gcut-list-inspect-enum.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>a <link linkend="GEnum"><type>GEnum</type></link> type.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of enum value to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-inspect-enum.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.6">1.0.6</link></para></refsect2>
<refsect2 id="gcut-list-inspect-flags" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_flags&#160;()</title>
<indexterm zone="gcut-list-inspect-flags" role="1.0.6"><primary>gcut_list_inspect_flags</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gcut_list_inspect_flags (<parameter><link linkend="GType"><type>GType</type></link> type</parameter>,
                         <parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);</programlisting>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of flags value of
<link linkend="GFlags"><type>GFlags</type></link>. The returned string should be freed when no
longer needed.</para>
<refsect3 id="gcut-list-inspect-flags.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>a <link linkend="GFlags"><type>GFlags</type></link> type.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of flags value to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-inspect-flags.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.6">1.0.6</link></para></refsect2>
<refsect2 id="gcut-list-int-equal" role="macro" condition="deprecated:1.0.6: Use gcut_list_equal_int() instead.|since:1.0.5">
<title>gcut_list_int_equal()</title>
<indexterm zone="gcut-list-int-equal" role="deprecated"><primary>gcut_list_int_equal</primary></indexterm><indexterm zone="gcut-list-int-equal" role="1.0.5"><primary>gcut_list_int_equal</primary></indexterm>
<programlisting language="C">#define             gcut_list_int_equal(list1, list2)</programlisting>
<warning><para><literal>gcut_list_int_equal</literal> has been deprecated since version 1.0.6 and should not be used in newly-written code.</para> <para>Use <link linkend="gcut-list-equal-int"><function>gcut_list_equal_int()</function></link> instead.</para>
</warning>
<para>Compares two <link linkend="GList"><type>GList</type></link>, <parameter>list1</parameter>
 and <parameter>list2</parameter>
. <parameter>list1</parameter>
 and <parameter>list2</parameter>

should be <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link>.</para>
<refsect3 id="gcut-list-int-equal.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list1</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>list2</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-int-equal.returns" role="returns">
<title>Returns</title>
<para> TRUE if all corresponding integers of <parameter>list1</parameter>
and
<parameter>list2</parameter>
are same value, FALSE otherwise.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>
<refsect2 id="gcut-list-int-inspect" role="macro" condition="deprecated:1.0.6: Use gcut_list_inspect_int() instead.|since:1.0.5">
<title>gcut_list_int_inspect()</title>
<indexterm zone="gcut-list-int-inspect" role="deprecated"><primary>gcut_list_int_inspect</primary></indexterm><indexterm zone="gcut-list-int-inspect" role="1.0.5"><primary>gcut_list_int_inspect</primary></indexterm>
<programlisting language="C">#define             gcut_list_int_inspect(list)</programlisting>
<warning><para><literal>gcut_list_int_inspect</literal> has been deprecated since version 1.0.6 and should not be used in newly-written code.</para> <para>Use <link linkend="gcut-list-inspect-int"><function>gcut_list_inspect_int()</function></link> instead.</para>
</warning>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link>. The
returned string should be freed when no longer needed.</para>
<refsect3 id="gcut-list-int-inspect.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-int-inspect.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>
<refsect2 id="gcut-list-uint-equal" role="macro" condition="deprecated:1.0.6: Use gcut_list_equal_uint() instead.|since:1.0.5">
<title>gcut_list_uint_equal()</title>
<indexterm zone="gcut-list-uint-equal" role="deprecated"><primary>gcut_list_uint_equal</primary></indexterm><indexterm zone="gcut-list-uint-equal" role="1.0.5"><primary>gcut_list_uint_equal</primary></indexterm>
<programlisting language="C">#define             gcut_list_uint_equal(list1, list2)</programlisting>
<warning><para><literal>gcut_list_uint_equal</literal> has been deprecated since version 1.0.6 and should not be used in newly-written code.</para> <para>Use <link linkend="gcut-list-equal-uint"><function>gcut_list_equal_uint()</function></link> instead.</para>
</warning>
<para>Compares two <link linkend="GList"><type>GList</type></link>, <parameter>list1</parameter>
 and <parameter>list2</parameter>
. <parameter>list1</parameter>
 and <parameter>list2</parameter>

should be <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link>.</para>
<refsect3 id="gcut-list-uint-equal.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list1</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>list2</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-uint-equal.returns" role="returns">
<title>Returns</title>
<para> TRUE if all corresponding unsigned integers of
<parameter>list1</parameter>
and <parameter>list2</parameter>
are same value, FALSE otherwise.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>
<refsect2 id="gcut-list-uint-inspect" role="macro" condition="deprecated:1.0.6: Use gcut_list_inspect_uint() instead.|since:1.0.5">
<title>gcut_list_uint_inspect()</title>
<indexterm zone="gcut-list-uint-inspect" role="deprecated"><primary>gcut_list_uint_inspect</primary></indexterm><indexterm zone="gcut-list-uint-inspect" role="1.0.5"><primary>gcut_list_uint_inspect</primary></indexterm>
<programlisting language="C">#define             gcut_list_uint_inspect(list)</programlisting>
<warning><para><literal>gcut_list_uint_inspect</literal> has been deprecated since version 1.0.6 and should not be used in newly-written code.</para> <para>Use <link linkend="gcut-list-inspect-uint"><function>gcut_list_inspect_uint()</function></link> instead.</para>
</warning>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link>. The
returned string should be freed when no longer needed.</para>
<refsect3 id="gcut-list-uint-inspect.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-uint-inspect.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>
<refsect2 id="gcut-list-string-equal" role="macro" condition="deprecated:1.0.6: Use gcut_list_equal_string() instead.|since:1.0.5">
<title>gcut_list_string_equal()</title>
<indexterm zone="gcut-list-string-equal" role="deprecated"><primary>gcut_list_string_equal</primary></indexterm><indexterm zone="gcut-list-string-equal" role="1.0.5"><primary>gcut_list_string_equal</primary></indexterm>
<programlisting language="C">#define             gcut_list_string_equal(list1, list2)</programlisting>
<warning><para><literal>gcut_list_string_equal</literal> has been deprecated since version 1.0.6 and should not be used in newly-written code.</para> <para>Use <link linkend="gcut-list-equal-string"><function>gcut_list_equal_string()</function></link> instead.</para>
</warning>
<para>Compares two <link linkend="GList"><type>GList</type></link>, <parameter>list1</parameter>
 and <parameter>list2</parameter>
. <parameter>list1</parameter>
 and <parameter>list2</parameter>

should be <link linkend="GList"><type>GList</type></link> of string.</para>
<refsect3 id="gcut-list-string-equal.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list1</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of string to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>list2</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of string to be compared.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-string-equal.returns" role="returns">
<title>Returns</title>
<para> TRUE if all corresponding string of <parameter>list1</parameter>
and
<parameter>list2</parameter>
are same content string, FALSE otherwise.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>
<refsect2 id="gcut-list-string-inspect" role="macro" condition="deprecated:1.0.6: Use gcut_list_inspect_string() instead.|since:1.0.5">
<title>gcut_list_string_inspect()</title>
<indexterm zone="gcut-list-string-inspect" role="deprecated"><primary>gcut_list_string_inspect</primary></indexterm><indexterm zone="gcut-list-string-inspect" role="1.0.5"><primary>gcut_list_string_inspect</primary></indexterm>
<programlisting language="C">#define             gcut_list_string_inspect(list)</programlisting>
<warning><para><literal>gcut_list_string_inspect</literal> has been deprecated since version 1.0.6 and should not be used in newly-written code.</para> <para>Use <link linkend="gcut-list-inspect-string"><function>gcut_list_inspect_string()</function></link> instead.</para>
</warning>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of string. The
returned string should be freed when no longer needed.</para>
<refsect3 id="gcut-list-string-inspect.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of string to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-string-inspect.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>
<refsect2 id="gcut-list-object-inspect" role="macro" condition="deprecated:1.0.6: Use gcut_list_inspect_object() instead.|since:1.0.5">
<title>gcut_list_object_inspect()</title>
<indexterm zone="gcut-list-object-inspect" role="deprecated"><primary>gcut_list_object_inspect</primary></indexterm><indexterm zone="gcut-list-object-inspect" role="1.0.5"><primary>gcut_list_object_inspect</primary></indexterm>
<programlisting language="C">#define             gcut_list_object_inspect(list)</programlisting>
<warning><para><literal>gcut_list_object_inspect</literal> has been deprecated since version 1.0.6 and should not be used in newly-written code.</para> <para>Use <link linkend="gcut-list-inspect-object"><function>gcut_list_inspect_object()</function></link> instead.</para>
</warning>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of <link linkend="GObject"><type>GObject</type></link>. The
returned string should be freed when no longer needed.</para>
<refsect3 id="gcut-list-object-inspect.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of <link linkend="GObject"><type>GObject</type></link> to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-object-inspect.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>
<refsect2 id="gcut-list-enum-inspect" role="macro" condition="deprecated:1.0.6: Use gcut_list_inspect_enum() instead.|since:1.0.5">
<title>gcut_list_enum_inspect()</title>
<indexterm zone="gcut-list-enum-inspect" role="deprecated"><primary>gcut_list_enum_inspect</primary></indexterm><indexterm zone="gcut-list-enum-inspect" role="1.0.5"><primary>gcut_list_enum_inspect</primary></indexterm>
<programlisting language="C">#define             gcut_list_enum_inspect(list, type)</programlisting>
<warning><para><literal>gcut_list_enum_inspect</literal> has been deprecated since version 1.0.6 and should not be used in newly-written code.</para> <para>Use <link linkend="gcut-list-inspect-enum"><function>gcut_list_inspect_enum()</function></link> instead.</para>
</warning>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of enum value of
<link linkend="GEnum"><type>GEnum</type></link>. The returned string should be freed when no
longer needed.</para>
<refsect3 id="gcut-list-enum-inspect.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of enum value to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>a <link linkend="GEnum"><type>GEnum</type></link> type.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-enum-inspect.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>
<refsect2 id="gcut-list-flags-inspect" role="macro" condition="deprecated:1.0.6: Use gcut_list_inspect_flags() instead.|since:1.0.5">
<title>gcut_list_flags_inspect()</title>
<indexterm zone="gcut-list-flags-inspect" role="deprecated"><primary>gcut_list_flags_inspect</primary></indexterm><indexterm zone="gcut-list-flags-inspect" role="1.0.5"><primary>gcut_list_flags_inspect</primary></indexterm>
<programlisting language="C">#define             gcut_list_flags_inspect(list, type)</programlisting>
<warning><para><literal>gcut_list_flags_inspect</literal> has been deprecated since version 1.0.6 and should not be used in newly-written code.</para> <para>Use <link linkend="gcut-list-inspect-flags"><function>gcut_list_inspect_flags()</function></link> instead.</para>
</warning>
<para>Inspects <parameter>list</parameter>
. <parameter>list</parameter>
 should be <link linkend="GList"><type>GList</type></link> of flags value of
<link linkend="GFlags"><type>GFlags</type></link>. The returned string should be freed when no
longer needed.</para>
<refsect3 id="gcut-list-flags-inspect.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>list</para></entry>
<entry role="parameter_description"><para>a <link linkend="GList"><type>GList</type></link> of flags value to be inspected.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>a <link linkend="GFlags"><type>GFlags</type></link> type.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gcut-list-flags-inspect.returns" role="returns">
<title>Returns</title>
<para> inspected <parameter>list</parameter>
as a string.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0.5">1.0.5</link></para></refsect2>

</refsect1>
<refsect1 id="cutter-Assertion-Utilities-for-GList.other_details" role="details">
<title role="details.title">Types and Values</title>

</refsect1>

</refentry>
