_expand

项目
02/21/2013

更改的范围内存块。

void *_expand( 
   void *memblock,
   size_t size 
);

参数

memblock
对以前指定的指针内存块。
size
新的大小 (以字节为单位)。

返回值

_expand 返回无效指针重新分配的内存块。 _expand不同， realloc，不能将阻止更改其大小。因此，因此，如果有足够的内存扩展块，而不移动它，对 _expand 的 memblock 参数是作为返回值的相同。

，当错误在其操作时，检测_expand 返回 NULL 。例如，因此，如果 _expand 用于减少内存块，则可能检测到小的块堆损坏或无效的指针并返回 NULL。

如果有可用内存不足展开块到给定范围，而不移动它，则函数返回 NULL。 _expand 从不返回块展开为大小小于请求。如果失败， errno 指示失败的性质。有关 errno的更多信息，请参见errno、_doserrno、_sys_errlist和_sys_nerr。

返回值指向确保为任何类型的对象存储正确对齐的存储空间。签出该项的新范围，请使用 _msize。获取对一个类型的指针 void除了之外，将使用一个返回值的类型转换。

备注

此前分配大小。尝试展开或收缩块内存块，而不移动其堆位置的 _expand 函数。 memblock 参数指向块的开头。 size 参数指定块的新范围，以字节为单位)。块的内容保持不变的最短新值和旧范围。 memblock 不能将释放的块。

备注

在 64 位平台上， _expand 可能不会阻止，如果新的大小与当前范围小于;特别是，因此，如果块小于 16K 的大小并在低碎片堆中分配了， _expand 块保持不变并返回 memblock。

当应用程序使用 C 运行库时的调试版本链接， _expand 解析为 _expand_dbg。有关堆方式的更多信息管理在调试过程中，请参见 CRT 调试堆。

此功能验证其参数。如果 memblock 是 null 指针，此函数调用无效参数处理程序，如参数验证所述。如果执行允许继续， errno 设置为 EINVAL ，函数返回 NULL。如果 size 比 _HEAP_MAXREQ大， errno 设置为 ENOMEM ，函数返回 NULL。

要求

功能	必需的头
_expand	malloc.h

有关其他的兼容性信息，请参见中介绍的兼容性。

示例

// crt_expand.c

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

int main( void )
{
   char *bufchar;
   printf( "Allocate a 512 element buffer\n" );
   if( (bufchar = (char *)calloc( 512, sizeof( char ) )) == NULL )
      exit( 1 );
   printf( "Allocated %d bytes at %Fp\n", 
         _msize( bufchar ), (void *)bufchar );
   if( (bufchar = (char *)_expand( bufchar, 1024 )) == NULL )
      printf( "Can't expand" );
   else
      printf( "Expanded block to %d bytes at %Fp\n", 
            _msize( bufchar ), (void *)bufchar );
   // Free memory 
   free( bufchar );
   exit( 0 );
}