`_alloca`

Článek
10/12/2023

Přidělí paměť v zásobníku. Tato funkce je zastaralá, protože je k dispozici bezpečnější verze; viz ._malloca

Syntaxe

void *_alloca(
   size_t size
);

Parametry

size
Bajty, které mají být přiděleny ze zásobníku.

Vrácená hodnota

Rutina _alloca vrátí void ukazatel na přidělený prostor, který je vhodně zarovnaný pro uložení libovolného typu objektu. Pokud size je 0, _alloca přidělí položku nulové délky a vrátí platný ukazatel na danou položku.

Pokud není možné přidělit prostor, vygeneruje se výjimka přetečení zásobníku. Výjimka přetečení zásobníku není výjimkou C++. je to strukturovaná výjimka. Místo použití zpracování výjimek jazyka C++ musíte použít strukturované zpracování výjimek (SEH).

Poznámky

_allocasize přidělí bajty ze zásobníku programu. Přidělený prostor se automaticky uvolní, když se volající funkce ukončí (ne v době, kdy přidělení pouze projde mimo rozsah). Proto nepředávejte hodnotu ukazatele vrácenou _alloca jako argument .free

Existují omezení explicitního volání _alloca v obslužné rutině výjimky (EH). Rutiny EH, které běží na procesorech třídy x86, fungují ve vlastním rámečku paměti: Provádějí své úlohy v paměťovém prostoru, které nejsou založené na aktuálním umístění ukazatele zásobníku ohraničující funkce. Nejběžnější implementace zahrnují výrazy klauzule Windows Structured Exception Handling (SEH) a C++. Proto explicitní volání _alloca v některém z následujících scénářů vede k selhání programu během návratu do volání rutiny EH:

Výraz filtru výjimek systému Windows SEH: __except ( _alloca() )
Konečná obslužná rutina výjimky systému Windows SEH: __finally { _alloca() }
Výraz klauzule catch C++ EH

Lze _alloca však volat přímo z rutiny EH nebo z zpětného volání zadaného aplikací, který se vyvolá jedním z dříve uvedených scénářů EH.

Důležité

Pokud _alloca je volána uvnitř bloku try, musíte zavolat _resetstkoflw do bloku catch.

Kromě výše uvedených omezení se při použití/clr možnosti _alloca (Common Language Runtime Compilation) nedají použít v __except blocích. Další informace naleznete v tématu /clr Omezení.

Požadavky

Rutina	Požadovaný hlavičkový soubor
`_alloca`	`<malloc.h>`

Příklad

// 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 occurred 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 == 0) //  _resetstkoflw() returns 0 on failure
        {
            printf_s("Could not reset the stack!\n");
            _exit(1);
        }
    };
}

Allocated 1000 bytes of stack at 0x0012FB50

Viz také

Přidělení paměti
calloc
malloc
realloc
_resetstkoflw
_malloca

Sdílet prostřednictvím