WriteString()

Синтаксис

Result = WriteString(#File , Text$ [, Format])

Описание

Записывает строку (string) в файл.

Параметры

#File	Номер файла, в который будет производиться запись.
Text$	Строка для записи.
Format (дополн.)	Формат, в котором можно записать строку. Этот параметр может быть одним из следующих значений: #PB_Ascii : Пишет строку в формате ASCII #PB_UTF8 : Пишет строку в формате UTF8 #PB_Unicode: Пишет строку в формате UTF16

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

Возвращает не нулевое значение, если операция прошла успешно, в противном случае 0.

Комментарии

Из-за буферизации файлов эта функция может возвратиться успешно, даже если на устройстве вывода недостаточно места для операции записи. Файл должен быть открыт с разрешением функции записи (то есть не с помощью ReadFile()). Символ 'NUL' (конец строки) не будет записан в файл.

Чтобы вставить BOM (метка порядка байт), для последующего опознания формата строковой кодировки файла предусмотрена функция WriteStringFormat(). Чтобы записать строку и добавить символ 'конец строки', используйте функцию WriteStringN().

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

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

См. также

ReadString(), WriteStringN(), WriteStringFormat(), CreateFile(), OpenFile()

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

Все