2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
5
<!ENTITY version SYSTEM "version.xml">
7
<refentry id="gio-GConverterInputstream">
9
<refentrytitle role="top_of_page" id="gio-GConverterInputstream.top_of_page">GConverterInputstream</refentrytitle>
10
<manvolnum>3</manvolnum>
11
<refmiscinfo>GIO Library</refmiscinfo>
15
<refname>GConverterInputstream</refname>
16
<refpurpose>Converter Input Stream</refpurpose>
19
<refsynopsisdiv id="gio-GConverterInputstream.synopsis" role="synopsis">
20
<title role="synopsis.title">Synopsis</title>
21
<anchor id="GConverterInputStream"/>
24
#include <gio/gio.h>
26
<link linkend="GConverterInputStream-struct">GConverterInputStream</link>;
27
<link linkend="GInputStream">GInputStream</link> * <link linkend="g-converter-input-stream-new">g_converter_input_stream_new</link> (<link linkend="GInputStream">GInputStream</link> *base_stream,
28
<link linkend="GConverter">GConverter</link> *converter);
29
<link linkend="GConverter">GConverter</link> * <link linkend="g-converter-input-stream-get-converter">g_converter_input_stream_get_converter</link>
30
(<link linkend="GConverterInputStream">GConverterInputStream</link> *converter_stream);
34
<refsect1 id="gio-GConverterInputstream.object-hierarchy" role="object_hierarchy">
35
<title role="object_hierarchy.title">Object Hierarchy</title>
37
<link linkend="GObject">GObject</link>
38
+----<link linkend="GInputStream">GInputStream</link>
39
+----<link linkend="GFilterInputStream">GFilterInputStream</link>
40
+----GConverterInputStream
48
<refsect1 id="gio-GConverterInputstream.properties" role="properties">
49
<title role="properties.title">Properties</title>
51
"<link linkend="GConverterInputStream--converter">converter</link>" <link linkend="GConverter">GConverter</link>* : Read / Write / Construct Only
57
<refsect1 id="gio-GConverterInputstream.description" role="desc">
58
<title role="desc.title">Description</title>
60
Converter input stream implements <link linkend="GInputStream"><type>GInputStream</type></link> and allows
61
conversion of data of various types during reading.</para>
66
<refsect1 id="gio-GConverterInputstream.details" role="details">
67
<title role="details.title">Details</title>
68
<refsect2 id="GConverterInputStream-struct" role="struct">
69
<title>GConverterInputStream</title>
70
<indexterm zone="GConverterInputStream-struct"><primary sortas="ConverterInputStream">GConverterInputStream</primary></indexterm><programlisting>typedef struct _GConverterInputStream GConverterInputStream;</programlisting>
72
An implementation of <link linkend="GFilterInputStream"><type>GFilterInputStream</type></link> that allows data
75
</para><variablelist role="struct">
76
</variablelist></refsect2>
77
<refsect2 id="g-converter-input-stream-new" role="function">
78
<title>g_converter_input_stream_new ()</title>
79
<indexterm zone="g-converter-input-stream-new"><primary sortas="converter_input_stream_new">g_converter_input_stream_new</primary></indexterm><programlisting><link linkend="GInputStream">GInputStream</link> * g_converter_input_stream_new (<link linkend="GInputStream">GInputStream</link> *base_stream,
80
<link linkend="GConverter">GConverter</link> *converter);</programlisting>
82
Creates a new converter input stream for the <parameter>base_stream</parameter>.</para>
84
</para><variablelist role="params">
85
<varlistentry><term><parameter>base_stream</parameter> :</term>
86
<listitem><simpara> a <link linkend="GInputStream"><type>GInputStream</type></link>
87
</simpara></listitem></varlistentry>
88
<varlistentry><term><parameter>converter</parameter> :</term>
89
<listitem><simpara> a <link linkend="GConverter"><type>GConverter</type></link>
90
</simpara></listitem></varlistentry>
91
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a new <link linkend="GInputStream"><type>GInputStream</type></link>.
92
</simpara></listitem></varlistentry>
93
</variablelist></refsect2>
94
<refsect2 id="g-converter-input-stream-get-converter" role="function" condition="since:2.24">
95
<title>g_converter_input_stream_get_converter ()</title>
96
<indexterm zone="g-converter-input-stream-get-converter" role="2.24"><primary sortas="converter_input_stream_get_converter">g_converter_input_stream_get_converter</primary></indexterm><programlisting><link linkend="GConverter">GConverter</link> * g_converter_input_stream_get_converter
97
(<link linkend="GConverterInputStream">GConverterInputStream</link> *converter_stream);</programlisting>
99
Gets the <link linkend="GConverter"><type>GConverter</type></link> that is used by <parameter>converter_stream</parameter>.</para>
101
</para><variablelist role="params">
102
<varlistentry><term><parameter>converter_stream</parameter> :</term>
103
<listitem><simpara> a <link linkend="GConverterInputStream"><type>GConverterInputStream</type></link>
104
</simpara></listitem></varlistentry>
105
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the converter of the converter input stream
107
</simpara></listitem></varlistentry>
108
</variablelist><para role="since">Since 2.24</para></refsect2>
111
<refsect1 id="gio-GConverterInputstream.property-details" role="property_details">
112
<title role="property_details.title">Property Details</title>
113
<refsect2 id="GConverterInputStream--converter" role="property"><title>The <literal>"converter"</literal> property</title>
114
<indexterm zone="GConverterInputStream--converter"><primary sortas="ConverterInputStream:converter">GConverterInputStream:converter</primary></indexterm><programlisting> "converter" <link linkend="GConverter">GConverter</link>* : Read / Write / Construct Only</programlisting>
115
<para>The converter object.</para></refsect2>
120
<refsect1 id="gio-GConverterInputstream.see-also">
121
<title>See Also</title>
122
#GInputStream, <link linkend="GConverter"><type>GConverter</type></link>