904 lines
58 KiB
HTML
904 lines
58 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<title>SFML - Simple and Fast Multimedia Library</title>
|
|
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8" />
|
|
<link rel="stylesheet" type="text/css" href="doxygen.css" title="default" media="screen,print" />
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
|
<script type="text/javascript" src="clipboard.js"></script>
|
|
<script type="text/javascript" src="cookie.js"></script>
|
|
<link rel="stylesheet" type="text/css" href="search/search.css" />
|
|
<link rel="stylesheet" type="text/css" href="searchOverrides.css" />
|
|
<script type="text/javascript" src="search/searchdata.js"></script>
|
|
<script type="text/javascript" src="search/search.js"></script>
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
|
$(document).ready(function() { init_search(); });
|
|
/* @license-end */
|
|
</script>
|
|
</head>
|
|
<body>
|
|
<div id="banner-container">
|
|
<div id="banner">
|
|
<span id="sfml">SFML 3.0.0</span>
|
|
</div>
|
|
</div>
|
|
<div id="content">
|
|
<div>
|
|
<!-- Generated by Doxygen 1.12.0 -->
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
|
var searchBox = new SearchBox("searchBox", "search/",'.html');
|
|
/* @license-end */
|
|
</script>
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
|
$(function() { codefold.init(0); });
|
|
/* @license-end */
|
|
</script>
|
|
<div id="navrow1" class="tabs">
|
|
<ul class="tablist">
|
|
<li><a href="index.html"><span>Main Page</span></a></li>
|
|
<li><a href="topics.html"><span>Topics</span></a></li>
|
|
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
|
|
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
|
|
<li><a href="files.html"><span>Files</span></a></li>
|
|
<li>
|
|
<div id="MSearchBox" class="MSearchBoxInactive">
|
|
<span class="left">
|
|
<span id="MSearchSelect" onmouseover="return searchBox.OnSearchSelectShow()" onmouseout="return searchBox.OnSearchSelectHide()"> </span>
|
|
<input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
|
|
onfocus="searchBox.OnSearchFieldFocus(true)"
|
|
onblur="searchBox.OnSearchFieldFocus(false)"
|
|
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
|
</span><span class="right">
|
|
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
|
|
</span>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div id="navrow2" class="tabs2">
|
|
<ul class="tablist">
|
|
<li><a href="annotated.html"><span>Class List</span></a></li>
|
|
<li><a href="classes.html"><span>Class Index</span></a></li>
|
|
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
|
|
<li><a href="functions.html"><span>Class Members</span></a></li>
|
|
</ul>
|
|
</div>
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
|
$(function(){ initResizable(false); });
|
|
/* @license-end */
|
|
</script>
|
|
<!-- window showing the filter options -->
|
|
<div id="MSearchSelectWindow"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
|
</div>
|
|
|
|
<!-- iframe showing the search results (closed by default) -->
|
|
<div id="MSearchResultsWindow">
|
|
<div id="MSearchResults">
|
|
<div class="SRPage">
|
|
<div id="SRIndex">
|
|
<div id="SRResults"></div>
|
|
<div class="SRStatus" id="Loading">Loading...</div>
|
|
<div class="SRStatus" id="Searching">Searching...</div>
|
|
<div class="SRStatus" id="NoMatches">No Matches</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div id="nav-path" class="navpath">
|
|
<ul>
|
|
<li class="navelem"><a class="el" href="namespacesf.html">sf</a></li><li class="navelem"><a class="el" href="classsf_1_1UdpSocket.html">UdpSocket</a></li> </ul>
|
|
</div>
|
|
</div><!-- top -->
|
|
<div id="doc-content">
|
|
<div class="header">
|
|
<div class="summary">
|
|
<a href="#pub-types">Public Types</a> |
|
|
<a href="#pub-methods">Public Member Functions</a> |
|
|
<a href="#pub-static-attribs">Static Public Attributes</a> |
|
|
<a href="#pro-types">Protected Types</a> |
|
|
<a href="#pro-methods">Protected Member Functions</a> |
|
|
<a href="classsf_1_1UdpSocket-members.html">List of all members</a> </div>
|
|
<div class="headertitle"><div class="title">sf::UdpSocket Class Reference<div class="ingroups"><a class="el" href="group__network.html">Network module</a></div></div></div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
|
|
<p>Specialized socket using the UDP protocol.
|
|
<a href="#details">More...</a></p>
|
|
|
|
<p><code>#include <<a class="el" href="UdpSocket_8hpp_source.html">SFML/Network/UdpSocket.hpp</a>></code></p>
|
|
<div class="dynheader">
|
|
Inheritance diagram for sf::UdpSocket:</div>
|
|
<div class="dyncontent">
|
|
<div class="center">
|
|
<img src="classsf_1_1UdpSocket.png" usemap="#sf::UdpSocket_map" alt=""/>
|
|
<map id="sf::UdpSocket_map" name="sf::UdpSocket_map">
|
|
<area href="classsf_1_1Socket.html" title="Base class for all the socket types." alt="sf::Socket" shape="rect" coords="0,0,88,24"/>
|
|
</map>
|
|
</div></div>
|
|
<table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pub-types" name="pub-types"></a>
|
|
Public Types</h2></td></tr>
|
|
<tr class="memitem:a51bf0fd51057b98a10fbb866246176dc" id="r_a51bf0fd51057b98a10fbb866246176dc"><td class="memItemLeft" align="right" valign="top">enum class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> { <br />
|
|
  <a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dcaf92965e2c8a7afb3c1b9a5c09a263636">Done</a>
|
|
, <a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dcadd353567e8118a2b8df4e822e59084ab">NotReady</a>
|
|
, <a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dca44ffd38a6dea695cbe2b34efdcc6cf27">Partial</a>
|
|
, <a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dcaef70e46fd3bbc21e3e1f0b6815e750c0">Disconnected</a>
|
|
, <br />
|
|
  <a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dca902b0d55fddef6f8d651fe1035b7d4bd">Error</a>
|
|
<br />
|
|
}</td></tr>
|
|
<tr class="memdesc:a51bf0fd51057b98a10fbb866246176dc"><td class="mdescLeft"> </td><td class="mdescRight">Status codes that may be returned by socket functions. <a href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">More...</a><br /></td></tr>
|
|
<tr class="separator:a51bf0fd51057b98a10fbb866246176dc"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pub-methods" name="pub-methods"></a>
|
|
Public Member Functions</h2></td></tr>
|
|
<tr class="memitem:abb10725e26dee9d3a8165fe87ffb71bb" id="r_abb10725e26dee9d3a8165fe87ffb71bb"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#abb10725e26dee9d3a8165fe87ffb71bb">UdpSocket</a> ()</td></tr>
|
|
<tr class="memdesc:abb10725e26dee9d3a8165fe87ffb71bb"><td class="mdescLeft"> </td><td class="mdescRight">Default constructor. <br /></td></tr>
|
|
<tr class="separator:abb10725e26dee9d3a8165fe87ffb71bb"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a5c03644b3da34bb763bce93e758c938e" id="r_a5c03644b3da34bb763bce93e758c938e"><td class="memItemLeft" align="right" valign="top">unsigned short </td><td class="memItemRight" valign="bottom"><a class="el" href="#a5c03644b3da34bb763bce93e758c938e">getLocalPort</a> () const</td></tr>
|
|
<tr class="memdesc:a5c03644b3da34bb763bce93e758c938e"><td class="mdescLeft"> </td><td class="mdescRight">Get the port to which the socket is bound locally. <br /></td></tr>
|
|
<tr class="separator:a5c03644b3da34bb763bce93e758c938e"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a1bd7b273613665d5ef4dcecf5767ed75" id="r_a1bd7b273613665d5ef4dcecf5767ed75"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#a1bd7b273613665d5ef4dcecf5767ed75">bind</a> (unsigned short port, <a class="el" href="classsf_1_1IpAddress.html">IpAddress</a> address=<a class="el" href="classsf_1_1IpAddress.html#a3dbc10b0dc6804cc69e29342f7406907">IpAddress::Any</a>)</td></tr>
|
|
<tr class="memdesc:a1bd7b273613665d5ef4dcecf5767ed75"><td class="mdescLeft"> </td><td class="mdescRight">Bind the socket to a specific port. <br /></td></tr>
|
|
<tr class="separator:a1bd7b273613665d5ef4dcecf5767ed75"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a2c4abb8102a1bd31f51fcfe7f15427a3" id="r_a2c4abb8102a1bd31f51fcfe7f15427a3"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="#a2c4abb8102a1bd31f51fcfe7f15427a3">unbind</a> ()</td></tr>
|
|
<tr class="memdesc:a2c4abb8102a1bd31f51fcfe7f15427a3"><td class="mdescLeft"> </td><td class="mdescRight">Unbind the socket from the local port to which it is bound. <br /></td></tr>
|
|
<tr class="separator:a2c4abb8102a1bd31f51fcfe7f15427a3"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a78b46f2a2345284339367bb44bab78cf" id="r_a78b46f2a2345284339367bb44bab78cf"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#a78b46f2a2345284339367bb44bab78cf">send</a> (const void *data, std::size_t size, <a class="el" href="classsf_1_1IpAddress.html">IpAddress</a> remoteAddress, unsigned short remotePort)</td></tr>
|
|
<tr class="memdesc:a78b46f2a2345284339367bb44bab78cf"><td class="mdescLeft"> </td><td class="mdescRight">Send raw data to a remote peer. <br /></td></tr>
|
|
<tr class="separator:a78b46f2a2345284339367bb44bab78cf"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a3fdcfaf926ae4de72ab59573b408169d" id="r_a3fdcfaf926ae4de72ab59573b408169d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#a3fdcfaf926ae4de72ab59573b408169d">receive</a> (void *data, std::size_t size, std::size_t &received, std::optional< <a class="el" href="classsf_1_1IpAddress.html">IpAddress</a> > &remoteAddress, unsigned short &remotePort)</td></tr>
|
|
<tr class="memdesc:a3fdcfaf926ae4de72ab59573b408169d"><td class="mdescLeft"> </td><td class="mdescRight">Receive raw data from a remote peer. <br /></td></tr>
|
|
<tr class="separator:a3fdcfaf926ae4de72ab59573b408169d"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:aaaff67d1056fa46ca778db97eb0d5b6d" id="r_aaaff67d1056fa46ca778db97eb0d5b6d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#aaaff67d1056fa46ca778db97eb0d5b6d">send</a> (<a class="el" href="classsf_1_1Packet.html">Packet</a> &packet, <a class="el" href="classsf_1_1IpAddress.html">IpAddress</a> remoteAddress, unsigned short remotePort)</td></tr>
|
|
<tr class="memdesc:aaaff67d1056fa46ca778db97eb0d5b6d"><td class="mdescLeft"> </td><td class="mdescRight">Send a formatted packet of data to a remote peer. <br /></td></tr>
|
|
<tr class="separator:aaaff67d1056fa46ca778db97eb0d5b6d"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a45fcae65cd694d9674f60c2479ffea30" id="r_a45fcae65cd694d9674f60c2479ffea30"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#a45fcae65cd694d9674f60c2479ffea30">receive</a> (<a class="el" href="classsf_1_1Packet.html">Packet</a> &packet, std::optional< <a class="el" href="classsf_1_1IpAddress.html">IpAddress</a> > &remoteAddress, unsigned short &remotePort)</td></tr>
|
|
<tr class="memdesc:a45fcae65cd694d9674f60c2479ffea30"><td class="mdescLeft"> </td><td class="mdescRight">Receive a formatted packet of data from a remote peer. <br /></td></tr>
|
|
<tr class="separator:a45fcae65cd694d9674f60c2479ffea30"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a165fc1423e281ea2714c70303d3a9782" id="r_a165fc1423e281ea2714c70303d3a9782"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classsf_1_1Socket.html#a165fc1423e281ea2714c70303d3a9782">setBlocking</a> (bool blocking)</td></tr>
|
|
<tr class="memdesc:a165fc1423e281ea2714c70303d3a9782"><td class="mdescLeft"> </td><td class="mdescRight">Set the blocking state of the socket. <br /></td></tr>
|
|
<tr class="separator:a165fc1423e281ea2714c70303d3a9782"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ab1ceca9ac114b8baeeda3b34a0aca468" id="r_ab1ceca9ac114b8baeeda3b34a0aca468"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classsf_1_1Socket.html#ab1ceca9ac114b8baeeda3b34a0aca468">isBlocking</a> () const</td></tr>
|
|
<tr class="memdesc:ab1ceca9ac114b8baeeda3b34a0aca468"><td class="mdescLeft"> </td><td class="mdescRight">Tell whether the socket is in blocking or non-blocking mode. <br /></td></tr>
|
|
<tr class="separator:ab1ceca9ac114b8baeeda3b34a0aca468"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pub-static-attribs" name="pub-static-attribs"></a>
|
|
Static Public Attributes</h2></td></tr>
|
|
<tr class="memitem:a9a3612a4e887e10dbf396d2945b37548" id="r_a9a3612a4e887e10dbf396d2945b37548"><td class="memItemLeft" align="right" valign="top">static constexpr std::size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="#a9a3612a4e887e10dbf396d2945b37548">MaxDatagramSize</a> {65507}</td></tr>
|
|
<tr class="memdesc:a9a3612a4e887e10dbf396d2945b37548"><td class="mdescLeft"> </td><td class="mdescRight">The maximum number of bytes that can be sent in a single UDP datagram. <br /></td></tr>
|
|
<tr class="separator:a9a3612a4e887e10dbf396d2945b37548"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a16dfada3e5ba1773ac434bc70510221f" id="r_a16dfada3e5ba1773ac434bc70510221f"><td class="memItemLeft" align="right" valign="top">static constexpr unsigned short </td><td class="memItemRight" valign="bottom"><a class="el" href="classsf_1_1Socket.html#a16dfada3e5ba1773ac434bc70510221f">AnyPort</a> {0}</td></tr>
|
|
<tr class="memdesc:a16dfada3e5ba1773ac434bc70510221f"><td class="mdescLeft"> </td><td class="mdescRight">Some special values used by sockets. <br /></td></tr>
|
|
<tr class="separator:a16dfada3e5ba1773ac434bc70510221f"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pro-types" name="pro-types"></a>
|
|
Protected Types</h2></td></tr>
|
|
<tr class="memitem:a5d3ff44e56e68f02816bb0fabc34adf8" id="r_a5d3ff44e56e68f02816bb0fabc34adf8"><td class="memItemLeft" align="right" valign="top">enum class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classsf_1_1Socket.html#a5d3ff44e56e68f02816bb0fabc34adf8">Type</a> { <a class="el" href="classsf_1_1Socket.html#a5d3ff44e56e68f02816bb0fabc34adf8a30b7fdeebc36988717d0e274cc2e7520">Tcp</a>
|
|
, <a class="el" href="classsf_1_1Socket.html#a5d3ff44e56e68f02816bb0fabc34adf8a81baba40274ccb30f9fdfa2c73cf0482">Udp</a>
|
|
}</td></tr>
|
|
<tr class="memdesc:a5d3ff44e56e68f02816bb0fabc34adf8"><td class="mdescLeft"> </td><td class="mdescRight">Types of protocols that the socket can use. <a href="classsf_1_1Socket.html#a5d3ff44e56e68f02816bb0fabc34adf8">More...</a><br /></td></tr>
|
|
<tr class="separator:a5d3ff44e56e68f02816bb0fabc34adf8"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pro-methods" name="pro-methods"></a>
|
|
Protected Member Functions</h2></td></tr>
|
|
<tr class="memitem:a67fe286629b47a62c723478b846ab2c4" id="r_a67fe286629b47a62c723478b846ab2c4"><td class="memItemLeft" align="right" valign="top"><a class="el" href="namespacesf.html#a7403828dc19b7052b988d22c841ae92d">SocketHandle</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classsf_1_1Socket.html#a67fe286629b47a62c723478b846ab2c4">getNativeHandle</a> () const</td></tr>
|
|
<tr class="memdesc:a67fe286629b47a62c723478b846ab2c4"><td class="mdescLeft"> </td><td class="mdescRight">Return the internal handle of the socket. <br /></td></tr>
|
|
<tr class="separator:a67fe286629b47a62c723478b846ab2c4"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:aafbe140f4b1921e0d19e88cf7a61dcbc" id="r_aafbe140f4b1921e0d19e88cf7a61dcbc"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classsf_1_1Socket.html#aafbe140f4b1921e0d19e88cf7a61dcbc">create</a> ()</td></tr>
|
|
<tr class="memdesc:aafbe140f4b1921e0d19e88cf7a61dcbc"><td class="mdescLeft"> </td><td class="mdescRight">Create the internal representation of the socket. <br /></td></tr>
|
|
<tr class="separator:aafbe140f4b1921e0d19e88cf7a61dcbc"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:af1dd898f7aa3ead7ff7b2d1c20e97781" id="r_af1dd898f7aa3ead7ff7b2d1c20e97781"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classsf_1_1Socket.html#af1dd898f7aa3ead7ff7b2d1c20e97781">create</a> (<a class="el" href="namespacesf.html#a7403828dc19b7052b988d22c841ae92d">SocketHandle</a> handle)</td></tr>
|
|
<tr class="memdesc:af1dd898f7aa3ead7ff7b2d1c20e97781"><td class="mdescLeft"> </td><td class="mdescRight">Create the internal representation of the socket from a socket handle. <br /></td></tr>
|
|
<tr class="separator:af1dd898f7aa3ead7ff7b2d1c20e97781"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a71f2f5c2aa99e01cafe824fee4c573be" id="r_a71f2f5c2aa99e01cafe824fee4c573be"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classsf_1_1Socket.html#a71f2f5c2aa99e01cafe824fee4c573be">close</a> ()</td></tr>
|
|
<tr class="memdesc:a71f2f5c2aa99e01cafe824fee4c573be"><td class="mdescLeft"> </td><td class="mdescRight">Close the socket gracefully. <br /></td></tr>
|
|
<tr class="separator:a71f2f5c2aa99e01cafe824fee4c573be"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table>
|
|
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
|
|
<div class="textblock"><p>Specialized socket using the UDP protocol. </p>
|
|
<p>A UDP socket is a connectionless socket.</p>
|
|
<p>Instead of connecting once to a remote host, like TCP sockets, it can send to and receive from any host at any time.</p>
|
|
<p>It is a datagram protocol: bounded blocks of data (datagrams) are transferred over the network rather than a continuous stream of data (TCP). Therefore, one call to send will always match one call to receive (if the datagram is not lost), with the same data that was sent.</p>
|
|
<p>The UDP protocol is lightweight but unreliable. Unreliable means that datagrams may be duplicated, be lost or arrive reordered. However, if a datagram arrives, its data is guaranteed to be valid.</p>
|
|
<p>UDP is generally used for real-time communication (audio or video streaming, real-time games, etc.) where speed is crucial and lost data doesn't matter much.</p>
|
|
<p>Sending and receiving data can use either the low-level or the high-level functions. The low-level functions process a raw sequence of bytes, whereas the high-level interface uses packets (see <code><a class="el" href="classsf_1_1Packet.html" title="Utility class to build blocks of data to transfer over the network.">sf::Packet</a></code>), which are easier to use and provide more safety regarding the data that is exchanged. You can look at the <code><a class="el" href="classsf_1_1Packet.html" title="Utility class to build blocks of data to transfer over the network.">sf::Packet</a></code> class to get more details about how they work.</p>
|
|
<p>It is important to note that <code><a class="el" href="classsf_1_1UdpSocket.html" title="Specialized socket using the UDP protocol.">UdpSocket</a></code> is unable to send datagrams bigger than <code>MaxDatagramSize</code>. In this case, it returns an error and doesn't send anything. This applies to both raw data and packets. Indeed, even packets are unable to split and recompose data, due to the unreliability of the protocol (dropped, mixed or duplicated datagrams may lead to a big mess when trying to recompose a packet).</p>
|
|
<p>If the socket is bound to a port, it is automatically unbound from it when the socket is destroyed. However, you can unbind the socket explicitly with the Unbind function if necessary, to stop receiving messages or make the port available for other sockets.</p>
|
|
<p>Usage example: </p><div class="fragment"><div class="line"><span class="comment">// ----- The client -----</span></div>
|
|
<div class="line"> </div>
|
|
<div class="line"><span class="comment">// Create a socket and bind it to the port 55001</span></div>
|
|
<div class="line"><a class="code hl_class" href="classsf_1_1UdpSocket.html">sf::UdpSocket</a> socket;</div>
|
|
<div class="line">socket.<a class="code hl_function" href="#a1bd7b273613665d5ef4dcecf5767ed75">bind</a>(55001);</div>
|
|
<div class="line"> </div>
|
|
<div class="line"><span class="comment">// Send a message to 192.168.1.50 on port 55002</span></div>
|
|
<div class="line">std::string message = <span class="stringliteral">"Hi, I am "</span> + <a class="code hl_function" href="classsf_1_1IpAddress.html#a3076aa9ae952698930cb886d1ab0a1cc">sf::IpAddress::getLocalAddress</a>().toString();</div>
|
|
<div class="line">socket.<a class="code hl_function" href="#a78b46f2a2345284339367bb44bab78cf">send</a>(message.c_str(), message.size() + 1, <span class="stringliteral">"192.168.1.50"</span>, 55002);</div>
|
|
<div class="line"> </div>
|
|
<div class="line"><span class="comment">// Receive an answer (most likely from 192.168.1.50, but could be anyone else)</span></div>
|
|
<div class="line">std::array<char, 1024> buffer;</div>
|
|
<div class="line">std::size_t received = 0;</div>
|
|
<div class="line">std::optional<sf::IpAddress> sender;</div>
|
|
<div class="line"><span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> port;</div>
|
|
<div class="line"><span class="keywordflow">if</span> (socket.<a class="code hl_function" href="#a3fdcfaf926ae4de72ab59573b408169d">receive</a>(buffer.data(), buffer.size(), received, sender, port) == <a class="code hl_enumvalue" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dcaf92965e2c8a7afb3c1b9a5c09a263636">sf::Socket::Status::Done</a>)</div>
|
|
<div class="line"> std::cout << sender->toString() << <span class="stringliteral">" said: "</span> << buffer.data() << std::endl;</div>
|
|
<div class="line"> </div>
|
|
<div class="line"><span class="comment">// ----- The server -----</span></div>
|
|
<div class="line"> </div>
|
|
<div class="line"><span class="comment">// Create a socket and bind it to the port 55002</span></div>
|
|
<div class="line"><a class="code hl_class" href="classsf_1_1UdpSocket.html">sf::UdpSocket</a> socket;</div>
|
|
<div class="line">socket.<a class="code hl_function" href="#a1bd7b273613665d5ef4dcecf5767ed75">bind</a>(55002);</div>
|
|
<div class="line"> </div>
|
|
<div class="line"><span class="comment">// Receive a message from anyone</span></div>
|
|
<div class="line">std::array<char, 1024> buffer;</div>
|
|
<div class="line">std::size_t received = 0;</div>
|
|
<div class="line">std::optional<sf::IpAddress> sender;</div>
|
|
<div class="line"><span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> port;</div>
|
|
<div class="line"><span class="keywordflow">if</span> (socket.<a class="code hl_function" href="#a3fdcfaf926ae4de72ab59573b408169d">receive</a>(buffer.data(), buffer.size(), received, sender, port) == <a class="code hl_enumvalue" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dcaf92965e2c8a7afb3c1b9a5c09a263636">sf::Socket::Status::Done</a>)</div>
|
|
<div class="line"> std::cout << sender->toString() << <span class="stringliteral">" said: "</span> << buffer.data() << std::endl;</div>
|
|
<div class="line"> </div>
|
|
<div class="line"><span class="comment">// Send an answer</span></div>
|
|
<div class="line">std::string message = <span class="stringliteral">"Welcome "</span> + sender.toString();</div>
|
|
<div class="line">socket.<a class="code hl_function" href="#a78b46f2a2345284339367bb44bab78cf">send</a>(message.c_str(), message.size() + 1, sender, port);</div>
|
|
<div class="ttc" id="aclasssf_1_1IpAddress_html_a3076aa9ae952698930cb886d1ab0a1cc"><div class="ttname"><a href="classsf_1_1IpAddress.html#a3076aa9ae952698930cb886d1ab0a1cc">sf::IpAddress::getLocalAddress</a></div><div class="ttdeci">static std::optional< IpAddress > getLocalAddress()</div><div class="ttdoc">Get the computer's local address.</div></div>
|
|
<div class="ttc" id="aclasssf_1_1Socket_html_a51bf0fd51057b98a10fbb866246176dcaf92965e2c8a7afb3c1b9a5c09a263636"><div class="ttname"><a href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dcaf92965e2c8a7afb3c1b9a5c09a263636">sf::Socket::Status::Done</a></div><div class="ttdeci">@ Done</div><div class="ttdoc">The socket has sent / received the data.</div></div>
|
|
<div class="ttc" id="aclasssf_1_1UdpSocket_html"><div class="ttname"><a href="classsf_1_1UdpSocket.html">sf::UdpSocket</a></div><div class="ttdoc">Specialized socket using the UDP protocol.</div><div class="ttdef"><b>Definition</b> <a href="UdpSocket_8hpp_source.html#l00049">UdpSocket.hpp:50</a></div></div>
|
|
<div class="ttc" id="aclasssf_1_1UdpSocket_html_a1bd7b273613665d5ef4dcecf5767ed75"><div class="ttname"><a href="#a1bd7b273613665d5ef4dcecf5767ed75">sf::UdpSocket::bind</a></div><div class="ttdeci">Status bind(unsigned short port, IpAddress address=IpAddress::Any)</div><div class="ttdoc">Bind the socket to a specific port.</div></div>
|
|
<div class="ttc" id="aclasssf_1_1UdpSocket_html_a3fdcfaf926ae4de72ab59573b408169d"><div class="ttname"><a href="#a3fdcfaf926ae4de72ab59573b408169d">sf::UdpSocket::receive</a></div><div class="ttdeci">Status receive(void *data, std::size_t size, std::size_t &received, std::optional< IpAddress > &remoteAddress, unsigned short &remotePort)</div><div class="ttdoc">Receive raw data from a remote peer.</div></div>
|
|
<div class="ttc" id="aclasssf_1_1UdpSocket_html_a78b46f2a2345284339367bb44bab78cf"><div class="ttname"><a href="#a78b46f2a2345284339367bb44bab78cf">sf::UdpSocket::send</a></div><div class="ttdeci">Status send(const void *data, std::size_t size, IpAddress remoteAddress, unsigned short remotePort)</div><div class="ttdoc">Send raw data to a remote peer.</div></div>
|
|
</div><!-- fragment --><dl class="section see"><dt>See also</dt><dd><code><a class="el" href="classsf_1_1Socket.html" title="Base class for all the socket types.">sf::Socket</a></code>, <code><a class="el" href="classsf_1_1TcpSocket.html" title="Specialized socket using the TCP protocol.">sf::TcpSocket</a></code>, <code><a class="el" href="classsf_1_1Packet.html" title="Utility class to build blocks of data to transfer over the network.">sf::Packet</a></code> </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="UdpSocket_8hpp_source.html#l00049">49</a> of file <a class="el" href="UdpSocket_8hpp_source.html">UdpSocket.hpp</a>.</p>
|
|
</div><h2 class="groupheader">Member Enumeration Documentation</h2>
|
|
<a id="a51bf0fd51057b98a10fbb866246176dc" name="a51bf0fd51057b98a10fbb866246176dc"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a51bf0fd51057b98a10fbb866246176dc">◆ </a></span>Status</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">enum class <a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">sf::Socket::Status</a></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">strong</span><span class="mlabel">inherited</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Status codes that may be returned by socket functions. </p>
|
|
<table class="fieldtable">
|
|
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a51bf0fd51057b98a10fbb866246176dcaf92965e2c8a7afb3c1b9a5c09a263636" name="a51bf0fd51057b98a10fbb866246176dcaf92965e2c8a7afb3c1b9a5c09a263636"></a>Done </td><td class="fielddoc"><p>The socket has sent / received the data. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><a id="a51bf0fd51057b98a10fbb866246176dcadd353567e8118a2b8df4e822e59084ab" name="a51bf0fd51057b98a10fbb866246176dcadd353567e8118a2b8df4e822e59084ab"></a>NotReady </td><td class="fielddoc"><p>The socket is not ready to send / receive data yet. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><a id="a51bf0fd51057b98a10fbb866246176dca44ffd38a6dea695cbe2b34efdcc6cf27" name="a51bf0fd51057b98a10fbb866246176dca44ffd38a6dea695cbe2b34efdcc6cf27"></a>Partial </td><td class="fielddoc"><p>The socket sent a part of the data. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><a id="a51bf0fd51057b98a10fbb866246176dcaef70e46fd3bbc21e3e1f0b6815e750c0" name="a51bf0fd51057b98a10fbb866246176dcaef70e46fd3bbc21e3e1f0b6815e750c0"></a>Disconnected </td><td class="fielddoc"><p>The TCP socket has been disconnected. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><a id="a51bf0fd51057b98a10fbb866246176dca902b0d55fddef6f8d651fe1035b7d4bd" name="a51bf0fd51057b98a10fbb866246176dca902b0d55fddef6f8d651fe1035b7d4bd"></a>Error </td><td class="fielddoc"><p>An unexpected error happened. </p>
|
|
</td></tr>
|
|
</table>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="Socket_8hpp_source.html#l00048">48</a> of file <a class="el" href="Socket_8hpp_source.html">Socket.hpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a5d3ff44e56e68f02816bb0fabc34adf8" name="a5d3ff44e56e68f02816bb0fabc34adf8"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a5d3ff44e56e68f02816bb0fabc34adf8">◆ </a></span>Type</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">enum class <a class="el" href="classsf_1_1Socket.html#a5d3ff44e56e68f02816bb0fabc34adf8">sf::Socket::Type</a></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">strong</span><span class="mlabel">protected</span><span class="mlabel">inherited</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Types of protocols that the socket can use. </p>
|
|
<table class="fieldtable">
|
|
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a5d3ff44e56e68f02816bb0fabc34adf8a30b7fdeebc36988717d0e274cc2e7520" name="a5d3ff44e56e68f02816bb0fabc34adf8a30b7fdeebc36988717d0e274cc2e7520"></a>Tcp </td><td class="fielddoc"><p>TCP protocol. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><a id="a5d3ff44e56e68f02816bb0fabc34adf8a81baba40274ccb30f9fdfa2c73cf0482" name="a5d3ff44e56e68f02816bb0fabc34adf8a81baba40274ccb30f9fdfa2c73cf0482"></a>Udp </td><td class="fielddoc"><p>UDP protocol. </p>
|
|
</td></tr>
|
|
</table>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="Socket_8hpp_source.html#l00128">128</a> of file <a class="el" href="Socket_8hpp_source.html">Socket.hpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Constructor & Destructor Documentation</h2>
|
|
<a id="abb10725e26dee9d3a8165fe87ffb71bb" name="abb10725e26dee9d3a8165fe87ffb71bb"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#abb10725e26dee9d3a8165fe87ffb71bb">◆ </a></span>UdpSocket()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">sf::UdpSocket::UdpSocket </td>
|
|
<td>(</td>
|
|
<td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Default constructor. </p>
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Member Function Documentation</h2>
|
|
<a id="a1bd7b273613665d5ef4dcecf5767ed75" name="a1bd7b273613665d5ef4dcecf5767ed75"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a1bd7b273613665d5ef4dcecf5767ed75">◆ </a></span>bind()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> sf::UdpSocket::bind </td>
|
|
<td>(</td>
|
|
<td class="paramtype">unsigned short</td> <td class="paramname"><span class="paramname"><em>port</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="classsf_1_1IpAddress.html">IpAddress</a></td> <td class="paramname"><span class="paramname"><em>address</em></span><span class="paramdefsep"> = </span><span class="paramdefval"><a class="el" href="classsf_1_1IpAddress.html#a3dbc10b0dc6804cc69e29342f7406907">IpAddress::Any</a></span> )</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">nodiscard</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Bind the socket to a specific port. </p>
|
|
<p>Binding the socket to a port is necessary for being able to receive data on that port.</p>
|
|
<p>When providing <code><a class="el" href="classsf_1_1Socket.html#a16dfada3e5ba1773ac434bc70510221f" title="Some special values used by sockets.">sf::Socket::AnyPort</a></code> as port, the listener will request an available port from the system. The chosen port can be retrieved by calling <code><a class="el" href="#a5c03644b3da34bb763bce93e758c938e" title="Get the port to which the socket is bound locally.">getLocalPort()</a></code>.</p>
|
|
<p>Since the socket can only be bound to a single port at any given moment, if it is already bound when this function is called, it will be unbound from the previous port before being bound to the new one.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">port</td><td>Port to bind the socket to </td></tr>
|
|
<tr><td class="paramname">address</td><td>Address of the interface to bind to</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>Status code</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><code><a class="el" href="#a2c4abb8102a1bd31f51fcfe7f15427a3" title="Unbind the socket from the local port to which it is bound.">unbind</a></code>, <code><a class="el" href="#a5c03644b3da34bb763bce93e758c938e" title="Get the port to which the socket is bound locally.">getLocalPort</a></code> </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a71f2f5c2aa99e01cafe824fee4c573be" name="a71f2f5c2aa99e01cafe824fee4c573be"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a71f2f5c2aa99e01cafe824fee4c573be">◆ </a></span>close()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void sf::Socket::close </td>
|
|
<td>(</td>
|
|
<td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">inherited</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Close the socket gracefully. </p>
|
|
<p>This function can only be accessed by derived classes. </p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="aafbe140f4b1921e0d19e88cf7a61dcbc" name="aafbe140f4b1921e0d19e88cf7a61dcbc"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#aafbe140f4b1921e0d19e88cf7a61dcbc">◆ </a></span>create() <span class="overload">[1/2]</span></h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void sf::Socket::create </td>
|
|
<td>(</td>
|
|
<td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">inherited</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Create the internal representation of the socket. </p>
|
|
<p>This function can only be accessed by derived classes. </p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="af1dd898f7aa3ead7ff7b2d1c20e97781" name="af1dd898f7aa3ead7ff7b2d1c20e97781"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#af1dd898f7aa3ead7ff7b2d1c20e97781">◆ </a></span>create() <span class="overload">[2/2]</span></h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void sf::Socket::create </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="namespacesf.html#a7403828dc19b7052b988d22c841ae92d">SocketHandle</a></td> <td class="paramname"><span class="paramname"><em>handle</em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">inherited</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Create the internal representation of the socket from a socket handle. </p>
|
|
<p>This function can only be accessed by derived classes.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">handle</td><td>OS-specific handle of the socket to wrap </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a5c03644b3da34bb763bce93e758c938e" name="a5c03644b3da34bb763bce93e758c938e"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a5c03644b3da34bb763bce93e758c938e">◆ </a></span>getLocalPort()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">unsigned short sf::UdpSocket::getLocalPort </td>
|
|
<td>(</td>
|
|
<td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td> const</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">nodiscard</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get the port to which the socket is bound locally. </p>
|
|
<p>If the socket is not bound to a port, this function returns 0.</p>
|
|
<dl class="section return"><dt>Returns</dt><dd>Port to which the socket is bound</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><code><a class="el" href="#a1bd7b273613665d5ef4dcecf5767ed75" title="Bind the socket to a specific port.">bind</a></code> </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a67fe286629b47a62c723478b846ab2c4" name="a67fe286629b47a62c723478b846ab2c4"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a67fe286629b47a62c723478b846ab2c4">◆ </a></span>getNativeHandle()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="namespacesf.html#a7403828dc19b7052b988d22c841ae92d">SocketHandle</a> sf::Socket::getNativeHandle </td>
|
|
<td>(</td>
|
|
<td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td> const</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">nodiscard</span><span class="mlabel">protected</span><span class="mlabel">inherited</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Return the internal handle of the socket. </p>
|
|
<p>The returned handle may be invalid if the socket was not created yet (or already destroyed). This function can only be accessed by derived classes.</p>
|
|
<dl class="section return"><dt>Returns</dt><dd>The internal (OS-specific) handle of the socket </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="ab1ceca9ac114b8baeeda3b34a0aca468" name="ab1ceca9ac114b8baeeda3b34a0aca468"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#ab1ceca9ac114b8baeeda3b34a0aca468">◆ </a></span>isBlocking()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">bool sf::Socket::isBlocking </td>
|
|
<td>(</td>
|
|
<td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td> const</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">nodiscard</span><span class="mlabel">inherited</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Tell whether the socket is in blocking or non-blocking mode. </p>
|
|
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if the socket is blocking, <code>false</code> otherwise</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><code><a class="el" href="classsf_1_1Socket.html#a165fc1423e281ea2714c70303d3a9782" title="Set the blocking state of the socket.">setBlocking</a></code> </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a45fcae65cd694d9674f60c2479ffea30" name="a45fcae65cd694d9674f60c2479ffea30"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a45fcae65cd694d9674f60c2479ffea30">◆ </a></span>receive() <span class="overload">[1/2]</span></h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> sf::UdpSocket::receive </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="classsf_1_1Packet.html">Packet</a> &</td> <td class="paramname"><span class="paramname"><em>packet</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">std::optional< <a class="el" href="classsf_1_1IpAddress.html">IpAddress</a> > &</td> <td class="paramname"><span class="paramname"><em>remoteAddress</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">unsigned short &</td> <td class="paramname"><span class="paramname"><em>remotePort</em></span> )</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">nodiscard</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Receive a formatted packet of data from a remote peer. </p>
|
|
<p>In blocking mode, this function will wait until the whole packet has been received.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">packet</td><td><a class="el" href="classsf_1_1Packet.html" title="Utility class to build blocks of data to transfer over the network.">Packet</a> to fill with the received data </td></tr>
|
|
<tr><td class="paramname">remoteAddress</td><td>Address of the peer that sent the data </td></tr>
|
|
<tr><td class="paramname">remotePort</td><td>Port of the peer that sent the data</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>Status code</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><code><a class="el" href="#a78b46f2a2345284339367bb44bab78cf" title="Send raw data to a remote peer.">send</a></code> </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a3fdcfaf926ae4de72ab59573b408169d" name="a3fdcfaf926ae4de72ab59573b408169d"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a3fdcfaf926ae4de72ab59573b408169d">◆ </a></span>receive() <span class="overload">[2/2]</span></h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> sf::UdpSocket::receive </td>
|
|
<td>(</td>
|
|
<td class="paramtype">void *</td> <td class="paramname"><span class="paramname"><em>data</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">std::size_t</td> <td class="paramname"><span class="paramname"><em>size</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">std::size_t &</td> <td class="paramname"><span class="paramname"><em>received</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">std::optional< <a class="el" href="classsf_1_1IpAddress.html">IpAddress</a> > &</td> <td class="paramname"><span class="paramname"><em>remoteAddress</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">unsigned short &</td> <td class="paramname"><span class="paramname"><em>remotePort</em></span> )</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">nodiscard</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Receive raw data from a remote peer. </p>
|
|
<p>In blocking mode, this function will wait until some bytes are actually received. Be careful to use a buffer which is large enough for the data that you intend to receive, if it is too small then an error will be returned and <em>all</em> the data will be lost.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">data</td><td>Pointer to the array to fill with the received bytes </td></tr>
|
|
<tr><td class="paramname">size</td><td>Maximum number of bytes that can be received </td></tr>
|
|
<tr><td class="paramname">received</td><td>This variable is filled with the actual number of bytes received </td></tr>
|
|
<tr><td class="paramname">remoteAddress</td><td>Address of the peer that sent the data </td></tr>
|
|
<tr><td class="paramname">remotePort</td><td>Port of the peer that sent the data</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>Status code</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><code><a class="el" href="#a78b46f2a2345284339367bb44bab78cf" title="Send raw data to a remote peer.">send</a></code> </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a78b46f2a2345284339367bb44bab78cf" name="a78b46f2a2345284339367bb44bab78cf"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a78b46f2a2345284339367bb44bab78cf">◆ </a></span>send() <span class="overload">[1/2]</span></h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> sf::UdpSocket::send </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const void *</td> <td class="paramname"><span class="paramname"><em>data</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">std::size_t</td> <td class="paramname"><span class="paramname"><em>size</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="classsf_1_1IpAddress.html">IpAddress</a></td> <td class="paramname"><span class="paramname"><em>remoteAddress</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">unsigned short</td> <td class="paramname"><span class="paramname"><em>remotePort</em></span> )</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">nodiscard</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Send raw data to a remote peer. </p>
|
|
<p>Make sure that <code>size</code> is not greater than <code><a class="el" href="#a9a3612a4e887e10dbf396d2945b37548" title="The maximum number of bytes that can be sent in a single UDP datagram.">UdpSocket::MaxDatagramSize</a></code>, otherwise this function will fail and no data will be sent.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">data</td><td>Pointer to the sequence of bytes to send </td></tr>
|
|
<tr><td class="paramname">size</td><td>Number of bytes to send </td></tr>
|
|
<tr><td class="paramname">remoteAddress</td><td>Address of the receiver </td></tr>
|
|
<tr><td class="paramname">remotePort</td><td>Port of the receiver to send the data to</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>Status code</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><code><a class="el" href="#a3fdcfaf926ae4de72ab59573b408169d" title="Receive raw data from a remote peer.">receive</a></code> </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="aaaff67d1056fa46ca778db97eb0d5b6d" name="aaaff67d1056fa46ca778db97eb0d5b6d"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#aaaff67d1056fa46ca778db97eb0d5b6d">◆ </a></span>send() <span class="overload">[2/2]</span></h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="classsf_1_1Socket.html#a51bf0fd51057b98a10fbb866246176dc">Status</a> sf::UdpSocket::send </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="classsf_1_1Packet.html">Packet</a> &</td> <td class="paramname"><span class="paramname"><em>packet</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="classsf_1_1IpAddress.html">IpAddress</a></td> <td class="paramname"><span class="paramname"><em>remoteAddress</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">unsigned short</td> <td class="paramname"><span class="paramname"><em>remotePort</em></span> )</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">nodiscard</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Send a formatted packet of data to a remote peer. </p>
|
|
<p>Make sure that the packet size is not greater than <code><a class="el" href="#a9a3612a4e887e10dbf396d2945b37548" title="The maximum number of bytes that can be sent in a single UDP datagram.">UdpSocket::MaxDatagramSize</a></code>, otherwise this function will fail and no data will be sent.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">packet</td><td><a class="el" href="classsf_1_1Packet.html" title="Utility class to build blocks of data to transfer over the network.">Packet</a> to send </td></tr>
|
|
<tr><td class="paramname">remoteAddress</td><td>Address of the receiver </td></tr>
|
|
<tr><td class="paramname">remotePort</td><td>Port of the receiver to send the data to</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>Status code</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><code><a class="el" href="#a3fdcfaf926ae4de72ab59573b408169d" title="Receive raw data from a remote peer.">receive</a></code> </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a165fc1423e281ea2714c70303d3a9782" name="a165fc1423e281ea2714c70303d3a9782"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a165fc1423e281ea2714c70303d3a9782">◆ </a></span>setBlocking()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void sf::Socket::setBlocking </td>
|
|
<td>(</td>
|
|
<td class="paramtype">bool</td> <td class="paramname"><span class="paramname"><em>blocking</em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">inherited</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Set the blocking state of the socket. </p>
|
|
<p>In blocking mode, calls will not return until they have completed their task. For example, a call to Receive in blocking mode won't return until some data was actually received. In non-blocking mode, calls will always return immediately, using the return code to signal whether there was data available or not. By default, all sockets are blocking.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">blocking</td><td><code>true</code> to set the socket as blocking, <code>false</code> for non-blocking</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section see"><dt>See also</dt><dd><code><a class="el" href="classsf_1_1Socket.html#ab1ceca9ac114b8baeeda3b34a0aca468" title="Tell whether the socket is in blocking or non-blocking mode.">isBlocking</a></code> </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a2c4abb8102a1bd31f51fcfe7f15427a3" name="a2c4abb8102a1bd31f51fcfe7f15427a3"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a2c4abb8102a1bd31f51fcfe7f15427a3">◆ </a></span>unbind()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void sf::UdpSocket::unbind </td>
|
|
<td>(</td>
|
|
<td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Unbind the socket from the local port to which it is bound. </p>
|
|
<p>The port that the socket was previously bound to is immediately made available to the operating system after this function is called. This means that a subsequent call to <code><a class="el" href="#a1bd7b273613665d5ef4dcecf5767ed75" title="Bind the socket to a specific port.">bind()</a></code> will be able to re-bind the port if no other process has done so in the mean time. If the socket is not bound to a port, this function has no effect.</p>
|
|
<dl class="section see"><dt>See also</dt><dd><code><a class="el" href="#a1bd7b273613665d5ef4dcecf5767ed75" title="Bind the socket to a specific port.">bind</a></code> </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Member Data Documentation</h2>
|
|
<a id="a16dfada3e5ba1773ac434bc70510221f" name="a16dfada3e5ba1773ac434bc70510221f"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a16dfada3e5ba1773ac434bc70510221f">◆ </a></span>AnyPort</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">unsigned short sf::Socket::AnyPort {0}</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">static</span><span class="mlabel">constexpr</span><span class="mlabel">inherited</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Some special values used by sockets. </p>
|
|
<p>Special value that tells the system to pick any available port </p>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="Socket_8hpp_source.html#l00062">62</a> of file <a class="el" href="Socket_8hpp_source.html">Socket.hpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a9a3612a4e887e10dbf396d2945b37548" name="a9a3612a4e887e10dbf396d2945b37548"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a9a3612a4e887e10dbf396d2945b37548">◆ </a></span>MaxDatagramSize</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">std::size_t sf::UdpSocket::MaxDatagramSize {65507}</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">static</span><span class="mlabel">constexpr</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>The maximum number of bytes that can be sent in a single UDP datagram. </p>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="UdpSocket_8hpp_source.html#l00056">56</a> of file <a class="el" href="UdpSocket_8hpp_source.html">UdpSocket.hpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<hr/>The documentation for this class was generated from the following file:<ul>
|
|
<li><a class="el" href="UdpSocket_8hpp_source.html">UdpSocket.hpp</a></li>
|
|
</ul>
|
|
</div><!-- contents -->
|
|
</div>
|
|
<div id="footer-container">
|
|
<div id="footer">
|
|
SFML is licensed under the terms and conditions of the <a href="https://www.sfml-dev.org/license.php">zlib/png license</a>.<br />
|
|
Copyright © Laurent Gomila ::
|
|
Documentation generated by <a href="http://www.doxygen.org/" title="doxygen website">doxygen</a> ::
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|