system.time

0th

Percentile

CPU Time Used

Return CPU (and other) times that expr used.

Keywords
utilities
Usage
system.time(expr, gcFirst = TRUE)
Arguments
expr

Valid R expression to be timed.

gcFirst

Logical - should a garbage collection be performed immediately before the timing? Default is TRUE.

Details

system.time calls the function proc.time, evaluates expr, and then calls proc.time once more, returning the difference between the two proc.time calls.

unix.time has been an alias of system.time, for compatibility with S, and has finally been deprecated in 2016.

Timings of evaluations of the same expression can vary considerably depending on whether the evaluation triggers a garbage collection. When gcFirst is TRUE a garbage collection (gc) will be performed immediately before the evaluation of expr. This will usually produce more consistent timings.

Value

A object of class "proc_time": see proc.time for details.

See Also

proc.time, time which is for time series.

Sys.time to get the current date & time.

Aliases
  • system.time
  • unix.time
Examples
library(base) # NOT RUN { require(stats) # } # NOT RUN { system.time(for(i in 1:100) mad(runif(1000))) # } # NOT RUN { exT <- function(n = 10000) { # Purpose: Test if system.time works ok; n: loop size system.time(for(i in 1:n) x <- mean(rt(1000, df = 4))) } #-- Try to interrupt one of the following (using Ctrl-C / Escape): exT() #- about 4 secs on a 2.5GHz Xeon system.time(exT()) #~ +/- same # }
Documentation reproduced from package base, version 3.5.0, License: Part of R 3.5.0

Community examples

Looks like there are no examples yet.