Message("Число-%3x \n",1);

Число- 1

Если выводимое число не укладывается в n позиций, то оно выводится целиком.

Например:

Message("Число-%3x \n",0x1234);

Число-1234

n длина выводимого десятичного числа, при необходимости дополняемая слева незначащими нулями. Пример:

Message("Число-%03d",1);

Число-001

Если выводимое число не укладывается в n позиций, то оно выводится целиком.

Пример

Message("Число-%03d",1000)

Число-1000

n длина выводимого шестнадцатеричного числа, при необходимости дополняемая слева незначащими нулями. Пример:

Message("Число-%03x",0x1);

Число-001

Если выводимое число не укладывается в n позиций, то оно выводится целиком.

Пример:

Message("Число-%03x",0x1234); Число-1234

%0nx

Вывод префикса 0x перед шестрадцатиричными числами Пример:

Message("%#x",123);

0x123

Вывод префикса 0 перед восьмеричными числами

Пример:

Message("%#o",1);

%n I Количество выведенных символов (не поддерживается)

long readshort (long handle,long mostfirst);

Функция считывает два байта из файла. До начала операции файл должен быть открыт функцией fopen с правами на чтение.

Примечательной особенностью данной функции является возможность трансляции знакового бита во время чтения.

Если флаг mostfirst равен нулю, то функция будет полагать, что знаковый бит, расположен «слева», то есть, идет самым старшим в слове. Наоборот, если флаг mostfirst равен единице, то функция будет ожидать, что знаковый бит, расположен «справа» то есть идет самым младшим в слове.

В случае если во время выполнения функции возникнут ошибки, то будет возращена константа BADADDR - иначе 16-битное прочитанное значение.

long readlong (long handle,long mostfirst);

Функция считывает четыре байта из файла. До начала операции файл должен быть открыт функцией fopen с правами на чтение.

Примечательной особенностью данной функции является возможность трансляции знакового бита во время чтения.

Если флаг mostfirst равен нулю, то функция будет полагать, что знаковый бит, расположен «слева», то есть, идет самым старшим в двойном слове. Наоборот, если флаг mostfirst равен единице, то функция будет ожидать, что знаковый бит, расположен «справа» то есть идет самым младшим в двойном слове.

В случае если во время выполнения функции возникнут ошибки, то будет возращена константа BADADDR - иначе 32-битное прочитанное значение. Формально функция не возвращает ошибку, потому что она неотличима от возможного 32-битного значения.

Однако в результате ошибки BADADDR все же возвращается. Например:

Message("0x%X \n",readlong(123)); 0xFFFFFFFF

long writeshort (long handle,long word,long mostfirst);

Функция записывает два байта в файл. До начала операции файл должен быть открыт функцией fopen с правами на запись.

Примечательной особенностью данной функции является возможность трансляции знакового бита во время чтения.

Если флаг mostfirst равен нулю, то функция будет полагать, что знаковый бит, расположен «слева», то есть, идет самым старшим в слове. Наоборот, если флаг mostfirst равен единице, то функция будет ожидать, что знаковый бит, расположен «справа» то есть идет самым младшим в слове.

В случае если во время выполнения функции возникнут ошибки, то будет возращено ненулевое значение.

long writelong (long handle,long dword,long mostfirst);

Функция записывает четыре байта в файл. До начала операции файл должен быть открыт функцией fopen с правами на запись.

Примечательной особенностью данной функции является возможность трансляции знакового бита во время чтения.

Если флаг mostfirst равен нулю, то функция будет полагать, что знаковый бит, расположен «слева», то есть, идет самым старшим в двойном слове. Наоборот, если флаг mostfirst равен единице, то функция будет ожидать, что знаковый бит, расположен «справа» то есть идет самым младшим в двойном слове.

В случае если во время выполнения функции возникнут ошибки, то будет возращено ненулевое значение.

char readstr (long handle);

Функция читает стоку из файла (с текущей позиции до символа EOL). До начала операции файл должен быть открыт функцией fopen с правами на чтение.

Не зависимо от заданного типа при открытии файла (текстовой или двоичный) readstr всегда правильно распознает конец стоки представленный как 0xD 0xA, так и 0xA. Однако если файл открыт как текстовой, то функция будет преобразовывать все символы 0xA в 0xD 0xA. Что можно наблюдать на следующем примере:

auto a;

a=fopen("readme.txt","rb");

Message(readstr(a));

This patch allows you to permanently access the bonus track and bonus car

auto a;

a=fopen("readme.txt","rt");

Message(readstr(a));

This patch allows you to permanently access the bonus track and bonus car

Операнд Пояснения

Дескриптор открытого с правами на чтение файла

Handle