list.files               package:base               R Documentation

_L_i_s_t _t_h_e _F_i_l_e_s _i_n _a _D_i_r_e_c_t_o_r_y/_F_o_l_d_e_r

_D_e_s_c_r_i_p_t_i_o_n:

     This function produces a list containing the names of files in the
     named directory. 'dir' is an alias.

_U_s_a_g_e:

     list.files(path = ".", pattern = NULL, all.files = FALSE,
                full.names = FALSE, recursive = FALSE)
            dir(path = ".", pattern = NULL, all.files = FALSE,
                full.names = FALSE, recursive = FALSE)

_A_r_g_u_m_e_n_t_s:

    path: a character vector of full path names; the default
          corresponds to the working directory 'getwd()'.

 pattern: an optional regular expression.  Only file names which match
          the regular expression will be returned.

all.files: a logical value. If 'FALSE', only the names of visible files
          are returned.  If 'TRUE', all file names will be returned.

full.names: a logical value.  If 'TRUE', the directory path is
          prepended to the file names.  If 'FALSE', only the file names
          are returned.

recursive: logical. Should the listing recurse into directories?

_V_a_l_u_e:

     A character vector containing the names of the files in the
     specified directories, or '""' if there were no files. If a path
     does not exist or is not a directory or is unreadable it is
     skipped, with a warning.

     The files are sorted in alphabetical order, on the full path if
     'full.names = TRUE'.

_N_o_t_e:

     File naming conventions are very platform dependent.

     'recursive = TRUE' is not supported on all platforms, and may be
     ignored, with a warning.

_A_u_t_h_o_r(_s):

     Ross Ihaka, Brian Ripley

_S_e_e _A_l_s_o:

     'file.info', 'file.access' and 'files' for many more file handling
     functions and  'file.choose'  for interactive selection.

_E_x_a_m_p_l_e_s:

     list.files(R.home())
     ## Only files starting with a-l or r (*including* uppercase):
     dir("../..", pattern = "^[a-lr]",full.names=TRUE)

