SGI Techpubs Library

IRIX 6.5  »  Man Pages
find in page

RTC(3I)

 NAME

     _rtc, RTC, IRTC, IRTC_RATE - Returns clock register contents

 SYNOPSIS

     C/C++:

     long long _rtc (void);

     Fortran:

     RTC ()
     IRTC ()

     MIPSpro Fortran 77:

     IRTC_RATE()

 STANDARDS

     C/C++ extension

     Fortran extension

 DESCRIPTION

     The _rtc, RTC, and IRTC intrinsic functions return a real-time clock
     value.  The value is expressed as the number of clock ticks.  The
     IRTC_RATE function returns the clock rate of the IRTC and RTC
     functions.

 NOTES

   C/C++
     Because _rtc is an intrinsic function, no externally visible library
     function is available for it.  The compiler generates inline code to
     produce the result.

   Fortran
     The names of these intrinsics cannot be passed as arguments.

     When RTC is called as a subroutine, it accepts the following argument:

     time   The real-time clock value is returned as a REAL(KIND=8) value.

     When IRTC is called as a subroutine, it accepts the following
     argument:

     itime  The real-time clock value is returned as an INTEGER(KIND=8)
            value.

     The RTC intrinsic function is outmoded.  For information on outmoded
     features and their preferred standard alternatives, see the MIPSpro
     Fortran Language Reference Manual, Volume 3.

     The use of RTC is not recommended.  See the standard SYSTEM_CLOCK(3I)
     intrinsic subroutine for the preferred alternative.

 FORTRAN RETURN VALUES

     RTC returns a 64-bit real value.  IRTC returns a 64-bit integer value.

     On IRIX systems, RTC returns the low-order 52 bits of the system clock
     expressed as a REAL(KIND=8) value.  IRTC returns the system clock as
     an INTEGER(KIND=8) value.  IRTC_RATE returns the number of IRTC and
     RTC clock ticks per second in an INTEGER(KIND=8) value.  IRTC is the
     fastest nonwrapping clock.

 SEE ALSO

     f90(1), SECOND(3F), SYSCLOCK(3F), SYSTEM_CLOCK(3I), TSECND(3F)




home/search | what's new | help