FCHSIZE( ) (Función)

Cambia el tamaño de un archivo abierto con una función de archivo de bajo nivel.

FCHSIZE(nFileHandle, nNewFileSize)

Valores devueltos

Numeric

Parámetros

• nFileHandle
  Especifica el controlador del archivo cuyo tamaño desea cambiar. El controlador de archivo lo devuelve FOPEN( ) al abrir el archivo o FCREATE( ) al crear el archivo. Si abre un archivo con FOPEN( ), deberá volver a abrirlo con privilegios de escritura o de lectura y escritura para poder cambiar su tamaño.
• nNewFileSize
  Especifica el nuevo tamaño del archivo, en bytes. Si nNewFileSize es menor que el tamaño original del archivo, se truncará el archivo. Si nNewFileSize es mayor que el tamaño original del archivo, se aumentará el tamaño del archivo.

Observaciones

Utilice FCHSIZE( ) para aumentar el tamaño del archivo o truncar el archivo a partir de un byte especificado.

Cuando se aumenta el tamaño de un archivo, Microsoft Visual FoxPro asigna sectores para el archivo en la unidad en la que está abierto el archivo. Como FCHSIZE( ) no inicializa el espacio del archivo nuevo, el espacio podrá contener los datos antiguos. Asegúrese de administrar el espacio del archivo nuevo.

Devuelve el tamaño final del archivo en bytes. Visual FoxPro devuelve –1 si FCHSIZE( ) no es capaz de cambiar el tamaño del archivo si, por ejemplo, se ha especificado un control de archivo no válido, debido a que no hay espacio de disco suficiente o a que el archivo es de sólo lectura.

Sugerencia   Esta función puede utilizarse para truncar un archivo a longitud 0.

Vea también

FCLOSE( ) | FCREATE( ) | FEOF( ) | FFLUSH( ) | FGETS( ) | FOPEN( ) | FPUTS( ) | FREAD( ) | FSEEK( ) | FWRITE( )