Espruino:Справочник по API/Библиотека Storage/write()
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
Функция Storage.write()[1]
Синтаксис
require("Storage").write(name, data, offset, size)
Параметры
- name – название файла (максимум 28 символов; чувствителен к регистру символов)
- data – данные, которые надо записать
- offset – смещение внутри файла к месту, откуда надо начать запись
- size – размер файла (если создаваемый файл больше данных в data)
Возвращаемое значение
При успешном выполнении – true, при неуспешном – false.
Описание
Создает файл в Storage-области flash-памяти. Это долговременная (энергонезависимая) память, так что эти данные не пропадут после сброса устройства или отключения питания.
Просто воспользуйтесь require("Storage").write("MyFile", "Some data"), чтобы создать новый файл, а затем require("Storage").read("MyFile"), чтобы прочесть его.
Если задать в аргументе data...
- ...сроку, она будет записана как есть
- ...массив, он будет записан как массив байтов (но считан как строка)
- ...объект, он будет автоматически преобразован в JSON-строку перед записью
Кроме того, вы можете создать файл и затем наполнить его данными – но только в том случае, если вы не пытаетесь перезаписать данные, которые в нем уже есть. Например:
var f = require("Storage");
f.write("a","Hello",0,14);
f.write("a"," ",5);
f.write("a","World!!!",6);
print(f.read("a"));
Это может оказаться полезным, если вам нужно записать больше данных, чем позволяет RAM.
Примеры
См.также
Внешние ссылки