sdcard — SD-картка

Функції для роботи з файлами на SD-картці.

Приклад:

 1// Список файлів у кореневій директорії
 2let files = sdcard.ls("/");
 3for (let i = 0; i < files.length; i++) {
 4    console.print(files[i]);
 5}
 6
 7// Читання файлу
 8let f = sdcard.open("/test.txt", "r");
 9let content = f.read(f, 1024);
10console.print(content);
11f.close(f);

Функції

sdcard.ls(path)

Повертає масив імен файлів і папок у заданій директорії.

Arguments:

  • path (string()) – Шлях до директорії.

Повертає:

Масив рядків або undefined, якщо SD-картка недоступна.

Тип повернення:

Array

sdcard.remove(path)

Видаляє файл з SD-картки.

Arguments:

  • path (string()) – Шлях до файлу.

sdcard.rename(oldName, newName)

Перейменовує або переміщує файл.

Arguments:

  • oldName (string()) – Поточний шлях.

  • newName (string()) – Новий шлях.

sdcard.open(path[, mode])

Відкриває файл і повертає файловий об’єкт.

Arguments:

  • path (string()) – Шлях до файлу.

  • mode (string()) – (необов’язково) Режим відкриття ("r", "w", "a" тощо). За замовчуванням: "r".

Повертає:

Файловий об’єкт з методами (див. нижче).

Тип повернення:

object

Файловий об’єкт

Методи файлового об’єкта, поверненого sdcard.open(). У кожен метод першим аргументом передається сам файловий об’єкт.

file.size(file)

Повертає розмір файлу у байтах.

Повертає:

Розмір.

Тип повернення:

number

file.seek(file, offset)

Переміщує покажчик у файлі на вказану позицію.

Arguments:

  • offset (number()) – Позиція у байтах від початку файлу.

file.read(file, maxBytes)

Зчитує до maxBytes байтів з файлу як рядок.

Arguments:

  • maxBytes (number()) – Максимальна кількість байтів.

Повертає:

Зчитані дані.

Тип повернення:

string

file.write(file, text)

Записує текст у файл.

Arguments:

  • text (string()) – Текст для запису.

file.exists(file)

Перевіряє, чи файловий покажчик валідний.

Повертає:

true, якщо файл відкрито успішно.

Тип повернення:

boolean

file.close(file)

Закриває файл. Обов’язково викликайте після завершення роботи з файлом.