WriteCharacter()

Синтаксис

Result = WriteCharacter(#File , Character.c [, Format])

Описание

Записывает значение Символа (1 байт без знака в ASCII, 2 байта без знака в unicode, или согласно #PB_UTF8) в файл.

Параметры

#File	Номер файла, в который будет производиться запись.
Character.c	Значение Символа для записи.
Format (дополн.)	Формат записываемого символа. Может быть одним из следующих значений: #PB_Ascii : 1 байтовый символ. #PB_Unicode: 2 байтовый символ (по умолчанию, см. unicode). #PB_UTF8 : много-байтовый символ (от 1 до 4 байт).

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

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

Комментарии

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

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

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

См. также

ReadCharacter(), WriteAsciiCharacter(), WriteUnicodeCharacter(), CreateFile(), OpenFile()

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

Все