alloca()

Allocate automatic space from the stack

Synopsis:

#include <alloca.h>

void *alloca( size_t size );

Arguments:

size
The number of bytes of memory to allocate.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The alloca() function allocates space for an object of size bytes from the stack. The allocated space is automatically discarded when the current function exits.

Note:
  • Don't use this function in an expression that's an argument to a function.
  • By default, alloca() is implemented as __builtin_alloca(). If you compile with the -fno-builtin option, you'll use the libc version of alloca(), which is a cover for malloc() and behaves in a slightly different manner:
    • It keeps track of all blocks allocated with alloca() and reclaims any that are found to be deeper in the stack than the current invocation. It therefore doesn't reclaim storage as soon as it becomes invalid, but it will do so eventually.
    • As a special case, alloca(0) reclaims storage without allocating any. You can use this feature to force garbage collection.

Returns:

A pointer to the start of the allocated memory, or NULL if there wasn't enough memory.

Examples:

#include <stdio.h>
#include <string.h>
#include <malloc.h>
#include <stdlib.h>

FILE *open_err_file( char *name )
{
    char *buffer;

    /* allocate temporary buffer for file name */
    buffer = (char *)alloca( strlen( name ) + 5 );

    if( buffer ) {
        FILE *fp;

        sprintf( buffer, "%s.err", name );
        fp = fopen( buffer, "w" );

        return fp;
    }

    return (FILE *)NULL;
}

int main( void )
{
    FILE *fp;

    fp = open_err_file( "alloca_test" );
    if( fp == NULL ) {
        printf( "Unable to open error file\n" );
    } else {
        fprintf( fp, "Hello from the alloca test.\n" );
        fclose( fp );
    }

    return EXIT_SUCCESS;
}

Classification:

Unix

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

Caveats:

Don't use alloca() as an argument to a function.