deparse                 package:base                 R Documentation

_E_x_p_r_e_s_s_i_o_n _D_e_p_a_r_s_i_n_g

_D_e_s_c_r_i_p_t_i_o_n:

     Turn unevaluated expressions into character strings.

_U_s_a_g_e:

     deparse(expr, width.cutoff = 60,
             backtick = mode(expr) %in% c("call", "expression", "("),
             control = "showAttributes")

_A_r_g_u_m_e_n_t_s:

    expr: any R expression.

width.cutoff: integer in [20, 500] determining the cutoff at which
          line-breaking is tried.

backtick: logical indicating whether symbolic names should be enclosed
          in backticks if they don't follow the standard syntax.

 control: character vector of deparsing options.  See '.deparseOpts'.

_D_e_t_a_i_l_s:

     This function turns unevaluated expressions (where "expression" is
     taken in a wider sense than the strict concept of a vector of mode
     '"expression"' used in 'expression') into character strings (a
     kind of inverse 'parse').

     A typical use of this is to create informative labels for data
     sets and plots.  The example shows a simple use of this facility. 
     It uses the functions 'deparse' and 'substitute' to create labels
     for a plot which are character string versions of the actual
     arguments to the function 'myplot'.

     The default for the 'backtick' option is not to quote single
     symbols but only composite expressions. This is a compromise to
     avoid breaking existing code.

     Using 'control = "all"' comes closest to making 'deparse()' an
     inverse of 'parse()'.  However, not all objects are deparseable
     even with this option and a warning will be issued if the function
     recognizes that it is being asked to do the impossible.

_N_o_t_e:

     To avoid the risk of a source attribute out of sync with the
     actual function definition, the source attribute of a function
     will never  be deparsed as an attribute.

_R_e_f_e_r_e_n_c_e_s:

     Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) _The New S
     Language_. Wadsworth & Brooks/Cole.

_S_e_e _A_l_s_o:

     'substitute', 'parse', 'expression'.

_E_x_a_m_p_l_e_s:

     require(stats)
     deparse(args(lm))
     deparse(args(lm), width = 500)
     myplot <-
     function(x, y) {
         plot(x, y, xlab=deparse(substitute(x)),
             ylab=deparse(substitute(y)))
     }
     e <- quote(`foo bar`)
     deparse(e)
     deparse(e, backtick=TRUE)
     e <- quote(`foo bar`+1)
     deparse(e)
     deparse(e, control = "all")

