`malloc`

项目
10/18/2023

分配内存块。

语法

void *malloc(
   size_t size
);

参数

size
要分配的字节数。

返回值

malloc 会返回指向已分配空间的 void 指针，如果可用内存不足，则返回 NULL。若要返回指向类型而非 void 的指针，请在返回值上使用类型转换。返回值指向的存储空间会适当对齐，以存储对齐要求小于或等于基本对齐要求的任意对象类型。（在 Visual C++ 中，基本对齐是 double 或 8 个字节所需的对齐。在面向 64 位平台的代码中，是 16 个字节。）使用 _aligned_malloc 为具有更大对齐要求的对象分配存储空间，例如 SSE 类型 __m128 和 __m256，以及使用 __declspec(align( n ))（其中 n 大于 8）声明的类型。如果 size 为 0，则 malloc 在堆中分配零长度的项并向该项返回有效的指针。即使请求的内存量较小，也要始终检查 malloc 的返回值。

注解

malloc 函数分配至少为 size 个字节的内存块。由于对齐和维护信息所需的空间，该块可能大于 size 个字节。

如果内存分配失败或请求的内存量超过 _HEAP_MAXREQ，malloc 会将 errno 设置为 ENOMEM。有关此错误代码和其他错误代码的信息，请参阅 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>`

有关兼容性的详细信息，请参阅兼容性。

库

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

另请参阅

内存分配
 calloc
free
realloc
_aligned_malloc

`malloc`

语法

参数

返回值

注解

要求

库

示例

另请参阅

反馈

反馈

其他资源