_malloca

Memóriát foglal le a veremen. Ez a függvény a _alloca leírt biztonsági fejlesztéseket tartalmazó verzió.

Szemantika

void *_malloca(
   size_t size
);

Paraméterek

size
A veremből lefoglalandó bájtok.

Visszaadott érték

A _malloca rutin egy mutatót void ad vissza a lefoglalt területhez, amely megfelelően igazodik bármilyen típusú objektum tárolásához. Ha size 0, nulla hosszúságú elemet foglal le, _malloca és érvényes mutatót ad vissza az adott elemhez.

Ha size nagyobb, mint _ALLOCA_S_THRESHOLD, akkor _malloca megpróbálja lefoglalni a halom, és null mutatót ad vissza, ha a szóköz nem foglalható le. Ha size kisebb vagy egyenlő _ALLOCA_S_THRESHOLD, akkor _malloca megpróbálja lefoglalni a vermet, és a rendszer túlcsordulási kivételt hoz létre, ha a terület nem foglalható le. A verem túlcsordulási kivétele nem C++ kivétel; ez egy strukturált kivétel. A C++ kivételkezelés helyett strukturált kivételkezelést (SEH) kell használnia a kivétel elfogásához.

Megjegyzések

_malloca bájtokat size foglal le a programveremből vagy a halomból, ha a kérés meghaladja a megadott bájtokban megadott _ALLOCA_S_THRESHOLDméretet. A különbség _malloca_alloca és az, hogy _alloca mindig lefoglalja a verem, függetlenül a méret. Ellentétben _alloca, amely nem igényel, vagy lehetővé teszi a hívást, hogy free felszabadítsa _malloca a memória így lefoglalt, _freea megköveteli a szabad memória használatát. Hibakeresési módban _malloca mindig lefoglalja a memóriát a halomból.

A kivételkezelő (EH) kifejezett meghívására _malloca korlátozások vonatkoznak. Az x86-osztályú processzorokon futó EH-rutinok a saját memóriakeretükben működnek: Olyan memóriatérben végzik el a feladataikat, amelyek nem a beágyazási függvény veremmutatójának aktuális helye alapján vannak. A leggyakoribb implementációk közé tartoznak a Windows NT strukturált kivételkezelés (SEH) és a C++ fogási záradék kifejezései. Ezért az alábbi forgatókönyvek bármelyikének explicit meghívása _malloca programhiba-műveletet eredményez a hívási EH-rutinba való visszatérés során:

• Windows SEH-kivételszűrő kifejezés: __except (_malloca ())

• A Windows SEH végső kivételkezelője: __finally {_malloca () }

• C++ EH catch záradék kifejezés

_malloca Azonban közvetlenül egy EH-rutinból vagy egy alkalmazás által biztosított visszahívásból hívható meg, amelyet a korábban felsorolt EH-forgatókönyvek egyike hív meg.

Fontos

Windows rendszerben, ha _malloca egy try/catch blokkon belül van meghívva, a fogási blokkban kell hívnia _resetstkoflw .

A fenti korlátozások mellett a /clr (Common Language Runtime Compilation) beállítás _malloca használata esetén nem használható blokkokban __except . További információ: /clr Korlátozások.

Követelmények

Rutin	Kötelező fejléc
_malloca	<malloc.h>

Példa: _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élda: _malloca kivétel

// 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);
        }
    };
}

Bemenet

1000

Példakimenet

Enter the number of bytes to allocate using _malloca: 1000

Lásd még

memóriafoglalási
calloc
malloc
realloc
_resetstkoflw