Класс EV3File (Файл EV3) обеспечивает доступ к файловой системе блока EV3 для чтения или записи данных. К именам файлов может быть добавлен абсолютный путь начиная с корня (‘/’) для доступа к любому файлу в файловой системе или относительный, начиная с папки prjs.
Методы класса EV3File:
OpenWrite
EV3File.OpenWrite(fname)
Открывает файл для записи. Если файл уже существует, он будет перезаписан.
fname — Имя файла
Возвращает: Идентификатор данного открытого файла.
OpenAppend
EV3File.OpenAppend(fname)
Открывает файл для добавления в него данных. Если файл не существует, он будет создан.
fname — Имя файла
Возвращает: Идентификатор данного открытого файла.
OpenRead
EV3File.OpenRead(fname)
Открывает файл для чтения. Если файл не существует, возвращает 0.
fname — Имя файла
Возвращает: Идентификатор данного открытого файла или 0, если файл не существует
Close
EV3File.Close(file_handle)
Закрывает открытый файл.
file_handle — Идентификатор файла, полученный в момент открытия файла.
WriteLine
EV3File.WriteLine(file_handle, text)
Записывает текстовую строку в файл. Строка будет записана в кодировке ISO-8859-1 и оканчивается символом перевода строки (код 10).
file_handle — Идентификатор файла, полученный в момент открытия файла
text — Текст для записи в файл
WriteByte
EV3File.WriteByte(file_handle, num)
Записывает один байт данных в файл.
file_handle — Идентификатор файла, полученный в момент открытия файла
num — Один байт для записи (значение от 0 до 255).
ReadLine
EV3File.ReadLine(file_handle)
Читает текстовую строку из файла. Строка будет прочитана в кодировке ISO-8859-1 и должна оканчиваться символом перевода строки (код 10).
file_handle — Идентификатор файла, полученный в момент открытия файла
Возвращает: Текстовая строка, прочитанная из текущей строки файла (при следующем вызове функции будет прочитана следующая строка).
ReadByte
EV3File.ReadByte(file_handle)
Читает один байт из файла.
file_handle — Идентификатор файла, полученный в момент открытия файла
Возвращает: Очередной считанный из файла байт (целое число 0 — 255)
ReadNumberArray
EV3File.ReadNumberArray(file_handle, size)
Читает массив чисел из бинарного файла. Числа будут раскодированы с использованием кодировки IEEE как тип с плавающей точкой (Float) одинарной точности.
file_handle — Идентификатор файла, полученный в момент открытия файла
size — Размер одномерного массива, который будет прочитан из файла
Возвращает: Массив чисел указанного размера.
ConvertToNumber
EV3File.ConvertToNumber(text)
Конвертация текста в число.
text — Текст, содержащий цифры, составляющие число, которое может содержать дробную часть.
Возвращает: Число
TableLookup
EV3File.TableLookup(fname, bps, line, column)
Функция предназначена для чтения байт из потенциально огромных файлов, которые слишком велики для того, чтобы загружать их в память в целом. Поскольку файл может быть настолько большой, что просто линейной числовой адресации будет недостаточно, вводятся параметры строка и столбец, адресуя тем самым двумерную таблицу.
fname — Имя файла
bps — Если файл имеет структуру строк/столбцов, в параметре указывается число байт в строке, в противном случае надо указывать «1».
line — Строка, из которой надо считать байт (начиная с 0).
column — Столбец, из которого надо считать байт (начиная с 0).
Возвращает: 1 байт, считанный из указанной позиции.