Espruino:Справочник по API/Класс StorageFile

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

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


Класс StorageFile[1]

Эти объекты создаются при помощи require("Storage").open и позволяют записывать/считывать данные из объектов Storage.

Библиотека Storage записывает данные в flash-память (которую можно стирать только кусочками) и в отличие от обычной файловой системы выделяет память под файлы одной большой смежной областью, чтобы Espruino было проще получить к ним доступ.

Это представляет трудность для класса StorageFile, позволяющего добавлять данные в файл, и поэтому StorageFile сохраняет файлы кусочками. В нем последний символ названия файла обозначает номер кусочка файла (например, "foobar\1", "foobar\2" и т.д.).

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

f = s.open("foobar","w");
f.write("Hell");
f.write("o World\n");
f.write("Hello\n");
f.write("World 2\n");
// Вызывать 'close' нужды нет.
// Затем:
f = s.open("foobar","r");
f.read(13) // "Hello World\nH"
f.read(13) // "ello\nWorld 2\n"
f.read(13) // "Hello World 3"
f.read(13) // "\n"
f.read(13) // undefined
// ...или...
f = s.open("foobar","r");
f.readLine() // "Hello World\n"
f.readLine() // "Hello\n"
f.readLine() // "World 2\n"
f.readLine() // "Hello World 3\n"
f.readLine() // undefined
// Теперь избавляемся от файла:
f.erase();
Примечание

Для определения конца файла класс StorageFile использует тот факт, что все биты стертой flash-памяти являются единицами. Поэтому нельзя записывать в эти файлы символьный код 255 ("\xFF").

См.также

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