<refentry id="streamtuner-st-pls-api">
<refmeta>
<refentrytitle>st-pls</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>STREAMTUNER Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>st-pls</refname><refpurpose>functions for handling SHOUTcast PLS playlists.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



<link linkend="GSList">GSList</link>*     <link linkend="st-pls-parse">st_pls_parse</link>                    (const <link linkend="char">char</link> *playlist);
</synopsis>
</refsynopsisdiv>









<refsect1>
<title>Description</title>
<para>

</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="st-pls-parse"/>st_pls_parse ()</title>
<indexterm><primary>st_pls_parse</primary></indexterm><programlisting><link linkend="GSList">GSList</link>*     st_pls_parse                    (const <link linkend="char">char</link> *playlist);</programlisting>
<para>
Parses a SHOUTcast PLS playlist.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>playlist</parameter>&nbsp;:</term>
<listitem><simpara> the playlist data to parse.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the list of URIs contained in <parameter>playlist</parameter>. The list
should be freed using g_slist_foreach(list, (GFunc) g_free, NULL);
g_slist_free(list); when no longer needed.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>



<refsect1>
<title>See Also</title>
<para>
<link linkend="streamtuner-st-m3u-api">st-m3u</link>
</para>
</refsect1>

</refentry>
