gnet-udp.html

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

HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
> *s);</PRE
></TD
></TR
></TABLE
><P
>Increment the reference counter of the <A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</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="AEN2144"><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
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2149"
></A
><H3
><A
NAME="GNET-UDP-SOCKET-UNREF"
></A
>gnet_udp_socket_unref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_udp_socket_unref           (<A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
> *s);</PRE
></TD
></TR
></TABLE
><P
>Remove a reference from the <A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
>.  When reference count
 reaches 0, the socket 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="AEN2158"><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
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2163"
></A
><H3
><A
NAME="GNET-UDP-SOCKET-SEND"
></A
>gnet_udp_socket_send ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnet_udp_socket_send            (<A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
> *s,
                                             const <A
HREF="gnet-udp.html#GUDPPACKET"
>GUdpPacket</A
> *packet);</PRE
></TD
></TR
></TABLE
><P
>Send the packet using the <A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</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="AEN2174"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>s</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="AEN2179"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>packet</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="AEN2184"><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="AEN2189"
></A
><H3
><A
NAME="GNET-UDP-SOCKET-RECEIVE"
></A
>gnet_udp_socket_receive ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnet_udp_socket_receive         (<A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
> *s,
                                             <A
HREF="gnet-udp.html#GUDPPACKET"
>GUdpPacket</A
> *packet);</PRE
></TD
></TR
></TABLE
><P
>Receive a packet using the UDP socket.</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="AEN2199"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>s</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="AEN2204"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>packet</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="AEN2209"><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="AEN2214"
></A
><H3
><A
NAME="GNET-UDP-SOCKET-HAS-PACKET"
></A
>gnet_udp_socket_has_packet ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnet_udp_socket_has_packet      (const <A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
> *s);</PRE
></TD
></TR
></TABLE
><P
>Test if the socket has a receive packet.  It's strongly
 recommended that you use a <GTKDOCLINK
HREF="GIOCHANNEL"
>GIOChannel</GTKDOCLINK
> with a read watch instead
 of this function.</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="AEN2224"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>s</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="AEN2229"><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="AEN2234"
></A
><H3
><A
NAME="GNET-UDP-SOCKET-GET-IOCHANNEL"
></A
>gnet_udp_socket_get_iochannel ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GIOCHANNEL"
>GIOChannel</GTKDOCLINK
>* gnet_udp_socket_get_iochannel   (<A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
> *socket);</PRE
></TD
></TR
></TABLE
><P
>Get a <GTKDOCLINK
HREF="GIOCHANNEL"
>GIOChannel</GTKDOCLINK
> from the <A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
>.  </P
><P
> THIS IS NOT A NORMAL GIOCHANNEL - DO NOT READ OR WRITE WITH IT.</P
><P
> Use the channel with <GTKDOCLINK
HREF="G-IO-ADD-WATCH"
>g_io_add_watch</GTKDOCLINK
>() to do asynchronous IO (so if
 you do not want to do asynchronous IO, you do not need the
 channel).  If you can read from the channel, use
 <A
HREF="gnet-udp.html#GNET-UDP-SOCKET-RECEIVE"
>gnet_udp_socket_receive</A
>() to read a packet.  If you can write to
 the channel, use <A
HREF="gnet-udp.html#GNET-UDP-SOCKET-SEND"
>gnet_udp_socket_send</A
>() to write a packet.</P
><P
> There is one channel for every socket.  This function refs the
 channel before returning it.  You should unref the channel when
 you are done with it.  However, you should not close the channel -
 this is done when you delete the socket.</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="AEN2251"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>socket</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="AEN2256"><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="AEN2261"
></A
><H3
><A
NAME="GNET-UDP-SOCKET-GET-TTL"
></A
>gnet_udp_socket_get_ttl ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnet_udp_socket_get_ttl         (const <A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
> *us);</PRE
></TD
></TR
></TABLE
><P
>Get the TTL of the UDP socket.  TTL is the Time To Live - the
 number of hops outgoing packets will travel.  This is useful for
 resource discovery; for most programs, you don't need to use it.</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="AEN2270"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>us</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="AEN2275"><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="AEN2280"
></A
><H3
><A
NAME="GNET-UDP-SOCKET-SET-TTL"
></A
>gnet_udp_socket_set_ttl ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnet_udp_socket_set_ttl         (<A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
> *us,
                                             int val);</PRE
></TD
></TR
></TABLE
><P
>Set the TTL of the UDP socket.</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="AEN2289"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>us</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="AEN2294"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>val</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"