Плагин дает возможность работать с файлами побайтово.
Актуальная версия :
FilesAPI0000.zip ( 30,63 килобайт )
Кол-во скачиваний: 2577Минимальная версия пилота : 2.36Описание функций :
CreateFile
Код
set $a FilesAPI.CreateFile (<имя файла>) - Создает файл и автоматически дает доступ к чтению/записи.
Возвращаемое значения :
-1 - ошибка создания файла
<рандомное число> - хендл файла
OpenFile
Код
set $a FilesAPI.OpenFile (<имя файла> <режим открытия>) - Открывает существующий файл в заданном
режиме.
Допустимые значения <режим открытия> :
Read
Write
ReadWrite
Возвращаемые значения :
-1 - ошибка открытия файла
-2 - <режим открытия> либо задан некорректно либо вообще не задан
<рандомное число> - хендл файла
CloseFile
Код
set $a FilesAPI.CloseFile (<хендл файла>) - Закрывает файл.
Возвращаемые значения :
-1 - ошибка закрытия ли неправильный хендл
1 - успешно
SetFilePos
Код
set $a FilesAPI.SetFilePos (<хендл файла> <смещение> <позиция>) - Устанавливает указатель в файле на нужное <смещение> относительно <позиция>
Допустимые значения <смещение> :
Любое неотрицательное число (желательно не превышать общий размер файла).
Допустимые значения <позиция> :
FILE_CURRENT - текущая позиция
FILE_BEGIN - начало файла
FILE_END - конец файла
Возвращаемые значения :
-1 - ошибка установки смещения
-2 - некорректное <смещение>
-3 - неккоректное <позиция>
<число> - новая позиция в файле
SetWriteMode
Код
set $a FilesAPI.SetWriteMode (<хендл файла> <режим>) - устанавливает порядок записи байт.
Допустимые значения <режим> :
LE - litle-endian порядок
BE - big-endian порядок
Возвращаемые значения :
-1 - ошибка, возможно некорректный хендл файла
-2 - <режим> либо не задан либо некорректен
1 - успешно
Примечания :
SetWriteMode влияет только на работу функций WriteWORD, WriteDWORD. Остальные функции записи
игнорируют этот параметр.
SetReadMode
Код
set $a FilesAPI.SetReadMode (<хендл файла> <режим>) - устанавливает порядок чтения байт.
Допустимые значения <режим> :
LE - litle-endian порядок
BE - big-endian порядок
Возвращаемые значения :
-1 - ошибка, возможно некорректный хендл файла
-2 - <режим> либо не задан либо некорректен
1 - успешно
Примечания :
SetReadMode влияет только на работу функций ReadWORD, ReadDWORD. Остальные функции чтения
игнорируют этот параметр.
WriteBYTE
Код
set $a FilesAPI.WriteBYTE (<хендл файла> <байт>) - пишет байт в файл в текущую позицию.
Допустимые значения <байт> :
Все числа в диапозоне 0..255.
Возвращаемые значения :
-1 - ошибка записи или некорректный хендл
-2 - некорректный параметр <байт>
1 - успешно
WriteWORD
Код
set $a FilesAPI.WriteWORD (<хендл файла> <слово>) - запись в файл слова в текущую позицию.
Допустимые значения <слово> :
Число, не превышающее 65535.
Возвращаемые значения :
-1 - ошибка записи или неверный хендл.
-2 - некорректный параметр <слово>.
1 - успешно
WriteDWORD
Код
set $a FilesAPI.WriteDWORD (<хендл файла> <дворд>) - запись двойного слова в файл в текущую
позицию.
Допустимые значения <дворд> :
Число, не превышающее 4294967295.
Возвращаемые значения :
-1 - ошибка записи или неверный хендл.
-2 - некорректный параметр <дворд>.
1 - успешно
WriteArrayOfByte(для версий <= 2.35)
Код
set $a FilesAPI.WriteArrayOfByte (<хендл файла> <байты>) - запись массива байт в файл в
текущую позицию.
Допустимые значения <байты> :
Массив размерностью [1 N] элементов, содержащих числа в диапозоне 0..255.
Возвращаемые значения :
-1 - ошибка записи или неверный хендл
-2 - некорректный параметр <байты>
<число> - успешно. сколько фактически записано байт.
Примечания :
Перед вызовом функции необходимо установить разделитель элементов массива как пробел.
set delimiter ' '
WriteArrayOfByte(для версий >= 2.36)
Неготово.
ReadBYTE
Код
set $a FilesAPI.ReadBYTE (<хендл файла>) - чтение байта из файла с текущей позиции.
Возвращаемые значения :
-1 - ошибка чтения или неверный хендл.
<число> - успешно. прочитанный байт.
ReadWORD
Код
set %a FilesAPI.ReadWORD (<хендл файла>) - чтение слова из файла с текущей позиции.
Возвращаемые значения :
-1 - ошибка чтения или неверный хендл
Массив размером [1 2] в котором содержаться :
[1 1] - старший байт слова
[1 2] - младший байт слова
Примечания :
Порядок возвращаемых байт зависит от SetReadMode.
ReadDWORD
Код
set %a FilesAPI.ReadDWORD (<хендл файла>) - чтение двойного слова из файла с текущей позиции.
Возвращаемые значения :
-1 - ошибка чтения или неверный хендл
Массив размером [1 2] в котором содержаться :
[1 1] - старшее слово дворда
[1 2] - младшее слово дворда
Примечания :
Порядок возвращаемых слов зависит от SetReadMode.
ReadArrayOfByte (для версий <= 2.35)
Код
set $a FilesAPI.ReadArrayOfByte (<хендл файла> <кол-во байт>) - чтение массива байт из
файла с текущей позиции.
Допустимые значения <кол-во байт> :
Неотрицательное число до 1048575.
Возвращаемые значения :
-1 - ошибка чтения или неверный хендл
-2 - некорректный параметр <кол-во байт>
Массив размером [1 <кол-во байт>]
ReadArrayOfByte (для версий >= 2.36)
Неготово.
LogicOR
Код
set $a FilesAPI.LogicOR (<операнд 1> <операнд 2>) - логическое ИЛИ.
Допустимые значения <операнд 1> и <операнд 2> :
Числа до 4294967295
Возвращаемые значения :
-1 - ошибка.
-2 - некорректный(е) параметры.
<число> - успешно. Результат.
LogicXOR
Код
set $a FilesAPI.LogicXOR (<операнд 1> <операнд 2>) - логичесоке исключающее ИЛИ.
Допустимые значения <операнд 1> и <операнд 2> :
Числа до 4294967295
Возвращаемые значения :
-1 - ошибка
-2 - некорректный(е) параметры
<число> - успешно. Результат.
LogicSHL
Код
set $a FilesAPI.LogicSHL (<операнд 1> <операнд 2>) - поразрядный сдвиг влево.
Допустимые значения <операнд 1> и <операнд 2> :
Числа до 4294967295
Возвращаемые значения :
-1 - ошибка
-2 - некорректный(е) параметры
<число> - успешно. Результат.
LogicSHR
Код
set $a FilesAPI.LogicSHR (<операнд 1> <операнд 2>) - поразрядный сдвиг вправо.
Допустимые значения <операнд 1> и <операнд 2> :
Числа до 4294967295
Возвращаемые значения :
-1 - ошибка
-2 - некорректный(е) параметры
<число> - успешно. Результат.
LogicAND
Код
set $a FilesAPI.LogicAND (<операнд 1> <операнд 2>) - логичесоке И.
Допустимые значения <операнд 1> и <операнд 2> :
Числа до 4294967295
Возвращаемые значения :
-1 - ошибка
-2 - некорректный(е) параметры
<число> - успешно. Результат.
LowBYTE
Код
set $a FilesAPI.LowBYTE (<слово>) - получение младшего байта из слова.
Допустимые значения <слово>:
Числа до 65535.
Возвращаемые значения :
-1 - ошибка
-2 - некорректный параметр <слово>
<число> - успешно. Результат.
HighBYTE
Код
set $a FilesAPI.HighBYTE (<слово>) - получение старшего байта из слова.
Допустимые значения <слово>:
Числа до 65535.
Возвращаемые значения :
-1 - ошибка
-2 - некорректный параметр <слово>
<число> - успешно. Результат.
LowWORD
Код
set $a FilesAPI.LowWORD (<дворд>) - получение младшего слова из дворд.
Допустимые значения <дворд>:
Числа до 4294967295.
Возвращаемые значения :
-1 - ошибка
-2 - некорректный параметр <дворд>
<число> - успешно. Результат.
HighWORD
Код
set $a FilesAPI.HighWORD (<дворд>) - получение страшего слова из дворд.
Допустимые значения <дворд>:
Числа до 4294967295.
Возвращаемые значения :
-1 - ошибка
-2 - некорректный параметр <дворд>
<число> - успешно. Результат.
BuildWORD
Код
set $a FilesAPI.BuildWORD (<байт> <байт>) - сборка двух байт в одно слово.
Допустимые значения <байт>'ов:
Числа 0..255.
Возвращаемые значения :
-1 - ошибка
-2 - некорректный параметр(ы) <байт>
<число> - успешно. Результат.
BuildDWORD
Код
set $a FilesAPI.BuildDWORD (<слово> <слово>) - сборка двух слов в один дворд.
Допустимые значения <слово>'ов:
Числа до 4294967295.
Возвращаемые значения :
-1 - ошибка
-2 - некорректный параметр(ы) <слово>
<число> - успешно. Результат.
Основные моменты :
1)Все параметры
регистрозависимые.
2)Все параметры
заключаются с обоих сторон символом '*'.
3)В параметрах допускаются пробелы, но они обрезаются(если с расположены с краев).
4)Все функции чтения/записи меняют значение позиции указателя в файле(указатель на текущий байт).
Имейте это ввиду и контролируйте функций SetFilePos.5)После окончания работы с файлом необходимо его закрыть.
6)В один файл можно писать/читать из нескольких вкладок(особо не тестил, но вроде работает).
7)Маск. размер файла - 2Гб.