gnet-conn.html

GNet是一个简单的网络库。它是目标定向的

></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4821"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4826"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4831"><SPAN
STYLE="white-space: nowrap"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4836"
></A
><H3
><A
NAME="GNET-CONN-NEW-INETADDR"
></A
>gnet_conn_new_inetaddr ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-conn.html#GCONN"
>GConn</A
>*      gnet_conn_new_inetaddr          (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *inetaddr,
                                             <A
HREF="gnet-conn.html#GCONNFUNC"
>GConnFunc</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);</PRE
></TD
></TR
></TABLE
><P
>Create a connection object representing a connection to a host.
 This function is similar to <A
HREF="gnet-conn.html#GNET-CONN-NEW"
>gnet_conn_new</A
>() but has different
 arguments.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4848"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>inetaddr</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4853"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4858"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4863"><SPAN
STYLE="white-space: nowrap"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4868"
></A
><H3
><A
NAME="GNET-CONN-DELETE"
></A
>gnet_conn_delete ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_conn_delete                (<A
HREF="gnet-conn.html#GCONN"
>GConn</A
> *conn,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> delete_buffers);</PRE
></TD
></TR
></TABLE
><P
>Delete the connection.  If delete_buffers is set, any write
 buffers are deleted.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4877"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>conn</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4882"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>delete_buffers</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4887"
></A
><H3
><A
NAME="GNET-CONN-REF"
></A
>gnet_conn_ref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_conn_ref                   (<A
HREF="gnet-conn.html#GCONN"
>GConn</A
> *conn);</PRE
></TD
></TR
></TABLE
><P
>Increment the reference counter of the GConn.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4895"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>conn</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4900"
></A
><H3
><A
NAME="GNET-CONN-UNREF"
></A
>gnet_conn_unref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_conn_unref                 (<A
HREF="gnet-conn.html#GCONN"
>GConn</A
> *conn,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> delete_buffers);</PRE
></TD
></TR
></TABLE
><P
>Remove a reference from the <A
HREF="gnet-conn.html#GCONN"
>GConn</A
>.  When reference count reaches
 0, the connection is deleted.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4910"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>conn</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4915"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>delete_buffers</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4920"
></A
><H3
><A
NAME="GNET-CONN-CONNECT"
></A
>gnet_conn_connect ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_conn_connect               (<A
HREF="gnet-conn.html#GCONN"
>GConn</A
> *conn,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> timeout);</PRE
></TD
></TR
></TABLE
><P
>Establish the connection.  If the connection is pending or already
 established, this function does nothing.  The callback is called
 when the connection is established or an error occurs.  THE
 TIMEOUT IS NOT CURRENTLY USED (FIX).</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4929"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>conn</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4934"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>timeout</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4939"
></A
><H3
><A
NAME="GNET-CONN-DISCONNECT"
></A
>gnet_conn_disconnect ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_conn_disconnect            (<A
HREF="gnet-conn.html#GCONN"
>GConn</A
> *conn,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> delete_buffers);</PRE
></TD
></TR
></TABLE
><P
>End the connection.  The connection can later be reestablished by
 calling <A
HREF="gnet-conn.html#GNET-CONN-CONNECT"
>gnet_conn_connect</A
>() again.  If there the connection was
 not establish, this function does nothing.  If delete_buffers is
 set, any write buffers are deleted.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4949"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>conn</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4954"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>delete_buffers</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4959"
></A
><H3
><A
NAME="GNET-CONN-IS-CONNECTED"
></A
>gnet_conn_is_connected ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnet_conn_is_connected          (const <A
HREF="gnet-conn.html#GCONN"
>GConn</A
> *conn);</PRE
></TD
></TR
></TABLE
><P
>Check if the connection is established.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4968"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>conn</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN4973"><SPAN
STYLE="white-space: nowrap"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4978"
></A
><H3
><A
NAME="GNET-CONN-READ"
></A
>gnet_conn_read ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_conn_read                  (<A
HREF="gnet-conn.html#GCONN"
>GConn</A
> *conn,
                                             <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *buffer,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> length,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> timeout,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> read_one_byte_at_a_time,
                                             <GTKDOCLINK
HREF="GNETIOCHANNELREADASYNCCHECKFUNC"
>GNetIOChannelReadAsyncCheckFunc</GTKDOCLINK
> check_func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> check_user_data);</PRE
></TD
></TR
></TABLE
><P
>Set up an asynchronous read from the connection to the buffer.
 This is a wrapper around <A
HREF="gnet-iochannel.html#GNET-IO-CHANNEL-READ-ASYNC"
>gnet_io_channel_read_async</A
>(), which reads
 data until the check function stops it.  The callback for this
 <A
HREF="gnet-conn.html#GCONN"