_malloca

Přidělí paměť v zásobníku. Tato funkce je verze _alloca s vylepšeními zabezpečení, jak je popsáno v funkcích zabezpečení v CRT.

Syntaxe

void *_malloca(
   size_t size
);

Parametry

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

Vrácená hodnota

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

Pokud size je větší než _ALLOCA_S_THRESHOLD, pokusí _malloca se přidělit haldu a vrátí ukazatel null, pokud mezeru nelze přidělit. Pokud size je menší nebo rovno _ALLOCA_S_THRESHOLD, pokusí _malloca se přidělit v zásobníku a vygeneruje se výjimka přetečení zásobníku, pokud není možné přidělit mezeru. Výjimka přetečení zásobníku není výjimkou C++. je to strukturovaná výjimka. Místo zpracování výjimek jazyka C++ musíte k zachycení této výjimky použít strukturované zpracování výjimek (SEH).

Poznámky

_malloca size přidělí bajty ze zásobníku programu nebo haldy, pokud požadavek překročí určitou velikost v bajtech zadaných _ALLOCA_S_THRESHOLD. Rozdíl mezi _malloca zásobníkem a _alloca je vždy _alloca přidělen bez ohledu na velikost. Na rozdíl od _allocavolání, které nevyžaduje nebo neumožňuje free uvolnit paměť tak přidělenou, _malloca vyžaduje použití _freea k uvolnění paměti. V režimu _malloca ladění vždy přidělí paměť z haldy.

Existují omezení explicitního volání _malloca 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. Mezi nejběžnější implementace patří výrazy klauzule systém Windows NT strukturované zpracování výjimek (SEH) a c++ catch. Proto explicitní volání _malloca 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 (_malloca ())

• Poslední obslužná rutina výjimky systému Windows SEH: __finally {_malloca () }

• Výraz klauzule catch C++ EH

Lze _malloca 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é

Ve Windows, pokud _malloca je volána uvnitř try/catch bloku, musíte volat _resetstkoflw v bloku catch.

Kromě výše uvedených omezení se při použití /clr nedají použít v blocích. Další informace naleznete v tématu /clr Omezení.

Požadavky

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

Příklad: _malloca

// crt_malloca_simple.c
#include <stdio.h>
#include <malloc.h>

void Fn()
{
   char * buf = (char *)_malloca( 100 );
   // do something with buf
   _freea( buf );
}

int main()
{
   Fn();
}

Příklad: _malloca výjimka

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

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

int main()
{
    int     size;
    int     numberRead = 0;
    int     errcode = 0;
    void    *p = NULL;
    void    *pMarker = NULL;

    while (numberRead == 0)
    {
        printf_s("Enter the number of bytes to allocate "
                 "using _malloca: ");
        numberRead = scanf_s("%d", &size);
    }

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

    __try
    {
        if (size > 0)
        {
            p =  _malloca( size );
        }
        else
        {
            printf_s("Size must be a positive number.");
        }
        _freea( p );
    }

    // Catch any exceptions that may occur.
    __except( GetExceptionCode() == STATUS_STACK_OVERFLOW )
    {
        printf_s("_malloca failed!\n");

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

Vstup

1000

Ukázkový výstup

Enter the number of bytes to allocate using _malloca: 1000

Viz také

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