_malloca
スタックにメモリを割り当てます。 この関数は、「CRT のセキュリティ機能説明されているように、セキュリティが強化された_alloca
のバージョン。
構文
void *_malloca(
size_t size
);
パラメーター
size
スタックから割り当てられるバイト数。
戻り値
_malloca
ルーチンは、割り当てられた領域へのvoid
ポインターを返します。これは、任意の種類のオブジェクトの格納に適しています。 size
が 0 の場合、_malloca
関数は長さが 0 の項目を割り当て、その項目への有効なポインターを返します。
size
が_ALLOCA_S_THRESHOLD
より大きい場合、_malloca
はヒープへの割り当てを試み、領域を割り当てることができない場合は null ポインターを返します。 size
が_ALLOCA_S_THRESHOLD
以下の場合、_malloca
はスタックへの割り当てを試行し、領域を割り当てることができない場合はスタック オーバーフロー例外が生成されます。 スタック オーバーフロー例外は C++ の例外ではなく、構造化例外です。 C++ 例外処理を使用する代わりに、 構造化例外処理 (SEH) を使用してこの例外をキャッチする必要があります。
解説
_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 SEH 例外フィルター式:
__except
(_malloca ()
)Windows SEH の最終的な例外ハンドラー: {
_malloca ()
}__finally
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