'\" t
.\"     Title: nn_reallocmsg
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2021-02-08
.\"    Manual: NNG Reference Manual
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "NN_REALLOCMSG" "3compat" "2021-02-08" "\ \&" "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"
nn_reallocmsg \- reallocate message (compatible API)
.SH "SYNOPSIS"
.sp
.if n .RS 4
.nf
.fam C
#include <nanomsg/nn.h>

void *nn_reallocmsg(void *old, size_t size);
.fam
.fi
.if n .RE
.SH "DESCRIPTION"
.sp
The \f(CRnn_reallocmsg()\fP reallocates the message \fIold\fP, making it of size \fIsize\fP.
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B Note
.ps -1
.br
.sp
This function is provided for API
compatibility with legacy \fIlibnanomsg\fP.
Consider using the relevant modern API instead.
.sp .5v
.RE
.sp
On success, the contents of \fIold\fP are copied into the new message
(truncating if appropriate), then \fIold\fP is deallocated, and a pointer
to the new message payload is returned.
.sp
On failure, the \fIold\fP message is unchanged, and the value \f(CRNULL\fP is returned
to the caller.
.SH "RETURN VALUES"
.sp
This function returns a pointer to message buffer space, or \f(CRNULL\fP
on failure.
.SH "ERRORS"
.sp
\f(CRENOMEM\fP
.RS 4
Insufficient memory is available.
.RE
.sp
\f(CREINVAL\fP
.RS 4
An invalid \fIsize\fP was specified.
.RE
.sp
\f(CRETERM\fP
.RS 4
The library is shutting down.
.RE
.SH "SEE ALSO"
.sp
nn_allocmsg(3compat),
nn_freemsg(3compat),
nn_errno(3compat),
nng_compat(3compat),
nng(7)