parse_text: Parse expressions residing in character vectors

In gbutils: Utilities for Simulation, Plots, Quantile Functions and Programming

Parse expressions residing in character vectors

Description

Parse expressions residing in character vectors. Similar to parse() but keeping or not the source is controlled by an argument rather than global options.

Usage

parse_text(text, ..., keep = TRUE)

Arguments

text	the text to parse, normally a character vector but can be anything that parse accepts for this artgument.
...	additional arguments to be passed on to parse.
keep	required setting for option keep.source, see details.

Details

This is like parse(text=text,...), except that whether or not the source is kept is controlled by argument keep, not by options("keep.source").

parse_text sets options("keep.source") to keep (if they are different) before calling parse and restores it afterwards.

Value

an expression representing the parsed text, see parse for details

Note

The usual setting of option "keep.source" in interactive sessions is TRUE. However, in ‘R CMD check’ it is FALSE.

As a consequence, if the documentation of a package uses functions that depend on option "keep.source" being TRUE, then some examples may run fine when copied and pasted in an R session but (rightly) fail ‘R CMD check’.

The oposite may also happen, in that the documentation passes 'R CMD check' or Sweave files successfully build but some examples do not work when copied and pasted in an interactive session.

Author(s)

Georgi N. Boshnakov

See Also

parse

gbutils documentation built on May 28, 2022, 1:13 a.m.