<?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>

<refsynopsisdiv id="cutter-Assertion-Utilities-for-GList.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="gcut-list-equal">gcut_list_equal</link>                     (<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>);
<link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             <link linkend="gcut-list-inspect">gcut_list_inspect</link>                   (<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>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="gcut-list-equal-int">gcut_list_equal_int</link>                 (<parameter>const <link linkend="GList"><type>GList</type></link> *list1</parameter>,
                                                         <parameter>const <link linkend="GList"><type>GList</type></link> *list2</parameter>);
<link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             <link linkend="gcut-list-inspect-int">gcut_list_inspect_int</link>               (<parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="gcut-list-equal-uint">gcut_list_equal_uint</link>                (<parameter>const <link linkend="GList"><type>GList</type></link> *list1</parameter>,
                                                         <parameter>const <link linkend="GList"><type>GList</type></link> *list2</parameter>);
<link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             <link linkend="gcut-list-inspect-uint">gcut_list_inspect_uint</link>              (<parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="gcut-list-equal-string">gcut_list_equal_string</link>              (<parameter>const <link linkend="GList"><type>GList</type></link> *list1</parameter>,
                                                         <parameter>const <link linkend="GList"><type>GList</type></link> *list2</parameter>);
<link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             <link linkend="gcut-list-inspect-string">gcut_list_inspect_string</link>            (<parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);
<link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             <link linkend="gcut-list-inspect-object">gcut_list_inspect_object</link>            (<parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);
<link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             <link linkend="gcut-list-inspect-enum">gcut_list_inspect_enum</link>              (<parameter><link linkend="GType"><type>GType</type></link> type</parameter>,
                                                         <parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);
<link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             <link linkend="gcut-list-inspect-flags">gcut_list_inspect_flags</link>             (<parameter><link linkend="GType"><type>GType</type></link> type</parameter>,
                                                         <parameter>const <link linkend="GList"><type>GList</type></link> *list</parameter>);
#define             <link linkend="gcut-list-int-equal">gcut_list_int_equal</link>                 (list1,
                                                         list2)
#define             <link linkend="gcut-list-int-inspect">gcut_list_int_inspect</link>               (list)
#define             <link linkend="gcut-list-uint-equal">gcut_list_uint_equal</link>                (list1,
                                                         list2)
#define             <link linkend="gcut-list-uint-inspect">gcut_list_uint_inspect</link>              (list)
#define             <link linkend="gcut-list-string-equal">gcut_list_string_equal</link>              (list1,
                                                         list2)
#define             <link linkend="gcut-list-string-inspect">gcut_list_string_inspect</link>            (list)
#define             <link linkend="gcut-list-object-inspect">gcut_list_object_inspect</link>            (list)
#define             <link linkend="gcut-list-enum-inspect">gcut_list_enum_inspect</link>              (list,
                                                         type)
#define             <link linkend="gcut-list-flags-inspect">gcut_list_flags_inspect</link>             (list,
                                                         type)
</synopsis>
</refsynopsisdiv>

