PUTBCD - output the contents of a BCD string.

Alternate Entry Name: .PTBCD

Usage:

B:
   putbcd( string [, length, offset, fill ] );

C:
   void putbcd(void *string [, int length,
               int offset, int fill] );

Where:

string

points to the beginning of a string of BCD characters in memory.

offset

is a character offset into "string". The initial character of "string" has an offset of zero, the next character has an offset of one, and so on. The default "offset" is zero, so that printing begins at the start of "string".

length

is the number of characters to print. If "length" is not specified the default is six, so that a complete word of BCD characters is printed.

fill

is an ASCII character to be printed in place of any trailing blanks in "string". The default "fill" character is an ASCII null (000, '*e'); the result of this is that trailing blanks are simply stripped.

Description:

PUTBCD converts a string of BCD characters into their ASCII equivalents and outputs them on the current write unit. For most applications, PRINTF should be used instead of PUTBCD.

See Also:

expl b lib printf

Copyright © 1996, Thinkage Ltd.