<refentry id="InternetAddressList">
<refmeta>
<refentrytitle role="top_of_page" id="InternetAddressList.top_of_page">InternetAddressList</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  GMIME Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>InternetAddressList</refname>
<refpurpose>A list of internet addresses</refpurpose>
</refnamediv>

<refsynopsisdiv id="InternetAddressList.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>                    <link linkend="InternetAddressList-struct">InternetAddressList</link>;
<link linkend="InternetAddressList"><returnvalue>InternetAddressList</returnvalue></link> * <link linkend="internet-address-list-new">internet_address_list_new</link>         (<parameter><type>void</type></parameter>);
<link linkend="int"><returnvalue>int</returnvalue></link>                 <link linkend="internet-address-list-length">internet_address_list_length</link>        (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="internet-address-list-clear">internet_address_list_clear</link>         (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>);
<link linkend="int"><returnvalue>int</returnvalue></link>                 <link linkend="internet-address-list-add">internet_address_list_add</link>           (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="internet-address-list-insert">internet_address_list_insert</link>        (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="internet-address-list-remove">internet_address_list_remove</link>        (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="internet-address-list-remove-at">internet_address_list_remove_at</link>     (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="internet-address-list-contains">internet_address_list_contains</link>      (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);
<link linkend="int"><returnvalue>int</returnvalue></link>                 <link linkend="internet-address-list-index-of">internet_address_list_index_of</link>      (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);
<link linkend="InternetAddress"><returnvalue>InternetAddress</returnvalue></link> *   <link linkend="internet-address-list-get-address">internet_address_list_get_address</link>   (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="internet-address-list-set-address">internet_address_list_set_address</link>   (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="internet-address-list-prepend">internet_address_list_prepend</link>       (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *prepend</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="internet-address-list-append">internet_address_list_append</link>        (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *append</parameter>);
<link linkend="char"><returnvalue>char</returnvalue></link> *              <link linkend="internet-address-list-to-string">internet_address_list_to_string</link>     (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="gboolean"><type>gboolean</type></link> encode</parameter>);
<link linkend="InternetAddressList"><returnvalue>InternetAddressList</returnvalue></link> * <link linkend="internet-address-list-parse-string">internet_address_list_parse_string</link>
                                                        (<parameter>const <link linkend="char"><type>char</type></link> *str</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="internet-address-list-writer">internet_address_list_writer</link>        (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GString"><type>GString</type></link> *str</parameter>);
</synopsis>
</refsynopsisdiv>
<refsect1 id="InternetAddressList.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----InternetAddressList
</synopsis>
</refsect1>

<refsect1 id="InternetAddressList.description" role="desc">
<title role="desc.title">Description</title>
<para>
An <link linkend="InternetAddressList"><type>InternetAddressList</type></link> is a collection of <link linkend="InternetAddress"><type>InternetAddress</type></link>
objects.
</para>
</refsect1>
<refsect1 id="InternetAddressList.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="InternetAddressList-struct" role="struct">
<title>InternetAddressList</title>
<indexterm zone="InternetAddressList-struct"><primary>InternetAddressList</primary></indexterm>
<programlisting>typedef struct _InternetAddressList InternetAddressList;</programlisting>
<para>
A collection of <link linkend="InternetAddress"><type>InternetAddress</type></link> objects.
</para><variablelist role="struct">
</variablelist></refsect2>
<refsect2 id="internet-address-list-new" role="function">
<title>internet_address_list_new ()</title>
<indexterm zone="internet-address-list-new"><primary>internet_address_list_new</primary></indexterm>
<programlisting><link linkend="InternetAddressList"><returnvalue>InternetAddressList</returnvalue></link> * internet_address_list_new         (<parameter><type>void</type></parameter>);</programlisting>
<para>
Creates a new <link linkend="InternetAddressList"><type>InternetAddressList</type></link>.
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="InternetAddressList"><type>InternetAddressList</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-length" role="function">
<title>internet_address_list_length ()</title>
<indexterm zone="internet-address-list-length"><primary>internet_address_list_length</primary></indexterm>
<programlisting><link linkend="int"><returnvalue>int</returnvalue></link>                 internet_address_list_length        (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>);</programlisting>
<para>
Gets the length of the list.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the number of <link linkend="InternetAddress"><type>InternetAddress</type></link> objects in the list.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-clear" role="function">
<title>internet_address_list_clear ()</title>
<indexterm zone="internet-address-list-clear"><primary>internet_address_list_clear</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                internet_address_list_clear         (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>);</programlisting>
<para>
Clears the list of addresses.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-add" role="function">
<title>internet_address_list_add ()</title>
<indexterm zone="internet-address-list-add"><primary>internet_address_list_add</primary></indexterm>
<programlisting><link linkend="int"><returnvalue>int</returnvalue></link>                 internet_address_list_add           (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);</programlisting>
<para>
Adds an <link linkend="InternetAddress"><type>InternetAddress</type></link> to the <link linkend="InternetAddressList"><type>InternetAddressList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ia</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddress"><type>InternetAddress</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the index of the added <link linkend="InternetAddress"><type>InternetAddress</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-insert" role="function">
<title>internet_address_list_insert ()</title>
<indexterm zone="internet-address-list-insert"><primary>internet_address_list_insert</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                internet_address_list_insert        (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);</programlisting>
<para>
Inserts an <link linkend="InternetAddress"><type>InternetAddress</type></link> into the <link linkend="InternetAddressList"><type>InternetAddressList</type></link> at the
specified index.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index to insert at
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ia</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddress"><type>InternetAddress</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-remove" role="function">
<title>internet_address_list_remove ()</title>
<indexterm zone="internet-address-list-remove"><primary>internet_address_list_remove</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            internet_address_list_remove        (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);</programlisting>
<para>
Removes an <link linkend="InternetAddress"><type>InternetAddress</type></link> from the <link linkend="InternetAddressList"><type>InternetAddressList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ia</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddress"><type>InternetAddress</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the specified <link linkend="InternetAddress"><type>InternetAddress</type></link> was removed or
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-remove-at" role="function">
<title>internet_address_list_remove_at ()</title>
<indexterm zone="internet-address-list-remove-at"><primary>internet_address_list_remove_at</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            internet_address_list_remove_at     (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);</programlisting>
<para>
Removes an <link linkend="InternetAddress"><type>InternetAddress</type></link> from the <link linkend="InternetAddressList"><type>InternetAddressList</type></link> at the
specified index.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index to remove
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if an <link linkend="InternetAddress"><type>InternetAddress</type></link> was removed or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>
otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-contains" role="function">
<title>internet_address_list_contains ()</title>
<indexterm zone="internet-address-list-contains"><primary>internet_address_list_contains</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            internet_address_list_contains      (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);</programlisting>
<para>
Checks whether or not the specified <link linkend="InternetAddress"><type>InternetAddress</type></link> is contained
within the <link linkend="InternetAddressList"><type>InternetAddressList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ia</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddress"><type>InternetAddress</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the specified <link linkend="InternetAddress"><type>InternetAddress</type></link> is contained
within the specified <link linkend="InternetAddressList"><type>InternetAddressList</type></link> or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-index-of" role="function">
<title>internet_address_list_index_of ()</title>
<indexterm zone="internet-address-list-index-of"><primary>internet_address_list_index_of</primary></indexterm>
<programlisting><link linkend="int"><returnvalue>int</returnvalue></link>                 internet_address_list_index_of      (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);</programlisting>
<para>
Gets the index of the specified <link linkend="InternetAddress"><type>InternetAddress</type></link> inside the
<link linkend="InternetAddressList"><type>InternetAddressList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ia</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddress"><type>InternetAddress</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the index of the requested <link linkend="InternetAddress"><type>InternetAddress</type></link> within the
<link linkend="InternetAddressList"><type>InternetAddressList</type></link> or <link linkend="1:CAPS"><literal>-1</literal></link> if it is not contained within the
<link linkend="InternetAddressList"><type>InternetAddressList</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-get-address" role="function">
<title>internet_address_list_get_address ()</title>
<indexterm zone="internet-address-list-get-address"><primary>internet_address_list_get_address</primary></indexterm>
<programlisting><link linkend="InternetAddress"><returnvalue>InternetAddress</returnvalue></link> *   internet_address_list_get_address   (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);</programlisting>
<para>
Gets the <link linkend="InternetAddress"><type>InternetAddress</type></link> at the specified index.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index of <link linkend="InternetAddress"><type>InternetAddress</type></link> to get
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the <link linkend="InternetAddress"><type>InternetAddress</type></link> at the specified index or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if
the index is out of range.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-set-address" role="function">
<title>internet_address_list_set_address ()</title>
<indexterm zone="internet-address-list-set-address"><primary>internet_address_list_set_address</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                internet_address_list_set_address   (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="InternetAddress"><type>InternetAddress</type></link> *ia</parameter>);</programlisting>
<para>
Sets the <link linkend="InternetAddress"><type>InternetAddress</type></link> at the specified index to <parameter>ia</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index of <link linkend="InternetAddress"><type>InternetAddress</type></link> to set
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ia</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddress"><type>InternetAddress</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-prepend" role="function">
<title>internet_address_list_prepend ()</title>
<indexterm zone="internet-address-list-prepend"><primary>internet_address_list_prepend</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                internet_address_list_prepend       (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *prepend</parameter>);</programlisting>
<para>
Inserts all of the addresses in <parameter>prepend</parameter> to the beginning of <parameter>list</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>prepend</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-append" role="function">
<title>internet_address_list_append ()</title>
<indexterm zone="internet-address-list-append"><primary>internet_address_list_append</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                internet_address_list_append        (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *append</parameter>);</programlisting>
<para>
Adds all of the addresses in <parameter>append</parameter> to <parameter>list</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>append</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="InternetAddressList"><type>InternetAddressList</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-to-string" role="function">
<title>internet_address_list_to_string ()</title>
<indexterm zone="internet-address-list-to-string"><primary>internet_address_list_to_string</primary></indexterm>
<programlisting><link linkend="char"><returnvalue>char</returnvalue></link> *              internet_address_list_to_string     (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="gboolean"><type>gboolean</type></link> encode</parameter>);</programlisting>
<para>
Allocates a string buffer containing the rfc822 formatted addresses
in <parameter>list</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>list of internet addresses
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>encode</parameter>&#160;:</term>
<listitem><simpara><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the address should be rfc2047 encoded
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a string containing the list of addresses in rfc822 format
or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if no addresses are contained in the list.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-parse-string" role="function">
<title>internet_address_list_parse_string ()</title>
<indexterm zone="internet-address-list-parse-string"><primary>internet_address_list_parse_string</primary></indexterm>
<programlisting><link linkend="InternetAddressList"><returnvalue>InternetAddressList</returnvalue></link> * internet_address_list_parse_string
                                                        (<parameter>const <link linkend="char"><type>char</type></link> *str</parameter>);</programlisting>
<para>
Construct a list of internet addresses from the given string.
</para><variablelist role="params">
<varlistentry><term><parameter>str</parameter>&#160;:</term>
<listitem><simpara>a string containing internet addresses
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="InternetAddressList"><type>InternetAddressList</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the input string does
not contain any addresses.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="internet-address-list-writer" role="function">
<title>internet_address_list_writer ()</title>
<indexterm zone="internet-address-list-writer"><primary>internet_address_list_writer</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                internet_address_list_writer        (<parameter><link linkend="InternetAddressList"><type>InternetAddressList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GString"><type>GString</type></link> *str</parameter>);</programlisting>
<para>
Writes the rfc2047-encoded rfc822 formatted addresses in <parameter>list</parameter> to
<parameter>string</parameter>, folding appropriately.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>list of internet addresses
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>str</parameter>&#160;:</term>
<listitem><simpara>string to write to
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="InternetAddressList.see-also">
<title>See Also</title>
<link linkend="InternetAddress"><type>InternetAddress</type></link>
</refsect1>

</refentry>
