parse returns the parsed but unevaluated expressions in a list.
parse(file = "", n = NULL, text = NULL, prompt = "?", srcfile, encoding = "unknown")
- a connection, or a character string giving the name of a file or a URL to read the expressions from. If
textis missing or
NULLthen input is taken from the console.
- integer (or coerced to integer). The maximum number of expressions to parse. If
NULLor negative or
NAthe input is parsed in its entirety.
- character vector. The text to parse. Elements are treated as if they were lines of a file. Other R objects will be coerced to character if possible.
- the prompt to print when parsing from the keyboard.
NULLmeans to use R's prompt,
NULL, or a
srcfileobject. See the ‘Details’ section.
- encoding to be assumed for input strings. If the value is
"UTF-8"it is used to mark character strings as known to be in Latin-1 or UTF-8: it is not used to re-encode the input. To do the latter, specify the encoding as part of the connection
options(encoding=): see the example under
text has length greater than zero (after coercion) it is used in preference to
file. All versions of R accept input from a connection with end of line marked by LF (as used on Unix), CRLF (as used on DOS/Windows) or CR (as used on classic Mac OS). The final line can be incomplete, that is missing the final EOL marker.
source for the limits on the size of functions that can be parsed (by default).
When input is taken from the console,
n = NULL is equivalent to
n = 1, and
n < 0 will read until an EOF character is read. (The EOF character is Ctrl-Z for the Windows front-ends.) The line-length limit is 4095 bytes when reading from the console (which may impose a lower limit: see ‘An Introduction to R’).
The default for
srcfile is set as follows. If
srcfile defaults to
NULL. Otherwise, if
text is used,
srcfile will be set to a
srcfilecopy containing the text. If a character string is used for
srcfile object referring to that file will be used.
An object of type
"expression", with up to
n elements if specified as a non-negative integer.
srcfile is non-
"srcref" attribute will be attached to the result containing a list of
srcref records corresponding to each element, a
"srcfile" attribute will be attached containing a copy of
srcfile, and a
"wholeSrcref" attribute will be attached containing a
srcref record corresponding to all of the parsed text. A syntax error (including an incomplete expression) will throw an error.
Character strings in the result will have a declared encoding if
"UTF-8", or if
text is supplied with every element of known encoding in a Latin-1 or UTF-8 locale.
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.
Documentation reproduced from R 2.15.3. License: GPL-2.