22.24

java.io.File

THE PACKAGE JAVA.IO

If the path represented by this

File

 object does not correspond to a directory

in the file system, then

null

 is returned. Otherwise, an array of strings is returned,

one for each file in the directory (on UNIX systems, the names  

.

  and  

..

  are

not included). Each string is a file name, not a complete path. There is no guaran 

tee that the strings will appear in any particular order within the array; for exam 

ple, they are not guaranteed to appear in alphabetical order.

22.24.26

public String[] list(FilenameFilter filter)

throws SecurityException

First, if there is a security manager, its

checkRead

 method ( 20.17.19) is called

with the path represented by this

File

 object as its argument.

If the path represented by this

File

 object does not correspond to a directory

in the file system, then

null

 is returned. Otherwise, an array of strings is returned,

one for each file in the directory (on UNIX systems, the names  

.

  and  

..

  are

not included) whose name satisfies the given

filter

. Each string is a file name,

not a complete path. There is no guarantee that the strings will appear in any par 

ticular order within the array; for example, they are not guaranteed to appear in

alphabetical order. A file name satisfies the filter if and only if the value

true

results when the

accept

 method ( 22.25.1) of the filter is called with this

File

object and the name as arguments.

22.24.27

public boolean renameTo(File dest)

throws SecurityException

First, if there is a security manager, its

checkWrite

 method ( 20.17.21) is called

twice, first with the path represented by this

File

 object as its argument and again

with the path of

dest

 as its argument.

An attempt is made to rename the file specified by the path represented by this

File

 object to the name specified by

dest

; the result is

true

 if and only if the

renaming operation succeeds.

22.24.28

public boolean delete() throws SecurityException

First, if there is a security manager, its

checkDelete

 method ( 20.17.22) is called

with the path represented by this

File

 object as its argument.

An attempt is made to delete the file specified by the path represented by this

File

 object; the result is

true

 if and only if the deletion operation succeeds.

758