ReadString()

Синтаксис

Text$ = ReadString(#File [, Flags [, Length]])

Описание

Читает строку (string) из файла до тех пор, пока не будет найден символ 'End Of Line' (конец строки) или 'Null' (поддерживаются форматы файлов Unix, DOS и Macintosh).

Параметры

#File	Номер файла, из которого будет производиться чтение.
Flags (дополн.)	Флаги, применяемые при чтении строки. Может быть одним из следующих значений: #PB_Ascii : Читает строку как ASCII, даже если программа скомпилирована в режиме Unicode. #PB_UTF8 : Читает строку как UTF8. #PB_Unicode: Читает строку как UTF16. В сочетании с: #PB_File_IgnoreEOL: Игнорирует конец строки (но полученная строка будет по-прежнему содержать их) до указанной длины или конца файла.
Length (дополн.)	Длина. Читает файл, пока не будет достигнуто данное значение длины (в символах). Если до достижения длины встречается 'конец строки', чтение прекращается (если не установлен флаг #PB_File_IgnoreEOL).

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

Возвращает прочитанную строку, или если чтение не удалось - возвращает пустую строку .

Комментарии

Для определения формата используемой в файле кодировки строк (метки порядка байтов), используйте функцию ReadStringFormat().

Пример (фран.)

If CreateFile(0, "Test.txt") ; Открывает существующий файл или создайте новый, если он не существует
    FileSeek(0, Lof(0)) ; Помещает указатель в конец файла, используя результат функции Lof()
    WriteStringN(0, "... другая строка в конец файла.")
    CloseFile(0)
EndIf
If ReadFile(0, "Test.txt") ; Если файл можно прочитать, продолжаем...
    While Eof(0) = 0        ; Цикл, пока не будет достигнут конец файла. (Eof = 'Конец файла')
        Debug ReadString(0) ; Отображение строки
    Wend
    CloseFile(0) ; Закрывает ранее открытый файл
Else
    MessageRequester("Инфо", "Невозможно открыть файл!")
EndIf

См. также

WriteString(), ReadStringFormat(), OpenFile(), ReadFile()

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

Все