Syntax

[C/C++:]
void gDisplayInteger(int number, int nwidth);
void gDisplayIntegerZero(int number, int nwidth);

[F90:]
subroutine gDisplayInteger(number, nwidth)
subroutine gDisplayIntegerZero(number, nwidth)

integer, intent(in) :: number,nwidth

Arguments

number
Integer value

nwidth
Field width

< 0,	Left-justified (gDisplayInteger() only)

= 0,

No output

> 0,	Right-justified

Description

The routines gDisplayInteger() and gDisplayIntegerZero() output the integer value number as a decimal character string. The number starts with a minus sign for values less than zero.

For gDisplayInteger(), if the number occupies less than nwidth character positions, the string is padded out with spaces. For positive values of nwidth, the number is right-justified. If nwidth is less than zero the number is left-justified.

For gDisplayIntegerZero(), the number is always right justified and if the number occupies less than nwidth character positions, the string is padded with zeros.

If nwidth equals zero, nothing is displayed. If the number is longer than nwidth characters, the string is filled with asterisks.

The field width is limited to 32 character positions. If it exceeds this, it is set to 32 characters and a warning message is output.

The start point of the string is the current drawing position and will be at the bottom left-hand corner of the first character. The end point is the bottom right-hand corner of the string.

The characters are drawn subject to the font representation, font weight, character size, orientation, justification, italics and underline settings and are transformed if GINO transformable characters are currently selected.

See Also

gDisplayInteger Usage

---