WriteStringN()

Синтаксис

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

Описание

Записывает строку (string) в файл и добавляет символ 'конец строки'.

Параметры

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

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

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

Комментарии

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

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

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

If CreateFile(0, "Test.txt") ; Открывает существующий файл или создайте новый, если он не существует
    FileSeek(0, Lof(0)) ; Помещает указатель в конец файла, используя результат функции Lof()
    WriteString(0, "Одна строка.")
    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(), WriteString(), WriteStringFormat(), CreateFile(), OpenFile()

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

Все