Espruino:Справочник по API/Библиотека Storage/read(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
 
(не показана 1 промежуточная версия 1 участника)
Строка 31: Строка 31:
Если вы выполните эту строку при помощи [https://www.espruino.com/Reference#l__global_eval eval()], то все функции, содержащиеся в этой строке, продолжат хранить свой код в flash-памяти.
Если вы выполните эту строку при помощи [https://www.espruino.com/Reference#l__global_eval eval()], то все функции, содержащиеся в этой строке, продолжат хранить свой код в flash-памяти.


'''Примечание:''' Эту функцию необходимо использовать с обычными файлами, а не с файлами типа [https://www.espruino.com/Reference#StorageFile StorageFile], созданными с помощью require("Storage").open(filename, ...).
{{Примечание1|Эту функцию необходимо использовать с обычными файлами, а не с файлами типа [https://www.espruino.com/Reference#StorageFile StorageFile], созданными с помощью require("Storage").open(filename, ...).}}


== Примеры ==
== Примеры ==
Строка 40: Строка 40:
=См.также=
=См.также=


{{ads}}
 


=Внешние ссылки=
=Внешние ссылки=
Строка 46: Строка 46:
<references />
<references />


{{Навигационная таблица/Espruino}}
{{Навигационная таблица/Портал/Espruino}}
{{Навигационная таблица/Телепорт}}

Текущая версия от 18:05, 28 мая 2023

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


Функция 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:

См.также

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