_alloca

  • [アーティクル]

スタックにメモリを割り当てます。 セキュリティが強化されたバージョンが提供されたため、この関数は非推奨になりました。「_malloca」を参照してください。

構文

void *_alloca(
   size_t size
);

パラメーター

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

戻り値

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

領域を割り当てることができない場合、スタック オーバーフロー例外が生成されます。 スタック オーバーフロー例外は C++ の例外ではなく、構造化例外です。 C++ 例外処理を使用する代わりに、構造化例外処理 (Standard Edition H) を使用する必要があります。

解説

_alloca では、プログラム スタックから size バイトを割り当てます。 呼び出し元の関数が終了すると、割り当てられた領域は自動的に解放されます (割り当てがスコープ外になったときではありません)。 したがって、引数freeとして返される_allocaポインター値を .

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

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

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

  • C++ EH catch 句の式

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

重要

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

上記の制限に加え、/clr (共通言語ランタイムのコンパイル) オプションを使用する場合は、__except ブロックで _alloca を使用できません。 詳細については、「/clr の制約」を参照してください。

必要条件

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

例

// crt_alloca.c
// This program demonstrates the use of
// _alloca and trapping any exceptions
// that may occur.

#include <windows.h>
#include <stdio.h>
#include <malloc.h>

int main()
{
    int     size = 1000;
    int     errcode = 0;
    void    *pData = NULL;

    // Note: Do not use try/catch for _alloca,
    // use __try/__except, since _alloca throws
    // Structured Exceptions, not C++ exceptions.

    __try {
        // An unbounded _alloca can easily result in a
        // stack overflow.
        // Checking for a size < 1024 bytes is recommended.
        if (size > 0 && size < 1024)
        {
            pData = _alloca( size );
            printf_s( "Allocated %d bytes of stack at 0x%p",
                      size, pData);
        }
        else
        {
            printf_s("Tried to allocate too many bytes.\n");
        }
    }

    // If an exception occurred with the _alloca function
    __except( GetExceptionCode() == STATUS_STACK_OVERFLOW )
    {
        printf_s("_alloca failed!\n");

        // If the stack overflows, use this function to restore.
        errcode = _resetstkoflw();
        if (errcode == 0) //  _resetstkoflw() returns 0 on failure
        {
            printf_s("Could not reset the stack!\n");
            _exit(1);
        }
    };
}

Allocated 1000 bytes of stack at 0x0012FB50

関連項目

メモリ割り当て
calloc
malloc
realloc
_resetstkoflw
_malloca