'\" t
.\"     Title: nng_stat_find_socket
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-02-02
.\"    Manual: NNG Reference Manual
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "NNG_STAT_FIND_SOCKET" "3" "2025-02-02" "\ \&" "NNG Reference Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
nng_stat_find_socket \- find socket statistics
.SH "SYNOPSIS"
.sp
.if n .RS 4
.nf
.fam C
#include <nng/nng.h>

typedef struct nng_stat nng_stat;
typedef struct nng_socket nng_socket;

nng_stat *nng_stat_find_socket(nng_stat *stat, nng_socket socket);
.fam
.fi
.if n .RE
.SH "DESCRIPTION"
.sp
The \f(CRnng_stat_find_socket()\fP function returns the statistics tree within \fIstat\fP associated with the socket \fIsocket\fP, if such a tree exists.
Otherwise \f(CRNULL\fP is returned.
.sp
Generally, there will be child statistics of the returned value, each corresponding to a specific metric.
These can be further scanned using either
nng_stat_find(3)
or by walking the tree with
nng_stat_child(3).
.SH "RETURN VALUES"
.sp
The matching statistic, or NULL if no match is found.
.SH "ERRORS"
.sp
None.
.SH "SEE ALSO"
.sp
libnng(3),
nng_stat_child(3),
nng_stat_find(3),
nng_stat_find_dialer(3),
nng_stat_find_listener(3),
nng_stats_get(3),
nng_stat(5),
nng(7)