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-строку перед записью
Примечание

Если в data будет задан массив, он не будет преобразован в JSON-строку. Чтобы явно преобразовать его в JSON-строку, можно воспользоваться Storage.writeJSON().

Кроме того, вы можете создать файл и затем наполнить его данными – но только в том случае, если вы не пытаетесь перезаписать данные, которые в нем уже есть. Например:

var f = require("Storage");
f.write("a","Hello",0,14);
f.write("a"," ",5);
f.write("a","World!!!",6);
print(f.read("a"));

Это может оказаться полезным, если вам нужно записать больше данных, чем позволяет RAM.

Примечание

Эту функцию нужно использовать с обычными файлами, а не с файлами типа StorageFile, созданными с помощью require("Storage").open(filename, ...).

Примеры

См.также

Внешние ссылки