HP 3000 Manuals

NLCONVCLOCK [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

NLCONVCLOCK 

NM and CM callable.

Converts the time format from a character string to numeric value; checks
the input string using the formatting template returned by itemnum=3 of
the NLINFO intrinsic, then converts the time to the general time format
returned by the CLOCK intrinsic.

Syntax 
_____________________________________________________
|                                                   |
|     I32                 CA     I16V       I16V    |
|     time:=NLCONVCLOCK(buffer,bufferlength,langnum,|
|                          U16A                     |
|                         error);                   |
_____________________________________________________

            

Functional Return 

time                  32-bit signed integer (assigned functional return) 

                      Returns the time in the following format:

                         Bits     Value/Meaning 

                          8:8     Minute of hour

                          0:8     Hour of day

Parameters 

buffer                character array (required) 

                      Passes the formatted time to be converted.

bufferlength          16-bit signed integer by value (required) 

                      Passes the length of buffer (in bytes).

langnum               16-bit signed integer by value (required) 

                      Contains the language ID number, specifying the
                      custom time format for buffer.

error                 16-bit unsigned integer array (required) 

                      Returns two elements:  the first element is the
                      error number; the second element is reserved and
                      always returns 0.  The possible error number values
                      are:

                         Value    Meaning 

                           0      Successful

                           1      *NLS not installed

                           2      *Specified language not configured

                           3      Invalid time string

                           4      Invalid length

                           5      *NLS internal error

                           6      *NLS internal error

                      * Do not apply to calls with a langnum equal to 0
                      (NATIVE3000/XL).

Related Information 

Intrinsics            NLCONVCUSTDATE, NLFMTCALENDAR, NLFMTCLOCK,
                      NLFMTCUSTDATE, NLFMTDATE, NLFMTLONGCAL

Commands              None

Manuals               Native Language Programmer's Guide (32650-90022)



MPE/iX 5.0 Documentation