quiet: Suppress function messages and Concatenate and Print (cat)

Description Usage Arguments References Examples

View source: R/util.R

Description

This function is used to suppress information printed from external functions that make internal use of link{message} and cat, which provide information in interactive R sessions. For simulations, the session is not interactive, and therefore this type of output should be suppressed. For similar behaviour for suppressing warning messages see suppressWarnings, though use this function carefully as some warnings can be meaningful and unexpected.

Usage

1
quiet(..., messages = FALSE, cat = FALSE)

Arguments

...

the functional expression to be evaluated

messages

logical; suppress all messages?

cat

logical; suppress all concatenate and print calls from cat?

References

Chalmers, R. P., & Adkins, M. C. (2020). Writing Effective and Reliable Monte Carlo Simulations with the SimDesign Package. The Quantitative Methods for Psychology, 16(4), 248-280. doi: 10.20982/tqmp.16.4.p248

Sigal, M. J., & Chalmers, R. P. (2016). Play it again: Teaching statistics with Monte Carlo simulation. Journal of Statistics Education, 24(3), 136-156. doi: 10.1080/10691898.2016.1246953

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
myfun <- function(x){
   message('This function is rather chatty')
   cat("It even prints in different output forms!\n")
   message('And even at different....')
   cat("...times!\n")
   x
}

out <- myfun(1)
out

# tell the function to shhhh
out <- quiet(myfun(1))
out

SimDesign documentation built on Sept. 5, 2021, 5:23 p.m.