_expand_dbg

Cambia el tamaño de un bloque de memoria especificado en el montón, ya sea expandiendo o contrayendo el bloque (solo versión de depuración).

Sintaxis

void *_expand_dbg(
   void *userData,
   size_t newSize,
   int blockType,
   const char *filename,
   int lineNumber
);

Parámetros

userData
Puntero al bloque de memoria asignado previamente.

newSize
Nuevo tamaño solicitado para el bloque (en bytes).

blockType
Tipo solicitado para el bloque cuyo tamaño ha cambiado: _CLIENT_BLOCK o _NORMAL_BLOCK.

filename
Puntero al nombre del archivo de código fuente que solicitó la operación de expansión, o NULL.

lineNumber
Número de línea del archivo de código fuente en la que se solicitó la operación de expansión, o NULL.

Los filename parámetros y lineNumber solo están disponibles cuando _expand_dbg se ha llamado explícitamente a o se ha definido la constante de _CRTDBG_MAP_ALLOC preprocesador.

Valor devuelto

Cuando se ejecuta correctamente, _expand_dbg devuelve un puntero al bloque de memoria cuyo tamaño ha cambiado. Dado que la memoria no se mueve, la dirección es la misma que userData. Si se produjo un error o el bloque no se pudo expandir al tamaño solicitado, devuelve NULL. Si se produce un error, se devuelve errno con información del sistema operativo sobre la naturaleza del error. Para obtener más información sobre errno, consulte errno, _doserrno, _sys_errlist y _sys_nerr.

Comentarios

La _expand_dbg función es una versión de depuración de la función _expand . Cuando _DEBUG no se define, cada llamada a se reduce a _expand_dbg una llamada a _expand. _expand y _expand_dbg cambian el tamaño de un bloque de memoria del montón base, pero _expand_dbg admite varias características de depuración: búferes situados a cada lado de la parte del usuario del bloque en el que se va a comprobar si hay pérdidas, un parámetro de tipo de bloque para realizar el seguimiento de tipos de asignación concretos, e información sobre filename/lineNumber para determinar el origen de las solicitudes de asignación.

_expand_dbg cambia el tamaño del bloque de memoria especificado con un poco más de espacio que el newSize solicitado. newSize podría ser mayor o menor que el tamaño del bloque de memoria asignado originalmente. El administrador de montón de depuración usa el espacio adicional para vincular los bloques de memoria de depuración y proporcionar a la aplicación información de encabezado de depuración y sobrescribir búferes. El cambio de tamaño es realiza expandiendo o contrayendo el bloque de memoria original. _expand_dbg no mueve el bloque de memoria, al igual que la _realloc_dbg función .

Si newSize es mayor que el tamaño del bloque original, el bloque de memoria se expande. Durante una expansión, si el bloque de memoria no se puede expandir para dar cabida al tamaño solicitado, NULL se devuelve. Si newSize es menor que el tamaño del bloque original, el bloque de memoria se contrae hasta que tiene el nuevo tamaño.

Para obtener información sobre cómo se asignan, inicializan y administran los bloques de memoria en la versión de depuración del montón base, consulte Detalles del montón de depuración de CRT. Para obtener información sobre los tipos de bloques de asignación y cómo se usan, consulte Tipos de bloques en el montón de depuración. Para obtener información sobre las diferencias entre las funciones de montón estándar y las versiones de depuración, consulte Versiones de depuración de funciones de asignación de montón.

Esta función valida sus parámetros. Si userData es un puntero nulo o si el tamaño es mayor que _HEAP_MAXREQ, esta función invoca un controlador de parámetros no válido, como se describe en Validación de parámetros. Si la ejecución puede continuar, errno está establecido en EINVAL y la función devuelve NULL.

Requisitos

Routine	Encabezado necesario
_expand_dbg	<crtdbg.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Bibliotecas

Solo versiones de depuración de las bibliotecas en tiempo de ejecución de C.

Ejemplo

// crt_expand_dbg.c
//
// This program allocates a block of memory using _malloc_dbg
// and then calls _msize_dbg to display the size of that block.
// Next, it uses _expand_dbg to expand the amount of
// memory used by the buffer and then calls _msize_dbg again to
// display the new amount of memory allocated to the buffer.
//

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

int main( void )
{
   long *buffer;
   size_t size;

   // Call _malloc_dbg to include the filename and line number
   // of our allocation request in the header
   buffer = (long *)_malloc_dbg( 40 * sizeof(long),
                                 _NORMAL_BLOCK, __FILE__, __LINE__ );
   if( buffer == NULL )
      exit( 1 );

   // Get the size of the buffer by calling _msize_dbg
   size = _msize_dbg( buffer, _NORMAL_BLOCK );
   printf( "Size of block after _malloc_dbg of 40 longs: %u\n", size );

   // Expand the buffer using _expand_dbg and show the new size
   buffer = (long *)_expand_dbg( buffer, size + sizeof(long),
                                 _NORMAL_BLOCK, __FILE__, __LINE__ );

   if( buffer == NULL )
      exit( 1 );
   size = _msize_dbg( buffer, _NORMAL_BLOCK );
   printf( "Size of block after _expand_dbg of 1 more long: %u\n",
           size );

   free( buffer );
   exit( 0 );
}

Size of block after _malloc_dbg of 40 longs: 160
Size of block after _expand_dbg of 1 more long: 164

Comentario

El resultado de este programa depende de la capacidad del equipo de expandir todas las secciones. Si se expanden todas las secciones, el resultado se refleja en la sección de salida.

Consulte también

Rutinas de depuración
_malloc_dbg