📄 inet.ipmsgserver.html
字号:
<html><!-- #BeginTemplate "/Templates/tmpl.dwt" --><head><!-- #BeginEditable "doctitle" --> <title>PTypes: networking: ipstmserver</title><!-- #EndEditable --> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><link rel="stylesheet" href="styles.css"></head><body bgcolor="#FFFFFF" leftmargin="40" marginwidth="40"><p><a href="../index.html"><img src="title-1.7.gif" width="213" height="34" alt="C++ Portable Types Library (PTypes) Version 1.7" border="0"></a> <hr noshade><!-- #BeginEditable "body" --> <p class="hpath"><a href="index.html">Top</a>: <a href="inet.html">Networking</a>: ipmsgserver</p><blockquote> <pre class="lang">#include <pinet.h>ipmsgserver::ipmsgserver();void ipmsgserver::bind(ipaddress ip, int port);void ipmsgserver::bindall(int port);bool ipmsgserver::poll(int bindnum = -1, int timeout = 0);int ipmsgserver::receive(char* buf, int count);string ipmsgserver::receive(int max);void ipmsgserver::send(const char* buf, int count);void ipmsgserver::send(string s);ipaddress ipmsgserver::get_ip();string ipmsgserver::get_host();</pre></blockquote><p>The <span class="lang">ipmsgserver</span> class is used on the server side of a client-server application. It bounds itself to a specified port/address and waits until a packet is received from a client host. Once a packet is read with <span class="lang">receive()</span>, subsequent calls to <span class="lang">send()</span> will post data back to the client that sent the last request. Each request must be fulfilled immediately; unlike the stream-oriented server class, <span class="lang">ipmsgserver</span> can not handle requests concurrently.</p><p><span class="lang">ipmsgserver</span> can generate exceptions of type <span class="lang">(estream*)</span> with a corresponding error code and a message string.</p><p>Please, see also the introduction to <a href="inet.ipmessage.html">ipmessage</a>.</p><p><span class="def">ipmsgserver::ipmsgserver()</span> constructs an <span class="lang">ipmsgserver</span> object.</p><p><span class="def">void ipmsgserver::bind(ipaddress ip, int port)</span> binds the server to the specified local IP address and port number. This function can be called multiple times for different local addresses and port numbers.</p><p><span class="def">void ipmsgserver::bindall(int port)</span> binds the server to all local IP address on the specified port number. Can be called multiple times for different port numbers.</p><p><span class="def">bool ipmsgserver::poll(int bindnum = -1, int timeout = 0)</span> polls the listening sockets for data available for reading. <span class="lang">Bindnum</span> specifies the socket number to test. The numbering of bound sockets corresponds to the order in which functions <span class="lang">bind()</span> or <span class="lang">bindall()</span> were called, starting from 0. If <span class="lang">bindnum</span> is -1 <span class="lang">poll()</span> will test all sockets. The second parameter <span class="lang">timeout</span> specifies the amount of time in milliseconds to wait for data. If <span class="lang">timeout</span> is 0 <span class="lang">poll()</span> will return immediately; if it's -1 <span class="lang">poll()</span> will wait infinitely. This function returns <span class="lang">true</span> if there is data available for reading.</p><p><span class="def">int ipmsgserver::receive(char* buf, int count)</span> reads data from the socket. <span class="lang">Receive()</span> may hang if no data is available for reading. This function returns the actual number of bytes read. If the packet received exceeds the size of the supplied buffer, an exception is raised with code EMSGSIZE. You may check if there is data available for reading without 'hanging' using <span class="lang">poll()</span> described above.</p><p><span class="def">string ipmsgserver::receive(int max)</span> works like the previous version of <span class="lang">receive()</span> except that it returns data in a dynamic string. The parameter <span class="lang">max</span> specifies the limit which may not be exceeded when reading data from the network, like with the previous version of <span class="lang">receive()</span>.</p><p><span class="def">void ipmsgserver::send(const char* buf, int count)</span> sends data to the peer. The destination address is determined from the last packet read using <span class="lang">receive()</span>.</p><p><span class="def">void ipmsgserver::send(string s)</span> works like the previous version of <span class="lang">send()</span> except that it sends the string <span class="lang">s</span> (not including the terminating null-symbol).</p><p><span class="def">ipaddress ipmsgserver::get_ip()</span> returns the IP address of the peer. The information about the peer is determined during a successful call to <span class="lang">receive()</span>.</p><p><span class="def">string ipmsgserver::get_host()</span> returns the peer host name. A reverse DNS lookup may be performed if necessary. The information about the peer is determined during a successful call to <span class="lang">receive()</span>.</p><p class="seealso">See also: <a href="inet.ipmessage.html">ipmessage</a>, <a href="inet.utils.html">Utilities</a>, <a href="inet.examples.html">Examples</a></p><!-- #EndEditable --> <hr size="1"><a href="../index.html" class="ns">PTypes home</a></body><!-- #EndTemplate --></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -