Функция FCHSIZE()

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

Синтаксис:

FCHSIZE(nFileHandle, nNewFileSize)

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

Результат:
Числовой.

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


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 17.01.2003