<refentry id="gmime-GMimeHeader">
<refmeta>
<refentrytitle role="top_of_page" id="gmime-GMimeHeader.top_of_page">GMimeHeader</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  GMIME Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GMimeHeader</refname>
<refpurpose>Message and MIME part headers</refpurpose>
</refnamediv>

<refsynopsisdiv id="gmime-GMimeHeader.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>                    <link linkend="GMimeHeaderIter">GMimeHeaderIter</link>;
                    <link linkend="GMimeHeaderList">GMimeHeaderList</link>;
<link linkend="ssize-t"><returnvalue>ssize_t</returnvalue></link>             (<link linkend="GMimeHeaderWriter">*GMimeHeaderWriter</link>)                (<parameter><link linkend="GMimeStream"><type>GMimeStream</type></link> *stream</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                (<link linkend="GMimeHeaderForeachFunc">*GMimeHeaderForeachFunc</link>)           (<parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);
<link linkend="GMimeHeaderIter"><returnvalue>GMimeHeaderIter</returnvalue></link> *   <link linkend="g-mime-header-iter-new">g_mime_header_iter_new</link>              (<parameter><type>void</type></parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-header-iter-free">g_mime_header_iter_free</link>             (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
<link linkend="GMimeHeaderIter"><returnvalue>GMimeHeaderIter</returnvalue></link> *   <link linkend="g-mime-header-iter-copy">g_mime_header_iter_copy</link>             (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-header-iter-copy-to">g_mime_header_iter_copy_to</link>          (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *src</parameter>,
                                                         <parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *dest</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-header-iter-equal">g_mime_header_iter_equal</link>            (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter1</parameter>,
                                                         <parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter2</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-header-iter-first">g_mime_header_iter_first</link>            (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-header-iter-last">g_mime_header_iter_last</link>             (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-header-iter-next">g_mime_header_iter_next</link>             (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-header-iter-prev">g_mime_header_iter_prev</link>             (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-header-iter-is-valid">g_mime_header_iter_is_valid</link>         (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
const <link linkend="char"><returnvalue>char</returnvalue></link> *        <link linkend="g-mime-header-iter-get-name">g_mime_header_iter_get_name</link>         (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
const <link linkend="char"><returnvalue>char</returnvalue></link> *        <link linkend="g-mime-header-iter-get-value">g_mime_header_iter_get_value</link>        (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-header-iter-set-value">g_mime_header_iter_set_value</link>        (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-header-iter-remove">g_mime_header_iter_remove</link>           (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
<link linkend="GMimeHeaderList"><returnvalue>GMimeHeaderList</returnvalue></link> *   <link linkend="g-mime-header-list-new">g_mime_header_list_new</link>              (<parameter><type>void</type></parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-header-list-destroy">g_mime_header_list_destroy</link>          (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-header-list-prepend">g_mime_header_list_prepend</link>          (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-header-list-append">g_mime_header_list_append</link>           (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-header-list-remove">g_mime_header_list_remove</link>           (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-header-list-set">g_mime_header_list_set</link>              (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>);
const <link linkend="char"><returnvalue>char</returnvalue></link> *        <link linkend="g-mime-header-list-get">g_mime_header_list_get</link>              (<parameter>const <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-header-list-get-iter">g_mime_header_list_get_iter</link>         (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-header-list-foreach">g_mime_header_list_foreach</link>          (<parameter>const <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter><link linkend="GMimeHeaderForeachFunc"><type>GMimeHeaderForeachFunc</type></link> func</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-header-list-register-writer">g_mime_header_list_register_writer</link>  (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter><link linkend="GMimeHeaderWriter"><type>GMimeHeaderWriter</type></link> writer</parameter>);
<link linkend="ssize-t"><returnvalue>ssize_t</returnvalue></link>             <link linkend="g-mime-header-list-write-to-stream">g_mime_header_list_write_to_stream</link>  (<parameter>const <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter><link linkend="GMimeStream"><type>GMimeStream</type></link> *stream</parameter>);
<link linkend="char"><returnvalue>char</returnvalue></link> *              <link linkend="g-mime-header-list-to-string">g_mime_header_list_to_string</link>        (<parameter>const <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>);
<link linkend="GMimeStream"><returnvalue>GMimeStream</returnvalue></link> *       <link linkend="g-mime-header-list-get-stream">g_mime_header_list_get_stream</link>       (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-header-list-set-stream">g_mime_header_list_set_stream</link>       (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter><link linkend="GMimeStream"><type>GMimeStream</type></link> *stream</parameter>);
</synopsis>
</refsynopsisdiv>

<refsect1 id="gmime-GMimeHeader.description" role="desc">
<title role="desc.title">Description</title>
<para>
A <link linkend="GMimeHeader"><type>GMimeHeader</type></link> is a collection of rfc822 header fields and their
values.
</para>
</refsect1>
<refsect1 id="gmime-GMimeHeader.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GMimeHeaderIter" role="struct">
<title>GMimeHeaderIter</title>
<indexterm zone="GMimeHeaderIter"><primary>GMimeHeaderIter</primary></indexterm>
<programlisting>typedef struct {
	GMimeHeaderList *hdrlist;
	GMimeHeader *cursor;
	guint32 version;
} GMimeHeaderIter;
</programlisting>
<para>
A message or mime-part header iterator. All members should be
considered private.
</para><variablelist role="struct">
<varlistentry><term><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>&#160;*<structfield id="GMimeHeaderIter.hdrlist">hdrlist</structfield>;</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem>
</varlistentry>
<varlistentry><term><link linkend="GMimeHeader"><type>GMimeHeader</type></link>&#160;*<structfield id="GMimeHeaderIter.cursor">cursor</structfield>;</term>
<listitem><simpara>a <link linkend="GMimeHeader"><type>GMimeHeader</type></link>
</simpara></listitem>
</varlistentry>
<varlistentry><term><link linkend="guint32"><type>guint32</type></link>&#160;<structfield id="GMimeHeaderIter.version">version</structfield>;</term>
<listitem><simpara>the version of <parameter>hdrlist</parameter> when initialized
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="GMimeHeaderList" role="struct">
<title>GMimeHeaderList</title>
<indexterm zone="GMimeHeaderList"><primary>GMimeHeaderList</primary></indexterm>
<programlisting>typedef struct _GMimeHeaderList GMimeHeaderList;</programlisting>
<para>
A message or mime-part header.
</para></refsect2>
<refsect2 id="GMimeHeaderWriter" role="function">
<title>GMimeHeaderWriter ()</title>
<indexterm zone="GMimeHeaderWriter"><primary>GMimeHeaderWriter</primary></indexterm>
<programlisting><link linkend="ssize-t"><returnvalue>ssize_t</returnvalue></link>             (*GMimeHeaderWriter)                (<parameter><link linkend="GMimeStream"><type>GMimeStream</type></link> *stream</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>);</programlisting>
<para>
Function signature for the callback to
<link linkend="g-mime-header-list-register-writer"><function>g_mime_header_list_register_writer()</function></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>stream</parameter>&#160;:</term>
<listitem><simpara>The output stream.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>The field name.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>The field value.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the number of bytes written or <link linkend="1:CAPS"><literal>-1</literal></link> on error.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GMimeHeaderForeachFunc" role="function">
<title>GMimeHeaderForeachFunc ()</title>
<indexterm zone="GMimeHeaderForeachFunc"><primary>GMimeHeaderForeachFunc</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                (*GMimeHeaderForeachFunc)           (<parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);</programlisting>
<para>
Function signature for the callback to <link linkend="g-mime-header-list-foreach"><function>g_mime_header_list_foreach()</function></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>The field name.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>The field value.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>The user-supplied callback data.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-new" role="function">
<title>g_mime_header_iter_new ()</title>
<indexterm zone="g-mime-header-iter-new"><primary>g_mime_header_iter_new</primary></indexterm>
<programlisting><link linkend="GMimeHeaderIter"><returnvalue>GMimeHeaderIter</returnvalue></link> *   g_mime_header_iter_new              (<parameter><type>void</type></parameter>);</programlisting>
<para>
Dynamically allocates a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> on the heap. This is
intended for use in language bindings but may also be useful in
applications as well. You must free this iter with
<link linkend="g-mime-header-iter-free"><function>g_mime_header_iter_free()</function></link>.
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a newly-allocated <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-free" role="function">
<title>g_mime_header_iter_free ()</title>
<indexterm zone="g-mime-header-iter-free"><primary>g_mime_header_iter_free</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_header_iter_free             (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Frees a dynamically-allocated <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> as created by
<link linkend="g-mime-header-iter-new"><function>g_mime_header_iter_new()</function></link> or <link linkend="g-mime-header-iter-copy"><function>g_mime_header_iter_copy()</function></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-copy" role="function">
<title>g_mime_header_iter_copy ()</title>
<indexterm zone="g-mime-header-iter-copy"><primary>g_mime_header_iter_copy</primary></indexterm>
<programlisting><link linkend="GMimeHeaderIter"><returnvalue>GMimeHeaderIter</returnvalue></link> *   g_mime_header_iter_copy             (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Creates a dynamically allocated header iterator as a copy of
<parameter>iter</parameter>. You must free this iter with <link linkend="g-mime-header-iter-free"><function>g_mime_header_iter_free()</function></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a newly-allocated copy of <parameter>iter</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-copy-to" role="function">
<title>g_mime_header_iter_copy_to ()</title>
<indexterm zone="g-mime-header-iter-copy-to"><primary>g_mime_header_iter_copy_to</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_header_iter_copy_to          (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *src</parameter>,
                                                         <parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *dest</parameter>);</programlisting>
<para>
Copies <parameter>src</parameter> to <parameter>dest</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>src</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dest</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-equal" role="function">
<title>g_mime_header_iter_equal ()</title>
<indexterm zone="g-mime-header-iter-equal"><primary>g_mime_header_iter_equal</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_header_iter_equal            (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter1</parameter>,
                                                         <parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter2</parameter>);</programlisting>
<para>
Check that <parameter>iter1</parameter> and <parameter>iter2</parameter> reference the same header.
</para><variablelist role="params">
<varlistentry><term><parameter>iter1</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>iter2</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>iter1</parameter> and <parameter>iter2</parameter> refer to the same header or
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-first" role="function">
<title>g_mime_header_iter_first ()</title>
<indexterm zone="g-mime-header-iter-first"><primary>g_mime_header_iter_first</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_header_iter_first            (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Updates <parameter>iter</parameter> to point to the first header.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-last" role="function">
<title>g_mime_header_iter_last ()</title>
<indexterm zone="g-mime-header-iter-last"><primary>g_mime_header_iter_last</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_header_iter_last             (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Updates <parameter>iter</parameter> to point to the last header.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-next" role="function">
<title>g_mime_header_iter_next ()</title>
<indexterm zone="g-mime-header-iter-next"><primary>g_mime_header_iter_next</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_header_iter_next             (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Advances to the next header.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-prev" role="function">
<title>g_mime_header_iter_prev ()</title>
<indexterm zone="g-mime-header-iter-prev"><primary>g_mime_header_iter_prev</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_header_iter_prev             (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Advances to the previous header.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-is-valid" role="function">
<title>g_mime_header_iter_is_valid ()</title>
<indexterm zone="g-mime-header-iter-is-valid"><primary>g_mime_header_iter_is_valid</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_header_iter_is_valid         (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Checks if a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> is valid. An iterator may become
invalid if the <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> that the iterator refers to
changes.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>iter</parameter> is still valid or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-get-name" role="function">
<title>g_mime_header_iter_get_name ()</title>
<indexterm zone="g-mime-header-iter-get-name"><primary>g_mime_header_iter_get_name</primary></indexterm>
<programlisting>const <link linkend="char"><returnvalue>char</returnvalue></link> *        g_mime_header_iter_get_name         (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Gets the current header's name.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the header name or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if invalid.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-get-value" role="function">
<title>g_mime_header_iter_get_value ()</title>
<indexterm zone="g-mime-header-iter-get-value"><primary>g_mime_header_iter_get_value</primary></indexterm>
<programlisting>const <link linkend="char"><returnvalue>char</returnvalue></link> *        g_mime_header_iter_get_value        (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Gets the current header's name.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the header name or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if invalid.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-set-value" role="function">
<title>g_mime_header_iter_set_value ()</title>
<indexterm zone="g-mime-header-iter-set-value"><primary>g_mime_header_iter_set_value</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_header_iter_set_value        (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>);</programlisting>
<para>
Sets the current header's value to the new value.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>new header value
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the value was set or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise (indicates
invalid iter).
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-iter-remove" role="function">
<title>g_mime_header_iter_remove ()</title>
<indexterm zone="g-mime-header-iter-remove"><primary>g_mime_header_iter_remove</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_header_iter_remove           (<parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Removes the current header and advances to the next header.
</para>
<para>
Note: If you remove the last header in the list, then <parameter>iter</parameter> will
become invalid regardless of whether or not other headers remain.
</para><variablelist role="params">
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-new" role="function">
<title>g_mime_header_list_new ()</title>
<indexterm zone="g-mime-header-list-new"><primary>g_mime_header_list_new</primary></indexterm>
<programlisting><link linkend="GMimeHeaderList"><returnvalue>GMimeHeaderList</returnvalue></link> *   g_mime_header_list_new              (<parameter><type>void</type></parameter>);</programlisting>
<para>
Creates a new <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> object.
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new header list object.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-destroy" role="function">
<title>g_mime_header_list_destroy ()</title>
<indexterm zone="g-mime-header-list-destroy"><primary>g_mime_header_list_destroy</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_header_list_destroy          (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>);</programlisting>
<para>
Destroy the header list.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-prepend" role="function">
<title>g_mime_header_list_prepend ()</title>
<indexterm zone="g-mime-header-list-prepend"><primary>g_mime_header_list_prepend</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_header_list_prepend          (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>);</programlisting>
<para>
Prepends a header. If <parameter>value</parameter> is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, a space will be set aside
for it (useful for setting the order of headers before values can
be obtained for them) otherwise the header will be unset.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>header name
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>header value
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-append" role="function">
<title>g_mime_header_list_append ()</title>
<indexterm zone="g-mime-header-list-append"><primary>g_mime_header_list_append</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_header_list_append           (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>);</programlisting>
<para>
Appends a header. If <parameter>value</parameter> is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, a space will be set aside for it
(useful for setting the order of headers before values can be
obtained for them) otherwise the header will be unset.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>header name
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>header value
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-remove" role="function">
<title>g_mime_header_list_remove ()</title>
<indexterm zone="g-mime-header-list-remove"><primary>g_mime_header_list_remove</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_header_list_remove           (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>);</programlisting>
<para>
Remove the specified header.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>header name
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the header was successfully removed or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if
the specified header could not be found.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-set" role="function">
<title>g_mime_header_list_set ()</title>
<indexterm zone="g-mime-header-list-set"><primary>g_mime_header_list_set</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_header_list_set              (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *value</parameter>);</programlisting>
<para>
Set the value of the specified header. If <parameter>value</parameter> is <link linkend="NULL:CAPS"><literal>NULL</literal></link> and the
header, <parameter>name</parameter>, had not been previously set, a space will be set
aside for it (useful for setting the order of headers before values
can be obtained for them) otherwise the header will be unset.
</para>
<para>
Note: If there are multiple headers with the specified field name,
the first instance of the header will be replaced and further
instances will be removed.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>header name
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>header value
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-get" role="function">
<title>g_mime_header_list_get ()</title>
<indexterm zone="g-mime-header-list-get"><primary>g_mime_header_list_get</primary></indexterm>
<programlisting>const <link linkend="char"><returnvalue>char</returnvalue></link> *        g_mime_header_list_get              (<parameter>const <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>);</programlisting>
<para>
Gets the value of the first header with the name requested.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>header name
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the value of the header requested.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-get-iter" role="function">
<title>g_mime_header_list_get_iter ()</title>
<indexterm zone="g-mime-header-list-get-iter"><primary>g_mime_header_list_get_iter</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_header_list_get_iter         (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter><link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link> *iter</parameter>);</programlisting>
<para>
Initializes an iterator for traversing <parameter>headers</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderIter"><type>GMimeHeaderIter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if successful or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if there are no headers to
traverse.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-foreach" role="function">
<title>g_mime_header_list_foreach ()</title>
<indexterm zone="g-mime-header-list-foreach"><primary>g_mime_header_list_foreach</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_header_list_foreach          (<parameter>const <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter><link linkend="GMimeHeaderForeachFunc"><type>GMimeHeaderForeachFunc</type></link> func</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);</programlisting>
<para>
Calls <parameter>func</parameter> for each header name/value pair.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>A <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara>function to be called for each header.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>User data to be passed to the func.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-register-writer" role="function">
<title>g_mime_header_list_register_writer ()</title>
<indexterm zone="g-mime-header-list-register-writer"><primary>g_mime_header_list_register_writer</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_header_list_register_writer  (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                                         <parameter><link linkend="GMimeHeaderWriter"><type>GMimeHeaderWriter</type></link> writer</parameter>);</programlisting>
<para>
Changes the function used to write <parameter>name</parameter> headers to <parameter>writer</parameter> (or the
default if <parameter>writer</parameter> is <link linkend="NULL:CAPS"><literal>NULL</literal></link>). This is useful if you want to change
the default header folding style for a particular header.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>header name
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>writer</parameter>&#160;:</term>
<listitem><simpara>writer function
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-write-to-stream" role="function">
<title>g_mime_header_list_write_to_stream ()</title>
<indexterm zone="g-mime-header-list-write-to-stream"><primary>g_mime_header_list_write_to_stream</primary></indexterm>
<programlisting><link linkend="ssize-t"><returnvalue>ssize_t</returnvalue></link>             g_mime_header_list_write_to_stream  (<parameter>const <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter><link linkend="GMimeStream"><type>GMimeStream</type></link> *stream</parameter>);</programlisting>
<para>
Write the headers to a stream.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>stream</parameter>&#160;:</term>
<listitem><simpara>output stream
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the number of bytes written or <link linkend="1:CAPS"><literal>-1</literal></link> on fail.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-to-string" role="function">
<title>g_mime_header_list_to_string ()</title>
<indexterm zone="g-mime-header-list-to-string"><primary>g_mime_header_list_to_string</primary></indexterm>
<programlisting><link linkend="char"><returnvalue>char</returnvalue></link> *              g_mime_header_list_to_string        (<parameter>const <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>);</programlisting>
<para>
Allocates a string buffer containing the raw rfc822 headers
contained in <parameter>headers</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a string containing the header block.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-get-stream" role="function">
<title>g_mime_header_list_get_stream ()</title>
<indexterm zone="g-mime-header-list-get-stream"><primary>g_mime_header_list_get_stream</primary></indexterm>
<programlisting><link linkend="GMimeStream"><returnvalue>GMimeStream</returnvalue></link> *       g_mime_header_list_get_stream       (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>);</programlisting>
<para>
Gets the raw stream representing <parameter>headers</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GMimeStream"><type>GMimeStream</type></link> if set or <link linkend="NULL:CAPS"><literal>NULL</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-header-list-set-stream" role="function">
<title>g_mime_header_list_set_stream ()</title>
<indexterm zone="g-mime-header-list-set-stream"><primary>g_mime_header_list_set_stream</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_header_list_set_stream       (<parameter><link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link> *headers</parameter>,
                                                         <parameter><link linkend="GMimeStream"><type>GMimeStream</type></link> *stream</parameter>);</programlisting>
<para>
Set the raw header stream.
</para><variablelist role="params">
<varlistentry><term><parameter>headers</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeHeaderList"><type>GMimeHeaderList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>stream</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeStream"><type>GMimeStream</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="gmime-GMimeHeader.see-also">
<title>See Also</title>
<link linkend="GMimeObject"><type>GMimeObject</type></link>
</refsect1>

</refentry>
