Изменяет размер файла, открытого файловыми функциями низкого уровня.
FCHSIZE(nFileHandle, nNewFileSize) |
Параметры
- nFileHandle
-
Определяет дескриптор файла, размер которого нужно изменить. Данный дескриптор возвращается низкоуровневой функцией FOPEN( ) или FCREATE( ), с помощью которых был открыт файл. Если файл открывается функцией FOPEN( ), то необходим режим "write" или "read/write" для успешного изменения размера файла.
- nNewFileSize
-
Определяет новый размер файла в байтах. Если значение параметра nNewFileSize меньше чем размер файла, то файл укорачивается. Если значение параметра nNewFileSize больше размера файла, то файл увеличивается.
Возвращаемое Значение
Значение типа Numeric
Комментарии
Функция FCHSIZE( ) используется для увеличения размера файла или его укорачивания после определенного байта.
Когда файл удлинняется, Microsoft Visual FoxPro размещает дополнительные сектора на том же устройстве, где данный файл открыт. С этого момента функция FCHSIZE( ) не занимает новое файловое пространство, там содержатся старые данные. Не забывайте заполнять новое пространство своими данными.
Функция возвращает итоговый размер (новый) данного файла. Visual FoxPro возвращает значение = –1 если функция FCHSIZE( ) не может изменить размер файла , например, задан неверный дескриптор файла в результате недостаточности дискового пространства, или файл имеет атрибут "только-чтение" (Read Only).
Примечание |
---|
Данная функция может быть использована для установки длины файла = 0. |