Изменяет размер файла, открытого файловыми функциями низкого уровня.

FCHSIZE(nFileHandle, nNewFileSize)

Параметры

nFileHandle

Определяет дескриптор файла, размер которого нужно изменить. Данный дескриптор возвращается низкоуровневой функцией FOPEN( ) или FCREATE( ), с помощью которых был открыт файл. Если файл открывается функцией FOPEN( ), то необходим режим "write" или "read/write" для успешного изменения размера файла.

nNewFileSize

Определяет новый размер файла в байтах. Если значение параметра nNewFileSize меньше чем размер файла, то файл укорачивается. Если значение параметра nNewFileSize больше размера файла, то файл увеличивается.

Expand imageВозвращаемое Значение

Значение типа Numeric

Expand imageКомментарии

Функция FCHSIZE( ) используется для увеличения размера файла или его укорачивания после определенного байта.

Когда файл удлинняется, Microsoft Visual FoxPro размещает дополнительные сектора на том же устройстве, где данный файл открыт. С этого момента функция FCHSIZE( ) не занимает новое файловое пространство, там содержатся старые данные. Не забывайте заполнять новое пространство своими данными.

Функция возвращает итоговый размер (новый) данного файла. Visual FoxPro возвращает значение = –1 если функция FCHSIZE( ) не может изменить размер файла , например, задан неверный дескриптор файла в результате недостаточности дискового пространства, или файл имеет атрибут "только-чтение" (Read Only).

NoteПримечание

Данная функция может быть использована для установки длины файла = 0.

Expand imageСм. также