summaryrefslogtreecommitdiff
path: root/man/v1.8.0/nng_socket_id.3.html
diff options
context:
space:
mode:
authorStaysail Systems, Inc. <info@staysail.tech>2024-04-21 12:37:34 -0700
committerGarrett D'Amore <garrett@damore.org>2024-04-21 12:42:38 -0700
commit306f54bfff5b7ecac660a652e3ca17e5d226c6ff (patch)
tree3ee6571ddb9143dab08d8b9f830bc46bc77c9bf9 /man/v1.8.0/nng_socket_id.3.html
parent397cf9c1fa26b9efb10cef3b89acdc597b164753 (diff)
downloadnng-306f54bfff5b7ecac660a652e3ca17e5d226c6ff.tar.gz
nng-306f54bfff5b7ecac660a652e3ca17e5d226c6ff.tar.bz2
nng-306f54bfff5b7ecac660a652e3ca17e5d226c6ff.zip
Manual page updates for v1.8.0
Diffstat (limited to 'man/v1.8.0/nng_socket_id.3.html')
-rw-r--r--man/v1.8.0/nng_socket_id.3.html79
1 files changed, 79 insertions, 0 deletions
diff --git a/man/v1.8.0/nng_socket_id.3.html b/man/v1.8.0/nng_socket_id.3.html
new file mode 100644
index 00000000..ae19db8c
--- /dev/null
+++ b/man/v1.8.0/nng_socket_id.3.html
@@ -0,0 +1,79 @@
+---
+version: v1.8.0
+layout: manpage_v2
+title: nng_socket_id(3)
+---
+<h1>nng_socket_id(3)</h1>
+<div class="sect1">
+<h2 id="_name">NAME</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>nng_socket_id - return numeric socket identifier</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_synopsis">SYNOPSIS</h2>
+<div class="sectionbody">
+<div class="listingblock">
+<div class="content">
+<pre class="pygments highlight"><code data-lang="c"><span></span><span class="tok-cp">#include</span><span class="tok-w"> </span><span class="tok-cpf">&lt;nng/nng.h&gt;</span>
+
+<span class="tok-kt">int</span><span class="tok-w"> </span><span class="tok-nf">nng_socket_id</span><span class="tok-p">(</span><span class="tok-n">nng_socket</span><span class="tok-w"> </span><span class="tok-n">s</span><span class="tok-p">);</span></code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_description">DESCRIPTION</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The <code>nng_socket_id()</code> function returns a positive identifier for the socket <em>s</em>,
+if it is valid.
+Otherwise it returns <code>-1</code>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+A socket is considered valid if it was ever opened with a protocol
+constructor, such as the <a href="nng_req_open.3.html"><code>nng_req0_open()</code></a> function.
+Sockets that are allocated on the stack or statically should be
+initialized with the macro
+<a href="nng_socket.5.html#NNG_SOCKET_INITIALIZER"><code>NNG_SOCKET_INITIALIZER</code></a>
+to ensure that they cannot be confused with a valid socket before they are opened.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_return_values">RETURN VALUES</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This function returns the positive value for the socket identifier, or
+<code>-1</code> if the socket is invalid.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_errors">ERRORS</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>None.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_see_also">SEE ALSO</h2>
+<div class="sectionbody">
+<div class="paragraph text-left">
+<p><a href="nng_socket.5.html">nng_socket(5)</a>,
+<a href="nng.7.html">nng(7)</a></p>
+</div>
+</div>
+</div>