parse                  package:base                  R Documentation

_P_a_r_s_e _E_x_p_r_e_s_s_i_o_n_s

_D_e_s_c_r_i_p_t_i_o_n:

     `parse' returns the parsed but unevaluated expressions in a list. 
     Each element of the list is of mode `expression'.

_U_s_a_g_e:

     parse(file = "", n = NULL, text = NULL, prompt = NULL, white = FALSE)

_A_r_g_u_m_e_n_t_s:

    file: a connection, or a character the name of a file to read the
          expressions from.  Note that the ASCII file must end with a
          newline (`"\n"'). If `file' is `""' and `text' is missing or
          `NULL' then input is taken from the console.

       n: the number of statements to parse.  If `n' is negative the
          file is parsed in its entirety.

    text: character. The text to parse, quoted.

  prompt: the prompt to print when parsing from the keyboard.  The
          default, `NULL', is to use R's prompt,
          `options("prompt")[[1]]'.

   white: if `TRUE' then any white space separates expressions
          otherwise only newlines or semicolons do.

_D_e_t_a_i_l_s:

     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 Mac).  The final line can be incomplete, that is
     missing the final EOL marker.

_S_e_e _A_l_s_o:

     `scan', `source', `eval', `deparse'.

_E_x_a_m_p_l_e_s:

     cat("x <- c(1,4)\n  x ^ 3 -10 ; outer(1:7,5:9)\n", file="xyz.Rdmped")
     # parse 3 statements from the file "xyz.Rdmped"
     parse(file = "xyz.Rdmped", n = 3)
     unlink("xyz.Rdmped")

