FileNames

FileNames[]
lists all files in the current working directory.

FileNames[form]
lists all files in the current working directory whose names match the string pattern form.

FileNames[{form1,form2,}]
lists all files whose names match any of the formi.

FileNames[forms,{dir1,dir2,}]
lists files with names matching forms in any of the directories diri.

FileNames[forms,dirs,n]
includes files that are in subdirectories up to n levels down.

Details and OptionsDetails and Options

  • File names can be given as literal strings, StringExpression string patterns, RegularExpression objects, or abbreviated string patterns.
  • In abbreviated string patterns, * stands for any sequence of zero or more characters. @ stands for any sequence of one or more characters other than uppercase letters.
  • FileNames["*"] or FileNames[__] is equivalent to FileNames[].
  • All can also be used in place of "*".
  • In abbreviated string patterns, Verbatim["s"] specifies that the string "s" should be matched with * and @ treated literally.
  • FileNames[forms,dirs,Infinity] looks for files in all subdirectories of the dirs.
  • The list of files returned by FileNames is sorted in the order generated by the function Sort.
  • FileNames[forms,dirs,{n}] includes names of directories only if they appear exactly at level n.
  • The forms can include relative or absolute directory specifications, in addition to names of files.
  • Setting the option IgnoreCase->True makes FileNames treat lowercase and uppercase letters in file names as equivalent.
  • With the default setting IgnoreCase->Automatic, FileNames treats lowercase and uppercase letters in file names as equivalent under Microsoft Windows operating systems, but not elsewhere.
  • File["dir"] may be used to specify a literal directory name to search.

ExamplesExamplesopen allclose all

Basic Examples  (1)Basic Examples  (1)

List the file and directory names in the $InstallationDirectory:

In[1]:=
Click for copyable input
In[2]:=
Click for copyable input
Out[2]=

Count the files in the whole installation directory:

In[3]:=
Click for copyable input
Out[3]=
Introduced in 1991
(2.0)
| Updated in 2007
(6.0)
Translate this page: