_malloca_malloca

スタックにメモリを割り当てます。Allocates memory on the stack. これは、「CRT のセキュリティ機能」の説明にあるとおり、セキュリティが強化されたバージョンの _alloca です。This is a version of _alloca with security enhancements as described in Security Features in the CRT.

構文Syntax

void *_malloca(
   size_t size
);

パラメーターParameters

sizesize
スタックから割り当てられるバイト数。Bytes to be allocated from the stack.

戻り値Return Value

_Mallocaルーチンを返します、 voidどの型のオブジェクトの記憶域の適切なアラインメントが保証されている、割り当てられた領域へのポインター。The _malloca routine returns a void pointer to the allocated space, which is guaranteed to be suitably aligned for storage of any type of object. 場合サイズは 0 です。 _malloca長さ 0 の項目を割り当てると、その項目の有効なポインターを返します。If size is 0, _malloca allocates a zero-length item and returns a valid pointer to that item.

場合サイズがより大きい _ALLOCA_S_THRESHOLD、し _mallocaヒープに割り当てようとして、領域を割り当てることができない場合は、null ポインターを返します。If size is greater than _ALLOCA_S_THRESHOLD, then _malloca attempts to allocate on the heap, and returns a null pointer if the space can't be allocated. 場合サイズに等しいまたはそれよりも小さい _ALLOCA_S_THRESHOLD、し _malloca領域ができない場合、スタック上、スタック オーバーフロー例外を割り当てようとするが生成されます割り当てられます。If size is less than or equal to _ALLOCA_S_THRESHOLD, then _malloca attempts to allocate on the stack, and a stack overflow exception is generated if the space can't be allocated. スタック オーバーフロー例外いない C++ の例外です。構造化例外になります。The stack overflow exception isn't a C++ exception; it's a structured exception. C++ 例外処理を使用して、代わりに使用する必要があります構造化例外処理この例外をキャッチする (SEH)。Instead of using C++ exception handling, you must use Structured Exception Handling (SEH) to catch this exception.

RemarksRemarks

_malloca割り当てますサイズプログラム スタックまたはヒープの場合は、要求で指定されたバイト数で特定のサイズを超えていますからバイト _ALLOCA_S_THRESHOLDします。_malloca allocates size bytes from the program stack or the heap if the request exceeds a certain size in bytes given by _ALLOCA_S_THRESHOLD. 間の差 _malloca_allocaされる _allocaサイズに関係なく、スタックで常に割り当てます。The difference between _malloca and _alloca is that _alloca always allocates on the stack, regardless of the size. 異なり _alloca、する必要がありますまたはへの呼び出しを許可しません無料、メモリを解放する _mallocaの使用を要求_freeaメモリを解放します。Unlike _alloca, which does not require or permit a call to free to free the memory so allocated, _malloca requires the use of _freea to free memory. デバッグ モードで _malloca常に、ヒープからメモリを割り当てます。In debug mode, _malloca always allocates memory from the heap.

明示的に呼び出すには制限 _malloca例外ハンドラー (EH)。There are restrictions to explicitly calling _malloca in an exception handler (EH). X86 クラスのプロセッサ上で実行される EH ルーチンは、独自のメモリ フレームで動作します。外側の関数のスタック ポインターの現在の場所には基づいていないメモリ領域でタスクを実行します。EH routines that run on x86-class processors operate in their own memory frame: They perform their tasks in memory space that is not based on the current location of the stack pointer of the enclosing function. 最も一般的な実装には、Windows NT 構造化例外処理 (SEH) や C++ catch 句の式などがあります。The most common implementations include Windows NT structured exception handling (SEH) and C++ catch clause expressions. そのため、明示的に呼び出す _malloca呼び出した EH ルーチンへの復帰時にプログラム エラー シナリオ結果は次のいずれかで。Therefore, explicitly calling _malloca in any of the following scenarios results in program failure during the return to the calling EH routine:

  • Windows NT SEH 例外フィルター式: _ _except (_malloca () )Windows NT SEH exception filter expression: __except (_malloca () )

  • Windows NT SEH 最終例外ハンドラー: _ _finally {_malloca () }Windows NT SEH final exception handler: __finally {_malloca () }

  • C++ EH catch 句の式C++ EH catch clause expression

ただし、 _mallocaできますから直接呼び出すを EH ルーチン内、または呼び出されるアプリケーションによって提供されるコールバックから以前にリストされた EH シナリオのいずれか。However, _malloca can be called directly from within an EH routine or from an application-supplied callback that gets invoked by one of the EH scenarios previously listed.

重要

Windows XP で場合 _mallocaが呼び出されます、try/catch ブロック内で呼び出す必要がある_resetstkoflwの catch ブロックでします。In Windows XP, if _malloca is called inside a try/catch block, you must call _resetstkoflw in the catch block.

使用する場合、上記の制限だけでなく、 /clr (共通言語ランタイムのコンパイル)オプション、 _mallocaでは使用できません _ _exceptブロックします。In addition to the above restrictions, when using the /clr (Common Language Runtime Compilation) option, _malloca cannot be used in __except blocks. 詳細については、「 /clr Restrictions」を参照してください。For more information, see /clr Restrictions.

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header
_malloca_malloca <malloc.h><malloc.h>

Example

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

Example

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

入力Input

1000

出力例Sample Output

Enter the number of bytes to allocate using _malloca: 1000

関連項目See also

メモリ割り当てMemory Allocation
calloccalloc
mallocmalloc
reallocrealloc
_resetstkoflw_resetstkoflw