1
0
Fork 0
This repository has been archived on 2019-12-23. You can view files and clone it, but you cannot make any changes to it's state, such as pushing and creating new issues, pull requests or comments.
arduinisten/arduino-0018-windows/hardware/tools/avr/doc/avr-libc/man/man3/alloca.3
2010-03-30 21:53:44 +02:00

35 lines
1.1 KiB
Groff

.TH "<alloca.h>: Allocate space in the stack" 3 "4 Dec 2008" "Version 1.6.4" "avr-libc" \" -*- nroff -*-
.ad l
.nh
.SH NAME
<alloca.h>: Allocate space in the stack \-
.SH "Detailed Description"
.PP
.PP
.SS "Functions"
.in +1c
.ti -1c
.RI "void * \fBalloca\fP (size_t __size)"
.br
.in -1c
.SH "Function Documentation"
.PP
.SS "void* alloca (size_t __size)"
.PP
Allocate \fI__size\fP bytes of space in the stack frame of the caller.
.PP
This temporary space is automatically freed when the function that called \fBalloca()\fP returns to its caller. Avr-libc defines the \fBalloca()\fP as a macro, which is translated into the inlined \fC__builtin_alloca()\fP function. The fact that the code is inlined, means that it is impossible to take the address of this function, or to change its behaviour by linking with a different library.
.PP
\fBReturns:\fP
.RS 4
\fBalloca()\fP returns a pointer to the beginning of the allocated space. If the allocation causes stack overflow, program behaviour is undefined.
.RE
.PP
\fBWarning:\fP
.RS 4
Avoid use \fBalloca()\fP inside the list of arguments of a function call.
.RE
.PP