Клиппер 5. Справочник


Клиппер 5. Справочник - часть 386


        [<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.)



Начало  Назад  Вперед



Книжный магазин