Espruino:Справочник по API/Библиотека Storage/read()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Функция Storage.read()[1]

Синтаксис

require("Storage").read(name, offset, length)

Параметры

  • name – название файла (максимум 28 символов; чувствителен к регистру символов)
  • offset – смещение к месту, с которого нужно начать чтение (в байтах). Это опциональный аргумент
  • length – количество байтов, которые нужно прочесть (если меньше или равно 0, будет прочитан весь файл). Это опциональный аргумент

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

Строку с данными.

Описание

Считывает файл из Storage-области flash-памяти, который был записан с помощью require("Storage").write(...).

Возвращает отображенную в память строку, указывающую на участок в памяти только для чтения. То есть RAM-память в итоге не расходуется.

Кроме того, вы можете проверить наличие файла при помощи require("Storage").read(filename)!==undefined.

Если вы выполните эту строку при помощи eval(), то все функции, содержащиеся в этой строке, продолжат хранить свой код в flash-памяти.

Примечание

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

Примеры

Эта функция используется в следующих статьях документации Espruino:

См.также

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