символьная строка, содержащая необязательные имя
[<lCtrl-Z>]) --> cCharacterstring
Параметры
<cFile> - символьная строка, содержащая необязательные имя диска и
путь доступа и обязательное имя файла. По умолчанию используются
текущий диск и текущая директория.
<nLength> - необязательный числовой параметр, задающий количество
считываемых байтов в диапазоне от 1 до 65520. По умолчанию размер
файла.
<nOffset> - необязательный числовой параметр, задающий смещение в
файле, начиная с которого должно производиться чтение. По умолчанию 0
(чтение с первого байта).
<lCtrl-Z> - необязательный логический параметр, задающий при значении
.T. интерпретацию символа CHR(26) как маркера конца файла, а при
значении .F. или по умолчанию - интерпретацию его как обычного
символа.
Возвращаемое значение
cCharacterstring - символьная строка.
Описание
Функция представляет дополнительные возможности считывания файлов или
их частей. Параметр <lCtrl-Z> позволяет организовать считывание данных
только до первого символа CHR(26), соответствующего комбинации клавиш
<Ctrl><Z>.
Данная функция уступает по скорости Clipper-функциям семейства
Fxxxx(), т.к. не позволяет оставлять файл открытым при считывании по
сегментам.
Примечания
. Функция может считывать столько байтов, сколько позволяет рабочая
память, но не более 65520. Объем доступной свободной памяти можно
определить с помощью вызова MEMORY(1).
. В сетевом окружении рекомендуется вызовом SETSHARE(2) запретить
другим пользователям запись в данный файл во время считывания.
Примеры
. Считывание всего файла:
? FILESTR("C:\TEXT\TEST.TXT") // Вывод текста файла
. Считывание до первого символа CHR(26):
cVar := FILESTR("C:\TEXT\TEST.TXT", .T.)