PureBasic

ReadFile()

Синтаксис

Result = ReadFile(#File , Filename$ [, Flags])

Описание


Открывает существующий файл только для чтения.

Параметры

#File Номер, для идентификации файла. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
Filename$ Имя, включая путь к файлу. Если имя файла не включает полный путь, оно интерпретируется относительно текущего каталога.
Flags (дополн.) Этот параметр может быть комбинацией следующих значений (с помощью оператора '|'): 
  #PB_File_SharedRead : Если файл уже открыт другим процессом для операции чтения,
                        для доступа к нему необходим этот флаг (только для Windows).
  #PB_File_SharedWrite: Если файл уже был открыт другим процессом для операции записи,
                        для доступа к нему необходим этот флаг (только для Windows).
  #PB_File_NoBuffering: Существующая внутри PureBasic система буферизации файлов будет отключена для этого файла. 
                        функция FileBuffersSize() не может использоваться с этим файлом.
В сочетании с одним из следующих значений (следующие флаги влияют на поведение функций ReadString() и ReadCharacter()): 
  #PB_Ascii  : Все операции чтения строк будут в ascii, если не указано иное.
  #PB_UTF8   : Все операции чтения строк будут в UTF-8, если не указано иное (по умолчанию).
  #PB_Unicode: Все операции чтения строк будут в Unicode, если не указано иное.

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

Возвращает не нулевое значение, если файл был открыт успешно, в случае ошибки возвращает ноль. Если в качестве параметра #File использовалось значение #PB_Any, то в случае успеха будет возвращен сгенерированный Номер.

Комментарии

Чтобы открыть файл для чтения и записи, используйте функцию OpenFile().
Чтобы создать новый и пустой файл, используйте функцию CreateFile().

Пример

If ReadFile(0, "Text.txt") ; если файл можно читать, продолжаем...
    While Eof(0) = 0        ; цикл пока не достигнут 'конец файла'
        Debug ReadString(0) ; отображаем строка за строкой в отладочном окне
    Wend
    CloseFile(0) ; закроем ранее открытый файл
Else
    MessageRequester("Инфо", "Не удалось открыть файл!")
EndIf

См. также

OpenFile(), CreateFile(), CloseFile()

Поддерживаемые OS

Все

<- ReadDouble() - Оглавление File - ReadFloat()->