Resume writing to a log

Source: R/logr.R

A function to reopen and resume writing to a log file that has been suspended.

log_resume(file_name = NULL)

Arguments

file_name

The name of the log file to resume. If the file_name parameter is not supplied, the function will look in the current session for the original name and path of the log. If that name and path is not found, an error will be generated.

Value

The path of the log.

See also

log_suspend for suspending the log, and log_close to close the log.

Examples

library(logr)

# Create temp file location
tmp <- file.path(tempdir(), "test.log")

# Open log
lf <- log_open(tmp)

# Send message to log
log_print("Before suspend")
#> Before suspend 

# Suspend log
log_suspend()
#> Log suspended

# View suspended log
writeLines(readLines(lf))
#> =========================================================================
#> Log Path: C:/Users/dbosa/AppData/Local/Temp/RtmpsjFzDn/log/test.log
#> Working Directory: C:/packages/logr/docs/reference
#> User Name: dbosa
#> R Version: 4.6.1 (2026-06-24 ucrt)
#> Machine: SOCRATES x86-64
#> Operating System: Windows 10 x64 build 26200
#> Base Packages: stats graphics grDevices utils datasets methods base
#> Other Packages: logr_1.4.0 common_1.1.5
#> Log Start Time: 2026-10-15 21:26:39.683593
#> =========================================================================
#> 
#> Before suspend
#> 
#> NOTE: Log Print Time:  2026-10-15 21:26:39.687289
#> NOTE: Elapsed Time: 0.00177001953125 secs
#> 
#> =========================================================================
#> Log suspended
#> =========================================================================
#> 
#> Autolog: FALSE
#> Log Path: C:/Users/dbosa/AppData/Local/Temp/RtmpsjFzDn/log/test.log
#> Msg Path: C:/Users/dbosa/AppData/Local/Temp/RtmpsjFzDn/log/test.msg
#> Show Notes: TRUE
#> Blank After: TRUE
#> Traceback: TRUE
#> Status: open
#> Tidylog:
#> Log Time: 2026-10-15 21:26:39.687289
#> Start Time: 2026-10-15 21:26:39.685519
#> Suspend Time: 2026-10-15 21:26:39.6999
#> Elapsed Time: 0.012610912322998
#> 

# Resume log
log_resume(lf)
#> [1] "C:/Users/dbosa/AppData/Local/Temp/RtmpsjFzDn/log/test.log"

# Print data to log
log_print("After suspend")
#> After suspend 

# Close log
log_close()

# View results
writeLines(readLines(lf))
#> =========================================================================
#> Log Path: C:/Users/dbosa/AppData/Local/Temp/RtmpsjFzDn/log/test.log
#> Working Directory: C:/packages/logr/docs/reference
#> User Name: dbosa
#> R Version: 4.6.1 (2026-06-24 ucrt)
#> Machine: SOCRATES x86-64
#> Operating System: Windows 10 x64 build 26200
#> Base Packages: stats graphics grDevices utils datasets methods base
#> Other Packages: logr_1.4.0 common_1.1.5
#> Log Start Time: 2026-10-15 21:26:39.683593
#> =========================================================================
#> 
#> Before suspend
#> 
#> NOTE: Log Print Time:  2026-10-15 21:26:39.687289
#> NOTE: Elapsed Time: 0.00177001953125 secs
#> 
#> =========================================================================
#> Log Suspended: 2026-10-15 21:26:39.6999
#> Log Resumed: 2026-10-15 21:26:39.717577
#> Elapsed Time: 0 00:00:00
#> =========================================================================
#> 
#> After suspend
#> 
#> NOTE: Log Print Time:  2026-10-15 21:26:39.724566
#> NOTE: Elapsed Time: 0.00173807144165039 secs
#> 
#> =========================================================================
#> Log End Time: 2026-10-15 21:26:39.726687
#> Log Elapsed Time: 0 00:00:00
#> =========================================================================