rcat

0th

Percentile

Evaluates an RSP string and outputs the generated string

Evaluates an RSP string and outputs the generated string.

Keywords
file, print, IO
Usage
## S3 method for class 'default':
rcat(..., file=NULL, path=NULL, envir=parent.frame(), args="*", output="", append=FALSE,
  verbose=FALSE)
Arguments
...
A character string with RSP markup.
file, path
Alternatively, a file, a URL or a connection from with the strings are read. If a file, the path is prepended to the file, iff given.
envir
The environment in which the RSP string is preprocessed and evaluated.
args
A named list of arguments assigned to the environment in which the RSP string is parsed and evaluated. See cmdArgs.
output
A connection, or a pathname where to direct the output. If "", the output is sent to the standard output.
append
Only applied if output specifies a pathname; If TRUE, then the output is appended to the file, otherwise the files content is overwritten.
verbose
See Verbose.
Value

Processing RSP strings from the command line

Using Rscript and rcat(), it is possible to process an RSP string and output the result from the command line. For example,

Rscript -e "R.rsp::rcat('A random integer in [1,<%=k%>]: <%=sample(1:k, size="1)%">')" --args --K=50

parses and evaluates the RSP string and outputs the result to standard output.

See Also

To store the output in a string (instead of displaying it), see rstring(). For evaluating and postprocessing an RSP document and writing the output to a file, see rfile().

Aliases
  • rcat.default
  • rcat
  • rcat.RspString
  • rcat.RspDocument
  • rcat.RspRSourceCode
  • rcat.function
Examples
rcat("A random integer in [1,100]: <%=sample(1:100, size=1)%>
")

# Passing arguments
rcat("A random integer in [1,<%=K%>]: <%=sample(1:K, size=1)%>
", args=list(K=50))
Documentation reproduced from package R.rsp, version 0.9.17, License: LGPL (>= 2.1)

Community examples

Looks like there are no examples yet.