Espruino:Справочник по API/Библиотека Storage/write(): различия между версиями
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки |
Myagkij (обсуждение | вклад) Нет описания правки |
||
(не показана 1 промежуточная версия 1 участника) | |||
Строка 33: | Строка 33: | ||
* ...объект, он будет автоматически преобразован в JSON-строку перед записью | * ...объект, он будет автоматически преобразован в JSON-строку перед записью | ||
{{Примечание1|Если в data будет задан массив, он не будет преобразован в JSON-строку. Чтобы явно преобразовать его в JSON-строку, можно воспользоваться [https://www.espruino.com/Reference#l_Storage_writeJSON Storage.writeJSON()].}} | |||
Кроме того, вы можете создать файл и затем наполнить его данными – но только в том случае, если вы не пытаетесь перезаписать данные, которые в нем уже есть. Например: | Кроме того, вы можете создать файл и затем наполнить его данными – но только в том случае, если вы не пытаетесь перезаписать данные, которые в нем уже есть. Например: | ||
Строка 47: | Строка 47: | ||
Это может оказаться полезным, если вам нужно записать больше данных, чем позволяет RAM. | Это может оказаться полезным, если вам нужно записать больше данных, чем позволяет RAM. | ||
{{Примечание1|Эту функцию нужно использовать с обычными файлами, а не с файлами типа [https://www.espruino.com/Reference#StorageFile StorageFile], созданными с помощью require("Storage").open(filename, ...).}} | |||
== Примеры == | == Примеры == | ||
Строка 55: | Строка 55: | ||
=См.также= | =См.также= | ||
=Внешние ссылки= | =Внешние ссылки= | ||
Строка 61: | Строка 61: | ||
<references /> | <references /> | ||
{{Навигационная таблица/Espruino | {{Навигационная таблица/Портал/Espruino}} | ||
Текущая версия от 18:06, 28 мая 2023
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
Функция 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.
Примеры
См.также
Внешние ссылки