gnet-tcp.html

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

><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1179"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>status</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="AEN1184"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>data</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="AEN1189"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-CONNECT"
></A
>gnet_tcp_socket_connect ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
>* gnet_tcp_socket_connect         (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *hostname,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> port);</PRE
></TD
></TR
></TABLE
><P
>A quick and easy <A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> constructor.  This connects to the
 specified address and port.  This function does block
 (<A
HREF="gnet-tcp.html#GNET-TCP-SOCKET-CONNECT-ASYNC"
>gnet_tcp_socket_connect_async</A
>() does not).  Use this function
 when you're a client connecting to a server and you don't mind
 blocking and don't want to mess with <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
>'s.  You can get
 the InetAddr of the socket by calling
 <A
HREF="gnet-tcp.html#GNET-TCP-SOCKET-GET-INETADDR"
>gnet_tcp_socket_get_inetaddr</A
>().</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="AEN1203"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>hostname</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="AEN1208"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>port</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="AEN1213"><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="AEN1218"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-CONNECT-ASYNC"
></A
>gnet_tcp_socket_connect_async ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-tcp.html#GTCPSOCKETCONNECTASYNCID"
>GTcpSocketConnectAsyncID</A
> gnet_tcp_socket_connect_async
                                            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *hostname,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> port,
                                             <A
HREF="gnet-tcp.html#GTCPSOCKETCONNECTASYNCFUNC"
>GTcpSocketConnectAsyncFunc</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>A quick and easy asynchronous <A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> constructor.  This
 connects to the specified address and port and then calls the
 callback with the data.  Use this function when you're a client
 connecting to a server and you don't want to block or mess with
 <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
>'s.  It will call the callback if there is a failure.
 It will never call the callback before the function returns.</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="AEN1232"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>hostname</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="AEN1237"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>port</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="AEN1242"><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="AEN1247"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>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="AEN1252"><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="AEN1257"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-CONNECT-ASYNC-CANCEL"
></A
>gnet_tcp_socket_connect_async_cancel ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_tcp_socket_connect_async_cancel
                                            (<A
HREF="gnet-tcp.html#GTCPSOCKETCONNECTASYNCID"
>GTcpSocketConnectAsyncID</A
> async_id);</PRE
></TD
></TR
></TABLE
><P
>Cancel an asynchronous connection that was started with
 <A
HREF="gnet-tcp.html#GNET-TCP-SOCKET-CONNECT-ASYNC"
>gnet_tcp_socket_connect_async</A
>().</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="AEN1266"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>async_id</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="AEN1271"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-NEW"
></A
>gnet_tcp_socket_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
>* gnet_tcp_socket_new             (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *addr);</PRE
></TD
></TR
></TABLE
><P
>Connect to a specified address.  Use this sort of socket when
 you're a client connecting to a server.  This function will block
 to connect.  SOCKS is used if SOCKS is enabled.</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="AEN1280"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>addr</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="AEN1285"><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="AEN1290"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-NEW-ASYNC"
></A
>gnet_tcp_socket_new_async ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-tcp.html#GTCPSOCKETNEWASYNCID"
>GTcpSocketNewAsyncID</A
> gnet_tcp_socket_new_async
                                            (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *addr,
                                             <A
HREF="gnet-tcp.html#GTCPSOCKETNEWASYNCFUNC"
>GTcpSocketNewAsyncFunc</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Connect to a specifed address asynchronously.  When the connection
 is complete or there is an error, it will call the callback.  It
 may call the callback before the function returns.  It will call
 the callback if there is a failure.  SOCKS is used if SOCKS is
 enabled.  The SOCKS negotiation will block.</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="AEN1301"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>addr</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="AEN1306"><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="AEN1311"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>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="AEN1316"><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="AEN1321"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-NEW-ASYNC-CANCEL"
></A
>gnet_tcp_socket_new_async_cancel ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_tcp_socket_new_async_cancel
                                            (<A
HREF="gnet-tcp.html#GTCPSOCKETNEWASYNCID"
>GTcpSocketNewAsyncID</A
> async_id);</PRE
></TD
></TR
></TABLE
><P
>Cancel an asynchronous connection that was started with
 <A
HREF="gnet-tcp.html#GNET-TCP-SOCKET-NEW-ASYNC"
>gnet_tcp_socket_new_async</A
>().</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="AEN1330"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>async_id</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="AEN1335"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-DELETE"
></A
>gnet_tcp_socket_delete ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_tcp_socket_delete          (<A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> *s);</PRE
></TD
></TR
></TABLE
><P
>Close and delete a <A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
>.</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="AEN1344"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>s</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE