WriteData()

Синтаксис

Result = WriteData(#File , *MemoryBuffer , Length)

Описание

Записывает содержимое указанного буфера памяти в файл.

Параметры

#File	Номер файла, в который будет производиться запись.
*MemoryBuffer	Адрес буфера памяти с данными, предназначенными для записи в файл.
Length	Количество байт, которые требуется записать.

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

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

Комментарии

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

Пример

*MemoryID = AllocateMemory(1000) ; выделим блок памяти
If *MemoryID
    PokeS(*MemoryID, "Сохраняет эту строку в области памяти") ; мы пишем строку в блок памяти
EndIf
If CreateFile(0, GetHomeDirectory()+"Text.txt") ; создаем новый текстовый файл...
    WriteData(0, *MemoryID, SizeOf(Character)* Len("Сохраняем эту строку в области памяти")) ; записываем текст из блока памяти в файл
    CloseFile(0) ; закрываем ранее открытый файл и сохраните записанные данные
Else
    Debug "невозможно создать файл!"
EndIf

См. также

ReadData(), CreateFile(), OpenFile()

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

Все