_malloca

Выделение памяти в стеке. Эта функция представляет собой версию улучшений _alloca безопасности, как описано в функциях безопасности в CRT.

Синтаксис

void *_malloca(
   size_t size
);

Параметры

size
Байты, которые нужно выделить из стека.

Возвращаемое значение

Подпрограмма _malloca возвращает void указатель на выделенное пространство, которое подходит для хранения любого типа объекта. Если значение size равно 0, _malloca выделяет элемент нулевой длины и возвращает допустимый указатель на этот элемент.

Если size значение больше _ALLOCA_S_THRESHOLD, то _malloca пытается выделить кучу и возвращает пустой указатель, если пространство не может быть выделено. Если size значение меньше или равно _ALLOCA_S_THRESHOLD, то _malloca пытается выделить его в стеке, а исключение переполнения стека создается, если пространство не может быть выделено. Исключение переполнения стека не является исключением C++; Это структурированное исключение. Вместо обработки исключений C++ необходимо использовать структурированную обработку исключений (SEH) для перехвата этого исключения.

Замечания

_malloca выделяет size байтов из стека программы или кучи, если запрос превышает определенный размер в байтах, определяемый _ALLOCA_S_THRESHOLD. Различие между _malloca и _alloca состоит в том, что _alloca всегда выделяет память из стека независимо от размера. В отличие _allocaот того, что не требует или разрешает вызов free для освобождения выделенной памяти, _malloca требует использования _freea для освобождения памяти. В режиме отладки _malloca всегда выделяет память из кучи.

Существуют ограничения на явный вызов _malloca в обработчике исключений (EH). Подпрограммы EH, работающие на процессорах класса x86, работают в собственном кадре памяти: они выполняют свои задачи в пространстве памяти, которое не зависит от текущего расположения указателя стека включающей функции. Наиболее распространенные реализации включают выражения структурной обработки исключений (SEH) Windows NT и выражения catch языка C++. Поэтому явный вызов _malloca в любом из следующих сценариев приводит к сбою программы во время возврата к вызывающей подпрограмме EH:

• Выражение фильтра исключений SEH для Windows: __except (_malloca () )

• Конечный обработчик исключений Windows SEH: __finally {_malloca () }

• Выражение catch обработки исключений языка C++

Однако _malloca можно вызывать непосредственно из подпрограммы обработки исключений или предоставленного приложением обратного вызова, который вызывается одним из перечисленных выше сценариев обработки исключений.

Важно!

В Windows, если _malloca вызывается внутри try/catch блока, необходимо вызвать _resetstkoflw в блоке catch.

Помимо указанных выше ограничений при использовании /clr параметра _malloca (компиляция среды CLR) нельзя использовать в __except блоках. Дополнительные сведения см. в разделе /clr "Ограничения".

Требования

Маршрут	Обязательный заголовок
_malloca	<malloc.h>

Пример: _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();
}

Пример: _malloca исключение

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

Входные данные

1000

Пример полученных результатов

Enter the number of bytes to allocate using _malloca: 1000

См. также

Выделение памяти
calloc
malloc
realloc
_resetstkoflw