<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.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="gcut-list-equal" role="function" condition="since:1.0.5">
<title>gcut_list_equal ()</title>
<indexterm zone="gcut-list-equal" role="1.0.5"><primary>gcut_list_equal</primary></indexterm>
<programlisting><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.:
<informalexample><programlisting>
TODO
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>list1</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>list2</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>equal_func</parameter>&#160;:</term>
<listitem><simpara>a function that compares two values.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>TRUE if all corresponding values of <parameter>list1</parameter> and
<parameter>list2</parameter> are reported TRUE by <parameter>equal_func</parameter>, FALSE otherwise.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</para></refsect2>
<refsect2 id="gcut-list-inspect" role="function" condition="since:1.0.5">
<title>gcut_list_inspect ()</title>
<indexterm zone="gcut-list-inspect" role="1.0.5"><primary>gcut_list_inspect</primary></indexterm>
<programlisting><link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             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.:
<informalexample><programlisting>
TODO
</programlisting></informalexample>
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>inspect_func</parameter>&#160;:</term>
<listitem><simpara>a function that inspects each value.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data to pass to the function.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</para></refsect2>
<refsect2 id="gcut-list-equal-int" role="function" condition="since:1.0.6">
<title>gcut_list_equal_int ()</title>
<indexterm zone="gcut-list-equal-int" role="1.0.6"><primary>gcut_list_equal_int</primary></indexterm>
<programlisting><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><variablelist role="params">
<varlistentry><term><parameter>list1</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>list2</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>TRUE if all corresponding integers of <parameter>list1</parameter> and
<parameter>list2</parameter> are same value, FALSE otherwise.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.6</para></refsect2>
<refsect2 id="gcut-list-inspect-int" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_int ()</title>
<indexterm zone="gcut-list-inspect-int" role="1.0.6"><primary>gcut_list_inspect_int</primary></indexterm>
<programlisting><link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             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><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.6</para></refsect2>
<refsect2 id="gcut-list-equal-uint" role="function" condition="since:1.0.6">
<title>gcut_list_equal_uint ()</title>
<indexterm zone="gcut-list-equal-uint" role="1.0.6"><primary>gcut_list_equal_uint</primary></indexterm>
<programlisting><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><variablelist role="params">
<varlistentry><term><parameter>list1</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>list2</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>TRUE if all corresponding unsigned integers of
<parameter>list1</parameter> and <parameter>list2</parameter> are same value, FALSE otherwise.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.6</para></refsect2>
<refsect2 id="gcut-list-inspect-uint" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_uint ()</title>
<indexterm zone="gcut-list-inspect-uint" role="1.0.6"><primary>gcut_list_inspect_uint</primary></indexterm>
<programlisting><link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             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><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.6</para></refsect2>
<refsect2 id="gcut-list-equal-string" role="function" condition="since:1.0.6">
<title>gcut_list_equal_string ()</title>
<indexterm zone="gcut-list-equal-string" role="1.0.6"><primary>gcut_list_equal_string</primary></indexterm>
<programlisting><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><variablelist role="params">
<varlistentry><term><parameter>list1</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of string to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>list2</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of string to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>TRUE if all corresponding string of <parameter>list1</parameter> and
<parameter>list2</parameter> are same content string, FALSE otherwise.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.6</para></refsect2>
<refsect2 id="gcut-list-inspect-string" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_string ()</title>
<indexterm zone="gcut-list-inspect-string" role="1.0.6"><primary>gcut_list_inspect_string</primary></indexterm>
<programlisting><link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             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><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of string to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.6</para></refsect2>
<refsect2 id="gcut-list-inspect-object" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_object ()</title>
<indexterm zone="gcut-list-inspect-object" role="1.0.6"><primary>gcut_list_inspect_object</primary></indexterm>
<programlisting><link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             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><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="GObject"><type>GObject</type></link> to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.6</para></refsect2>
<refsect2 id="gcut-list-inspect-enum" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_enum ()</title>
<indexterm zone="gcut-list-inspect-enum" role="1.0.6"><primary>gcut_list_inspect_enum</primary></indexterm>
<programlisting><link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             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><variablelist role="params">
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GEnum"><type>GEnum</type></link> type.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of enum value to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.6</para></refsect2>
<refsect2 id="gcut-list-inspect-flags" role="function" condition="since:1.0.6">
<title>gcut_list_inspect_flags ()</title>
<indexterm zone="gcut-list-inspect-flags" role="1.0.6"><primary>gcut_list_inspect_flags</primary></indexterm>
<programlisting><link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             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><variablelist role="params">
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GFlags"><type>GFlags</type></link> type.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of flags value to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.6</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>#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. 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><variablelist role="params">
<varlistentry><term><parameter>list1</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>list2</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>TRUE if all corresponding integers of <parameter>list1</parameter> and
<parameter>list2</parameter> are same value, FALSE otherwise.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</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>#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. 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><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="gint"><type>gint</type></link> to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</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>#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. 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><variablelist role="params">
<varlistentry><term><parameter>list1</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>list2</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>TRUE if all corresponding unsigned integers of
<parameter>list1</parameter> and <parameter>list2</parameter> are same value, FALSE otherwise.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</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>#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. 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><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="guint"><type>guint</type></link> to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</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>#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. 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><variablelist role="params">
<varlistentry><term><parameter>list1</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of string to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>list2</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of string to be compared.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>TRUE if all corresponding string of <parameter>list1</parameter> and
<parameter>list2</parameter> are same content string, FALSE otherwise.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</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>#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. 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><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of string to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</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>#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. 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><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of <link linkend="GObject"><type>GObject</type></link> to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</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>#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. 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><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of enum value to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GEnum"><type>GEnum</type></link> type.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</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>#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. 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><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GList"><type>GList</type></link> of flags value to be inspected.</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GFlags"><type>GFlags</type></link> type.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>inspected <parameter>list</parameter> as a string.</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.0.5</para></refsect2>

</refsect1>

</refentry>
