_malloca

  • [アーティクル]

スタックにメモリを割り当てます。 この関数は、「CRT の_allocaセキュリティ機能」の説明に従って、セキュリティが強化されたバージョンです。

構文

void *_malloca(
   size_t size
);

パラメーター

size
スタックから割り当てられるバイト数。

戻り値

このルーチンは _malloca 、割り当てられた領域へのポインターを返 void します。これは、任意の種類のオブジェクトのストレージに適しています。 size が 0 の場合、_malloca 関数は長さが 0 の項目を割り当て、その項目への有効なポインターを返します。

より大きい_ALLOCA_S_THRESHOLD場合sizeは、_mallocaヒープに割り当てようとし、スペースを割り当てることができない場合は null ポインターを返します。 次の値以下_ALLOCA_S_THRESHOLDの場合sizeは、_mallocaスタックへの割り当てを試行し、領域を割り当てることができない場合はスタック オーバーフロー例外が生成されます。 スタック オーバーフロー例外は C++ の例外ではなく、構造化例外です。 C++ 例外処理を使用する代わりに、構造化例外処理 (Standard Edition H) を使用してこの例外をキャッチする必要があります。

解説

_malloca は、要求が _ALLOCA_S_THRESHOLD で指定された特定のサイズ (バイト単位) を超えると、プログラム スタックまたはヒープから size バイトを割り当てます。 _malloca と _alloca の違いは、_alloca がサイズに関係なく常にスタックで割り当てることです。 _alloca で割り当てたメモリは free を呼び出して解放する必要がなく、そうすることも許可されていませんが、_malloca の場合はそれと異なり、_freea を使用してメモリを解放する必要があります。 デバッグ モードでは、_malloca は常にヒープからメモリを割り当てます。

例外ハンドラー (EH) で _malloca を明示的に呼び出す場合は制限があります。 x86 クラスのプロセッサで実行される EH ルーチンは、それ自体のメモリ フレーム内で動作します。外側の関数のスタック ポインターが示す現在位置に基づかないメモリ領域でタスクを実行します。 最も一般的な実装には、Windows NT 構造化例外処理 (SEH) や C++ catch 句の式などがあります。 このため、次のようなシナリオで _malloca を明示的に呼び出すと、呼び出した EH ルーチンへ戻る時点でプログラム エラーとなります。

  • Windows Standard Edition H 例外フィルター式: __except (_malloca () )

  • Windows Standard Edition H の最終的な例外ハンドラー: __finally {_malloca () }

  • C++ EH catch 句の式

しかし、_malloca を EH ルーチン内から直接呼び出すことや、上にリストされた EH シナリオのいずれかで呼び出されるアプリケーション提供によるコールバックから呼び出すことはできます。

重要

Windows では、ブロック内try/catchで呼び出される場合_mallocaは、catch ブロック内で呼び出す_resetstkoflw必要があります。

上記の制限に加えて、(共通言語ランタイム コンパイル) オプションを/clr使用する場合は、_mallocaブロックで__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