Espruino:Справочник по API/Библиотека Storage/read(): различия между версиями
Myagkij (обсуждение | вклад) Нет описания правки |
Myagkij (обсуждение | вклад) Нет описания правки |
||
Строка 3: | Строка 3: | ||
{{Myagkij-редактор}} | {{Myagkij-редактор}} | ||
=<ref>[https://www.espruino.com/Reference#l_Storage_read www.espruino.com - require("Storage").read(name, offset, length)]</ref>= | =Функция Storage.read()<ref>[https://www.espruino.com/Reference#l_Storage_read www.espruino.com - require("Storage").read(name, offset, length)]</ref>= | ||
==Синтаксис== | ==Синтаксис== | ||
<syntaxhighlight lang="javascript" enclose="div"> | <syntaxhighlight lang="javascript" enclose="div"> | ||
require("Storage").read(name, offset, length) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==Параметры== | ==Параметры== | ||
* '''name''' – название файла (максимум 28 символов; чувствителен к регистру символов) | |||
* '''offset''' – смещение к месту, с которого нужно начать чтение (в байтах). Это опциональный аргумент | |||
* '''length''' – количество байтов, которые нужно прочесть (если меньше или равно 0, будет прочитан весь файл). Это опциональный аргумент | |||
==Возвращаемое значение== | |||
Строку с данными. | |||
== | ==Описание== | ||
Считывает файл из Storage-области flash-памяти, который был записан с помощью require("Storage").write(...). | |||
Возвращает отображенную в память строку, указывающую на участок в памяти только для чтения. То есть RAM-память в итоге не расходуется. | |||
== | Кроме того, вы можете проверить наличие файла при помощи require("Storage").read(filename)!==undefined. | ||
Если вы выполните эту строку при помощи [https://www.espruino.com/Reference#l__global_eval eval()], то все функции, содержащиеся в этой строке, продолжат хранить свой код в flash-памяти. | |||
'''Примечание:''' Эту функцию необходимо использовать с обычными файлами, а не с файлами типа [https://www.espruino.com/Reference#StorageFile StorageFile], созданными с помощью require("Storage").open(filename, ...). | |||
== Примеры == | == Примеры == | ||
Эта функция используется в следующих статьях документации [[Espruino]]: | |||
* [https://www.espruino.com/Graphics#line=95 Графическая библиотека] | |||
=См.также= | =См.также= |
Версия от 14:03, 28 февраля 2021
Функция 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:
См.также
развернутьПартнерские ресурсы |
---|
Внешние ссылки
развернутьСправочник по API Espruino |
---|