

cat {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.

     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'; oth-
          erwise, it will overwrite the contents of `file'.

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

     `cat' converts its arguments to character strings, con-
     catenates 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")

