====== Function GET-INTERNAL-RUN-TIME ====== ====Syntax==== * **get-internal-run-time** → //internal-time// ====Arguments and Values==== * //internal-time// - a non-negative //[[CL:Glossary:integer]]//. ====Description==== Returns as an //[[CL:Glossary:integer]]// the current run time in //[[CL:Glossary:internal time units]]//. The precise meaning of this quantity is //[[CL:Glossary:implementation-defined]]//; it may measure real time, run time, CPU cycles, or some other quantity. The intent is that the difference between the values of two calls to this function be the amount of time between the two calls during which computational effort was expended on behalf of the executing program. ====Examples==== None. ====Side Effects==== None. ====Affected By==== The //[[CL:Glossary:implementation]]//, the time of day (i.e. the passage of time). ====Exceptional Situations==== None. ====See Also==== **[[CL:Constant Variables:internal-time-units-per-second|Function INTERNAL-TIME-UNITS-PER-SECOND]]** ====Notes==== Depending on the //[[CL:Glossary:implementation]]//, paging time and garbage collection time might be included in this measurement. Also, in a multitasking environment, it might not be possible to show the time for just the running process, so in some //[[CL:Glossary:implementations]]//, time taken by other processes during the same time interval might be included in this measurement as well.