ILB_dprintf_rtn


cCall [ilb.ILB_dprintf_rtn],<<OFFSET32 szFormat>, val1, ...>

Displays information on the debug terminal, providing a subset of the formatting provded by the C-runtime printf function. The function processes the given string, converting format control sequences in the string to characters or numbers, using the corresponding values passed as parameters.

szFormat

Address of a null-terminated string. The string can contain any printable characters and any combination of the following format control sequences:

%b

Displays an 8-bit value as a hexadecimal integer. Must pass a doubleword value with the value to display in the low byte.

%c

Displays the character at the given address. Must pass a valid, 32-bit address.

%d

Displays the corresponding 32-bit value as a decimal integer. Must pass a doubleword value.

%e

Displays the corresponding 32-bit value as a hexadecimal integer. Must pass a doubleword value.

%i

Displays a 16-bit value as an unsigned decimal integer. Must pass a doubleword value with the value to display in the low word.

%j

Displays an 8-bit value as a unsigned decimal integer. Must pass a doubleword value with the value to display in the low byte.

%lx

Displays the 32-bit value at the given address as a hexadecimal integer. Must pass a valid, 32-bit address.

%p

Displays the given address in 16:16 (segment:offset) notation. Segment and offset values are displayed as hexadecimal integers.

%s

Displays the null-terminated string at the given address. Must pass a valid, 32-bit address.

%u

Displays the 16-bit value at the given address as an unsigned decimal integer. Must pass a valid, 32-bit address.

%w

Displays a 16-bit value as a hexadecimal integer. Must pass a doubleword value with the value to display in the low word.

%x

Displays the 16-bit value at the given address as a hexadecimal integer. Must pass a valid, 32-bit address.

%z

Displays a memory dump, consisting of a given number of bytes display as hexadecimal integers. Must pass a 16-bit value specifying the number of bytes to display and a valid, 32-bit address pointing to the bytes to display.

%%

Displays the percent character (%).


val1

Value or address, depending on the corresponding format control sequence. Except for the %z format, there must be one 32-bit value passed for each format control sequence in the string. For %z, two 32-bit values must be passed.

See also ILB