`malloc`

[アーティクル]
10/12/2023

メモリブロックを割り当てます。

構文

void *malloc(
   size_t size
);

パラメーター

size
割り当てるバイト数。

戻り値

malloc は、割り当てられた領域への void ポインターを返します。または NULL 、使用可能なメモリが不足している場合に返されます。 void 以外の型へのポインターを返すには、戻り値の型キャストを使用します。戻り値によって指されるストレージ領域は、基本的なアラインメントのアラインメント要件以下の任意のタイプのオブジェクトのストレージに対して適切にアラインされます。 (Visual C++ では、基本的な配置は、8 バイトに必要なdoubleアラインメントです。64 ビットプラットフォームを対象とするコードでは、16 バイトです)。配置要件が大きいオブジェクト (たとえば、S Standard Edition 型__m128と __m256、where が 8 より大きい値を使用して宣言された型) にストレージを割り当てる場合に使用n_aligned_malloc__declspec(align( n ))します。 size が 0 の場合、malloc 関数はヒープに長さが 0 のアイテムを割り当て、そのアイテムへの有効なポインターを返します。要求されたメモリ量が小さい場合でも、malloc からの戻り値を必ずチェックしてください。

解説

malloc 関数は、少なくとも size バイトのメモリブロックを割り当てます。アラインメントと保守情報に領域が必要なため、ブロックのサイズが size バイトを超えることがあります。

malloc を実行したときに、メモリの割り当てに失敗した場合、または要求されたメモリ量が errno を超える場合は、ENOMEM が _HEAP_MAXREQ に設定されます。このエラーコードおよびその他のエラーコードの詳細については、「errno、_doserrno、_sys_errlist、_sys_nerr」を参照してください。

スタートアップコードは malloc を使用して、変数 _environ、envp、および argv にストレージを割り当てます。次の関数やこれらに対応するワイド文字関数も、malloc を呼び出します。

C++ の _set_new_mode 関数では、malloc の新しいハンドラーモードを設定します。新しいハンドラーモードは、エラーが発生したときに、malloc が _set_new_handler によって設定された新しいハンドラールーチンを呼び出すかどうかを指定します。 malloc では、既定で、メモリの割り当てエラーの際に新しいハンドラールーチンを呼び出しません。この既定の動作をオーバーライドすると、malloc がメモリの割り当てに失敗したときに、malloc 演算子が同じ理由で失敗したときと同じ方法で、new によって新しいハンドラールーチンを呼び出すことができます。既定値をオーバーライドするには、プログラムの早い段階で呼び出すか_set_new_mode(1)、リンク (NEWMODE.OBJリンクオプションを参照) を使用します。

アプリケーションが C のランタイムライブラリのデバッグバージョンにリンクされている場合、malloc は _malloc_dbg として解決されます。デバッグプロセス中のヒープの管理方法の詳細については、「CRT デバッグヒープの詳細」を参照してください。

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

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

必要条件

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

互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ

C ランタイムライブラリのすべてのバージョン。

例

// crt_malloc.c
// This program allocates memory with
// malloc, then frees the memory with free.

#include <stdlib.h>   // For _MAX_PATH definition
#include <stdio.h>
#include <malloc.h>

int main( void )
{
   char *string;

   // Allocate space for a path name
   string = malloc( _MAX_PATH );

   // In a C++ file, explicitly cast malloc's return.  For example,
   // string = (char *)malloc( _MAX_PATH );

   if( string == NULL )
      printf( "Insufficient memory available\n" );
   else
   {
      printf( "Memory space allocated for path name\n" );
      free( string );
      printf( "Memory freed\n" );
   }
}

Memory space allocated for path name
Memory freed

`malloc`

構文

パラメーター

戻り値

解説

必要条件

ライブラリ

例

関連項目

フィードバック

フィードバック

その他のリソース