Функция FCHSIZE( )

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

Синтаксис

FCHSIZE(nFileHandle, nNewFileSize)

Параметры

nFileHandle

Задает дескриптор файла, размер которого вы собираетесь изменить. Дескриптор файла возвращается функцией FOPEN( ), когда файл открывается, или функцией FCREATE( ), когда файл создается. Если файл открыт функцией FOPEN( ), его размер мож о изменить только при условии, что он был открыт с полномочиями на запись или а чтение-запись.

nNewFileSize

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

Результат

Числовой

Комментарии

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

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

Возвращается итоговый размер файла в байтах. Если функция FCHSIZE( ) не смогла изменить размер файла, Visual FoxPro возвращает 1; такое возможно, например, когда задан недействительный дескриптор файла, когда недостаточно места на диске или когда файл предназначен только для чтения.

Совет С помощью данной функции можно произвести усечение файла до нулевой длины.