fchsize( ) 函数

请参阅

更改用低级文件函数打开的文件的大小。

语法

FCHSIZE(nFileHandle, nNewFileSize)

参数

nFileHandle

指定希望改变其大小的文件的句柄，此句柄可以在打开文件时由 FOPEN( ) 函数返回，或者在创建文件时用 FCREATE( ) 函数返回。如果使用 FOPEN( ) 函数打开文件，该文件应以“写”或“读写”方式打开，以便更改其大小。

nNewFileSize

以字节为单位，指定新的文件大小。如果 nNewFileSize 小于文件的原始大小，文件将被截断；如果 nNewFileSize 大于文件的原始大小，则增大文件。

返回值类型
数值型

说明
fchsize( ) 函数根据指定字节数增大文件或截断文件。
当增大文件时，在打开文件所在的驱动器上，Visual FoxPro 将为文件分配扇区。由于 fchsize( ) 函数并不对新的文件存储空间初始化，因而这些空间可能包含以前的数据，此时应对新的文件存储空间进行妥善的管理。
此函数返回文件最终的字节数。由于某些原因(例如磁盘空间不够)，如果 fchsize( ) 函数所指定的文件句柄无效，或文件为只读文件，则 Visual FoxPro 返回 1。

提示
此函数可把文件长度截短为 0。