_aligned_offset_recalloc

_aligned_mallocまたは_aligned_offset_mallocで割り当てられたメモリ ブロックのサイズを変更し、メモリを 0 に初期化します。

構文

void * _aligned_offset_recalloc(
   void *memblock,
   size_t num,
   size_t size,
   size_t alignment,
   size_t offset
);

パラメーター

memblock
現在のメモリ ブロック ポインター。

number
要素の数。

size
各要素の長さ (バイト単位)。

alignment
アラインメント値。2 の整数乗である必要があります。

offset
アラインメントを強制するためのメモリ割り当てへのオフセット。

戻り値

_aligned_offset_recalloc は、再割り当てされた (移動された可能性もある) メモリ ブロックへの void ポインターを返します。 戻り値は、サイズが 0 で、バッファー引数がNULLされていない場合、またはブロックを特定のサイズに拡張するのに十分なメモリがない場合にNULLされます。 最初の場合には、元のブロックは解放されます。 2 番目の場合には、元のブロックは変更されません。 戻り値は、どの型のオブジェクトのストレージの場合でも、適切に整列されたストレージ領域を指します。 void 以外の型へのポインターを取得するには、戻り値の型キャストを使用します。

_aligned_offset_recalloc は __declspec(noalias) および __declspec(restrict)マークされます。つまり、関数はグローバル変数を変更しないことが保証され、返されるポインターはエイリアス化されません。 詳細については、次のトピックを参照してください。 noalias および restrict

解説

_aligned_offset_mallocと同様に、_aligned_offset_recallocでは構造体を構造体内のオフセットに配置できます。

_aligned_offset_recalloc は malloc に基づきます。 _aligned_offset_malloc の使い方の詳細については、「malloc」を参照してください。 memblock が NULL の場合、関数は _aligned_offset_malloc を内部的に呼び出します。

この関数は、メモリ割り当てが失敗するか、要求されたサイズ (number * size) が _HEAP_MAXREQ より大きかった場合に、errno を ENOMEM に設定します。 errno の詳細については、「errno、_doserrno、_sys_errlist、_sys_nerr」を参照してください。 また、_aligned_offset_recalloc はそのパラメーターを検証します。 alignmentが 2 の累乗でない場合、またはoffsetが 0 以外で、要求されたsize以上の場合、この関数は、Parameter 検証で説明されているように、無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、この関数は NULL を返し、errno を EINVAL に設定します。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

要件

関連項目

データの配置
_recalloc
_aligned_recalloc