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

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[https://www.espruino.com/Reference#l_Storage_readArrayBuffer www.espruino.com - require("Storage").readArrayBuffer(name)]</ref>=
=Функция Storage.readArrayBuffer()<ref>[https://www.espruino.com/Reference#l_Storage_readArrayBuffer www.espruino.com - require("Storage").readArrayBuffer(name)]</ref>=


==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript" enclose="div">
 
require("Storage").readArrayBuffer(name)
</syntaxhighlight>
</syntaxhighlight>


==Параметры==
==Параметры==


 
* '''name''' – название файла (максимум 28 символов; чувствителен к регистру символов)


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


Объект ArrayBuffer, содержащий данные из файла, или undefined.


==Описание==


==Описание==
Считывает файл из Storage-области flash-памяти, который был записан при помощи require("Storage").write(...), и возвращает неформатированные двоичные данные в виде объекта ArrayBuffer.
 
Эту функцию можно использовать:
* В объекте [https://www.espruino.com/Reference#DataView DataView] при помощи new DataView(require("Storage").readArrayBuffer("x"))
* В объектах Uint8Array, Float32Array и т.д. при помощи new Uint8Array(require("Storage").readArrayBuffer("x"))


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


'''Примечание:''' Эта функция не доступна для устройств с маленькой flash-памятью.


== Примеры ==
== Примеры ==

Версия от 14:04, 28 февраля 2021

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


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

Синтаксис

require("Storage").readArrayBuffer(name)

Параметры

  • name – название файла (максимум 28 символов; чувствителен к регистру символов)

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

Объект ArrayBuffer, содержащий данные из файла, или undefined.

Описание

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

Эту функцию можно использовать:

  • В объекте DataView при помощи new DataView(require("Storage").readArrayBuffer("x"))
  • В объектах Uint8Array, Float32Array и т.д. при помощи new Uint8Array(require("Storage").readArrayBuffer("x"))

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

Примечание: Эта функция не доступна для устройств с маленькой flash-памятью.

Примеры

См.также

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