<refentry id="GMimeStreamCat">
<refmeta>
<refentrytitle role="top_of_page" id="GMimeStreamCat.top_of_page">GMimeStreamCat</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  GMIME Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GMimeStreamCat</refname>
<refpurpose>A concatenated stream</refpurpose>
</refnamediv>

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

<synopsis>                    <link linkend="GMimeStreamCat-struct">GMimeStreamCat</link>;
<link linkend="GMimeStream"><returnvalue>GMimeStream</returnvalue></link> *       <link linkend="g-mime-stream-cat-new">g_mime_stream_cat_new</link>               (<parameter><type>void</type></parameter>);
<link linkend="int"><returnvalue>int</returnvalue></link>                 <link linkend="g-mime-stream-cat-add-source">g_mime_stream_cat_add_source</link>        (<parameter><link linkend="GMimeStreamCat"><type>GMimeStreamCat</type></link> *cat</parameter>,
                                                         <parameter><link linkend="GMimeStream"><type>GMimeStream</type></link> *source</parameter>);
</synopsis>
</refsynopsisdiv>
<refsect1 id="GMimeStreamCat.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GMimeStream">GMimeStream</link>
         +----GMimeStreamCat
</synopsis>
</refsect1>

<refsect1 id="GMimeStreamCat.description" role="desc">
<title role="desc.title">Description</title>
<para>
A <link linkend="GMimeStream"><type>GMimeStream</type></link> which chains together any number of other streams.
</para>
</refsect1>
<refsect1 id="GMimeStreamCat.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GMimeStreamCat-struct" role="struct">
<title>GMimeStreamCat</title>
<indexterm zone="GMimeStreamCat-struct"><primary>GMimeStreamCat</primary></indexterm>
<programlisting>typedef struct _GMimeStreamCat GMimeStreamCat;</programlisting>
<para>
A concatenation of other <link linkend="GMimeStream"><type>GMimeStream</type></link> objects.
</para><variablelist role="struct">
</variablelist></refsect2>
<refsect2 id="g-mime-stream-cat-new" role="function">
<title>g_mime_stream_cat_new ()</title>
<indexterm zone="g-mime-stream-cat-new"><primary>g_mime_stream_cat_new</primary></indexterm>
<programlisting><link linkend="GMimeStream"><returnvalue>GMimeStream</returnvalue></link> *       g_mime_stream_cat_new               (<parameter><type>void</type></parameter>);</programlisting>
<para>
Creates a new <link linkend="GMimeStreamCat"><type>GMimeStreamCat</type></link> object.
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GMimeStreamCat"><type>GMimeStreamCat</type></link> stream.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-stream-cat-add-source" role="function">
<title>g_mime_stream_cat_add_source ()</title>
<indexterm zone="g-mime-stream-cat-add-source"><primary>g_mime_stream_cat_add_source</primary></indexterm>
<programlisting><link linkend="int"><returnvalue>int</returnvalue></link>                 g_mime_stream_cat_add_source        (<parameter><link linkend="GMimeStreamCat"><type>GMimeStreamCat</type></link> *cat</parameter>,
                                                         <parameter><link linkend="GMimeStream"><type>GMimeStream</type></link> *source</parameter>);</programlisting>
<para>
Adds the <parameter>source</parameter> stream to the <parameter>cat</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>cat</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeStreamCat"><type>GMimeStreamCat</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>a source stream
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="0:CAPS"><literal>0</literal></link> on success or <link linkend="1:CAPS"><literal>-1</literal></link> on fail.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

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

</refentry>
