_alloca

Artykuł
02/27/2013

Przydziela pamięć na stosie.Ta funkcja jest niezalecane, ponieważ bardziej bezpieczna wersja jest dostępna; see _malloca.

void *_alloca( 
   size_t size 
);

Parametry

[w]size
Liczba bajtów do przydzielenia ze stosu.

Wartość zwracana

_alloca Zwraca rutynowych void wskaźnik przydzielony obszar jest gwarantowane zostały odpowiednio dostosowane do przechowywania dowolnego typu obiektu.Jeśli size jest równa 0, _alloca przydziela element o zerowej długości, a następnie zwraca prawidłowego wskaźnika do tego elementu.

Wyjątek przepełnienia stosu jest generowany, jeśli nie można przydzielić miejsca.Wyjątek przepełnienia stosu nie jest wyjątkiem C++; jest structured exception.Zamiast korzystać z obsługi wyjątków C++, należy użyć Strukturalnej obsługi wyjątków (SEH).

Uwagi

_allocaprzydziela size bajtów ze stosu programu.Przydzielone miejsce automatycznie jest zwalniana, gdy wywoływania funkcji kończy (a nie kiedy przydział jedynie przechodzi poza zakresem).W związku z tym, nie przechodzi wskaźnik wartość zwracana przez _alloca jako argument dla wolnego.

Istnieją ograniczenia jawne wywołanie _alloca w procedury obsługi wyjątków (EH).EH procedur, które są uruchamiane na x 86 klasy procesory działają w swojej pamięci ramce: wykonują swoje zadania w przestrzeni pamięci, który nie jest oparty na bieżącej lokalizacji wskaźnika stosu otaczający funkcji.Najbardziej popularne implementacje zawierają obsługi (SEH) wyjątków systemu Windows NT, strukturę i wyrażeń klauzuli catch języka C++.W związku z tym, jawne wywołanie _alloca w dowolnym następujące scenariusze skutkuje awarię programu podczas powrotu do wywoływania procedury EH:

Wyrażenie filtru wyjątków w SEH systemu Windows NT: __except (_alloca () )
Obsługa wyjątków końcowego strukturalnej obsługi wyjątków systemu Windows NT: __finally {_alloca () }
Wyrażenia klauzuli catch języka C++ EH

Jednakże _alloca może być wywołana bezpośrednio z w ramach rutynowych EH lub z zwrotnego dostarczonych przez aplikację, który pobiera wywoływany przez jeden ze scenariuszy EH wcześniej wymienionych.

Uwaga dotycząca zabezpieczeń
W systemie Windows XP Jeśli _alloca nazywa się wewnątrz bloku try/catch, trzeba wywołać _resetstkoflw w bloku catch.

Oprócz powyższych ograniczeń, podczas korzystania z/CLR (kompilacja wspólnej Language Runtime) opcji, _alloca nie mogą być używane w __except bloków.Aby uzyskać więcej informacji, zobacz /CLR ograniczenia.

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
_alloca	<malloc.h>

Przykład

// crt_alloca.c
// This program demonstrates the use of
// _alloca and trapping any exceptions
// that may occur.

#include <windows.h>
#include <stdio.h>
#include <malloc.h>

int main()
{
    int     size = 1000;
    int     errcode = 0;
    void    *pData = NULL;

    // Note: Do not use try/catch for _alloca,
    // use __try/__except, since _alloca throws
    // Structured Exceptions, not C++ exceptions.

    __try {
        // An unbounded _alloca can easily result in a 
        // stack overflow.
        // Checking for a size < 1024 bytes is recommended.
        if (size > 0 && size < 1024)
        {
            pData = _alloca( size );
            printf_s( "Allocated %d bytes of stack at 0x%p",
                      size, pData);
        }
        else
        {
            printf_s("Tried to allocate too many bytes.\n");
        }
    }

    // If an exception occured with the _alloca function
    __except( GetExceptionCode() == STATUS_STACK_OVERFLOW )
    {
        printf_s("_alloca failed!\n");

        // If the stack overflows, use this function to restore.
        errcode = _resetstkoflw();
        if (errcode)
        {
            printf_s("Could not reset the stack!\n");
            _exit(1);
        }
    };
}