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", "("))

_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.

_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.

_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)

