format                 package:utils                 R Documentation

_F_o_r_m_a_t _U_n_o_r_d_e_r_e_d _a_n_d _O_r_d_e_r_e_d _L_i_s_t_s

_D_e_s_c_r_i_p_t_i_o_n:

     Format unordered (itemize) and ordered (enumerate) lists.

_U_s_a_g_e:

     formatUL(x, label = "*", offset = 0,
              width = 0.9 * getOption("width"))
     formatOL(x, type = "arabic", offset = 0, start = 1,
              width = 0.9 * getOption("width"))

_A_r_g_u_m_e_n_t_s:

       x: a character vector of list items.

   label: a character string used for labelling the items.

  offset: a non-negative integer giving the offset (indentation) of the
          list.

   width: a positive integer giving the target column for wrapping
          lines in the output.

    type: a character string specifying the 'type' of the labels in the
          ordered list.  If '"arabic"' (default), arabic numerals are
          used.  For '"Alph"' or '"alph"', single upper or lower case
          letters are employed (in this case, the number of the last
          item must not exceed 26.  Finally, for '"Roman"' or
          '"roman"', the labels are given as upper or lower case roman
          numerals (with the number of the last item maximally 3899).
          'type' can be given as a unique abbreviation of the above, or
          as one of the HTML style tokens '"1"' (arabic), '"A"'/'"a"'
          (alphabetic), or '"I"'/'"i"' (roman), respectively.

   start: a positive integer specifying the starting number of the
          first item in an ordered list.

_V_a_l_u_e:

     A character vector with the formatted entries.

_S_e_e _A_l_s_o:

     'formatDL' for formatting description lists.

_E_x_a_m_p_l_e_s:

     ## A simpler recipe.
     x <- c("Mix dry ingredients thoroughly.",
            "Pour in wet ingredients.",
            "Mix for 10 minutes.",
            "Bake for one hour at 300 degrees.")
     ## Format and output as an unordered list.
     writeLines(formatUL(x))
     ## Format and output as an ordered list.
     writeLines(formatOL(x))
     ## Ordered list using lower case roman numerals.
     writeLines(formatOL(x, type = "i"))
     ## Ordered list using upper case letters and some offset.
     writeLines(formatOL(x, type = "A", offset = 5))

