1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
.\" (C) 2002 Ian Gulliver
.TH firestring_realloc 3 2002-03-31
.SH NAME
firestring_realloc \-
.BR realloc (3)
with internal result checking
.SH SYNOPSIS
.B #include <firestring.h>
.br
.B -lfirestring
.LP
.BI "void *firestring_realloc(void *" "old" ", const size_t " "new" ")"
.SH DESCRIPTION
firestring_realloc() acts exactly like
.BR realloc (3)
except that it detects realloc failures, prints an error and
.BR exit (3)
with exit status EXIT_FAILURE. In most programs, realloc
failures are unrecoverable, and this is the preferred
behaviour.
.SH RETURN VALUE
If firestring_realloc() returns, it
.B always
returns a string of
.I new
bytes containing the data from
.I old
at the beginning. It
.B never
returns
.IR NULL.
.SH AUTHOR
Ian Gulliver <ian@penguinhosting.net>
.SH SEE ALSO
.BR libfirestring (3)
|
