TIME - get time in pulses, or convert it to a string.

Alternate Entry Name: .BTIME

Usage:

B:
   inttime = time();
   string = time( string [, pulses] );

C:
   #equate _btime .btime
   int _btime(void);
   char *_btime(char *string [, int pulses] );

Where:

inttime

is an integer containing the time of day in GCOS III clock pulses. A clock pulse is 1/64th of a millisecond.

string

points to a vector which is at least three words long.

pulses

is an integer representing a time of day in clock pulses.

Description:

When TIME is called without arguments, it simply returns the time of day in GCOS III clock pulses. For programs that need the time expressed in GCOS8 pulses, see "expl b lib t.3to8".

If TIME is supplied with a single argument, it converts the current time of day into the format

hh:mm:ss

and stores this as an ASCII string in the three words of memory indicated by "string".

Finally, if TIME is called with two arguments, "pulses" is taken as a time of day in clock pulses, converted into ASCII string format, and placed in the three words of memory indicated by "string".

Whenever TIME is called with one or two arguments, the first argument is returned.

See Also:

expl b lib t.3to8

expl b lib tick

Copyright © 1996, Thinkage Ltd.