Приклад створення об'єкта доступу до файлової системи VolumeLocator
var sys=VolumeLocator ();
Можливо, створити кілька таких об'єктів, але всі вони будуть працювати з одним і тим же списком файлових систем. Тобто за наявності декількох об'єктів, зміна списку одним об'єктом призведе до зміни списків інших об'єктів і навпаки.
Метод sys.Find () призначений для оновлення списку доступних файлових систем. Наприклад, після підключення пристрої зберігання (Flash - накопичувача) необхідно викликати даний метод, щоб можна було отримати доступ до її файлової системи з користувальницького сценарію. При запуску інтерпретатора автоматично відбувається формування списку файлових систем, тому принезмінній конфігурації обладнання викликати даний метод необов'язково. У всіх інших випадках необхідно оновити список файлових систем.
Метод sys.NumberVolume () повертає значення кількості файлових систем знайдених останнім викликом Find ();
Метод sys.Volume (index) приймає в якості вхідного параметра - індекс і повертає об'єкт файлової системи. Індекс файлової системи в списку файлових систем - це ціле число в діапазоні від нуля до кількості файлових систем мінус один [0, NumberVolume () - 1].
Функція sys.StartVolume () повертає об'єкт файлової системи, яка містить файл запущеного інтерпретатора, тобто якщо програма запущена з USB - накопичувача, то даним методом буде повернений об'єкт файлової системи USB - накопичувача.
Для всіх далі описаних методів передаваний шлях може складатися з вкладених каталогів розділених знаком «», в тому числі і службових імен «.» і «..». Службове ім'я «.» Вказує на поточний каталог, тобто шляху «. Dir1 dir12» і «dir1 dir12» рівнозначні. Службове ім'я «..» вказує на батьківський каталог, тобто шляху «dir1 .. dir1 dir12» і «dir1 dir12» рівнозначні. Приклад шляхи: «.. dir file.txt»
Об'єкт Volume застосовується для отримання доступу до файлів і директорій файлової системи. Об'єкт створюється методами Volume (index) і StartVolume () об'єкта VolumeLocator.
Приклад створення об'єкта файлової системи Volume -
var vol=sys.StartVolume ();
Метод vol.ID () повертає ідентифікатор файлової системи. Ідентифікатор файлової системи незмінний для існуючих портів введення/виводу (наприклад, USB-портів) на весь час роботи програми. Якщо протягом часу роботи програми пристрій зберігання інформації буде виключено, а потім включено в той же самий порт, то після оновлення конфігурації пристрій зберігання буде мати той же ідентифікатор.
Метод vol.CheckFile (path) приймає на вхід шлях до файлу і визначає, чи існує по такому шляху файл і на виході повертає логічне значення «істина» або «брехня». У разі якщо шлях не вказує на файл або зовсім не існує, то повертається значення буде «брехня», в іншому випадку «істина».
Метод vol.CheckFolder (path) приймає на вхід шлях до директорії і визначає чи існує по такому шляху директорія і на виході повертає логічне значення «істина» або «брехня». У разі якщо шлях не вказує на директорію або зовсім не існує, то повертається значення буде «брехня», в іншому випадку «істина».
Метод vol.File (path) приймає на вхід шлях і повертає об'єкт файлу. При створенні об'єкта не проводитися ніяких перевірок, тобто шлях, який передається в метод, може не існувати або вказувати на директорію, в будь-якому випадку об'єкт файлу буде створений.
Метод vol.Folder (path) приймає на вхід шлях і повертає об'єкт директорії. При створенні об'єкта не проводитися ніяких перевірок, тобто шлях, який передається в метод, може не існувати або вказувати на файл, в будь-якому випадку об'єкт файлу буде створений.
Об'єкт Folder застосовується для отримання інформації про директорії і виконання операцій над вмістом директорії. Об'єкт створюється методом Folder (path) об'єктів Volume і Folder.
Приклад створення об'єкта директорії Folder -
var fol=vol.Folder (path);
Метод fol.Check () повертає логічне значення «істина», якщо шлях, що вказується при створенні об'єкта директорії, був вірним і був отриманий доступ до об'єкта, в іншому випадку повертається значення буде «брехня» і подальші операції з таким об'єктом безглузді.
Метод fol.Size () - повертає числове значення «0», відповідне файловому розміром директорії.
Метод fol.OnlyRead () повертає логічне значення «істина», якщо директорія має встановлений атрибут «тільки для читання», в іншому випадку повертається значення буде «бр...