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").

См.также

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