cat                   package:base                   R Documentation

_C_o_n_c_a_t_e_n_a_t_e _a_n_d _P_r_i_n_t

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

     Prints the arguments, coercing them if necessary to character mode
     first.

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

     cat(... , file = "", sep = " ", fill = FALSE, labels = NULL,
         append = FALSE)

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

     ...: R objects which are coerced to character strings,
          concatenated, and printed, with the remaining arguments
          controlling the output.

    file: character string naming the file to print to.  If `""' (the
          default), `cat' prints to the standard output. If it is
          `"|cmd"', the output is piped to the command given by `cmd'. 

     sep: character string to insert between the objects to print.

    fill: a logical or numeric controlling how the output is broken
          into successive lines.  If `FALSE', only newlines created
          explicitly by `\n' are printed.  Otherwise, the output is
          broken into lines with print width equal to the option
          `width' if `fill' is `TRUE', or the value of `fill' if this
          is numeric.

  labels: character vector of labels for the lines printed. Ignored if
          `fill' is `FALSE'.

  append: if `TRUE', output will be appended to `file'; otherwise, it
          will overwrite the contents of `file'.

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

     `cat' converts its arguments to character strings, concatenates
     them, separating them by the given `sep=' string, and then prints
     them.

     No linefeeds are printed unless explicitly requested by `"\n"' or
     if generated by filling (if argument `fill' is `TRUE' or numeric.)

     `cat' is useful for producing output in user defined functions.

_V_a_l_u_e:

     None (invisible `NULL').

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

     `print', `format'

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

     ## print an informative message
     cat("iteration = ", iter <- iter + 1, "\n")

