FilesAndDirs (Class)

Returns a 1 if the path to be checked is fine, otherwise 0.

• If path exists but is not a directory a 0 is returned.
• If path does not exist a 0 is returned.
• If path does not exist but the left argument is “CREATE!” it will be created, including any sub directories.

The left argument is case insensitive.

Copies source to target.

The left argument must be one of:

• A filename (simple string).
• A vector of text strings, each representing a filename.

In case it is a single filename then the right argument must be either a directory (in which case the filename itself persists) or a filename.

In case the left argument is a vector of filenames the right argument must be either a single directory (all files are copied into that directory, and the filenames as such persist) or a vector of the same length as the left argument.

Note that wildcard characters are not supported.

CopyTo overwrites the target file if there is any.

Examples:

'C:\readme.txt' FilesAndDirs2.CopyTo 'D:\buffer\' 
'C:\readme.txt' FilesAndDirs2.CopyTo 'D:\buffer\newname.txt' 
'C:\file1' 'C:\file2' FilesAndDirs2.CopyTo 'D:\buffer\' 
'C:\file1' 'C:\file2' FilesAndDirs2.CopyTo 'D:\buffer\A' D:\buffer\B 

The method always returns a (shy) two-item vector as result:

1. rc is either 0 for “okay” or an error code.
2. more is an empty text vector in case rc is 0. It might hold additional information in case rc is not 0.

Note that in case source is a nested vector of text vectors than both rc and more are nested as well, and the length will match the length of source.

Same as ⎕NCREATE but filename is normalized: every \ is exchanged by /.

Returns the tie number.

Attempts to delete a file. Returns 1 in case of succes and 0 otherwise for each file in filenames.

This function does not care whether the file exists or not, although naturally sucess will be 0 for any non-existing files.

filenames can be one of:

• Text string representing a single filename.
• Vector of text vectors, each representing a single file.

filenames are normalized, meaning that any \ is replaced by /.

In case filenames is empty a 0 is returned.

List contents of path.

path may be one of:

• A file: Dir returns attributes for just that file
• A directory without a trailing slash: Dir returns attributes for just that directory
• A directory with a trailing slash: Dir returns attributes for all files and directories found in that directory.
• An empty vector: this defaults to PWD,'/'

Note that * and ? are treated as wildcard characters. That means that FilesAndDirs cannot deal with files that contain a * or a ? as part of any name, be it directory or filename; under Linux and Mac OS these are legal characters for filenames.

The result is a vector of the same length as type which defaults to 0: just file- and directory names. You may specify additional attributes via the type parameter either as key/value pairs or via a namespace populated with variables. If you do then the number of attributes specified defines the length of the result. Examples:

('recursive' 1) FilesAndDirs.Dir '' 

parms←⎕ns'' 
parms.recursive←1 
parms.type←3 4 5 1 0 
parms FilesAndDirs.Dir '' 

If path is empty then the current directory is subject of Dir.

Note that the names of parameters are case sensitive.

Use this if you must make sure that path contains \ (Windows ony).

That problem might occur when you must pass a path to, say, a third-party software (7Zip is just an example) that refuses to accept / characters under Windows.

Under non-Windows system this function does not take action ayt all.

Same as ⎕NEXISTS but y is normalized: any \ becomes /. Note that is y is a symbolic link that exists then a 1 will be returned, no matter whether the target the link is pointing to actually does exist or not.

Returns the proper newline character(s) for os or, if os is empty, for the current OS.

Returns the name of an unused temporary filename. If path is empty the default temp path is taken; that's what GetTempPath would return. This means you can overwrite this by specifying a path.

PrefixString, if defined, is a leading string of the filename going to be generated. This is not the same as

'pref',GetTempFileName ''

because specified as left argument it is taken into account when the uniqueness of the created filename is tested.

This function does not use the Windows built-in function since it has proven to be unreliable under W7 (at least).

Returns the path to the temp directory on the current system.

Returns 1 if path is a directory and 0 otherwise, even if path does exist as a file.

Returns 1 if filename is a regular file and a 0 otherwise, even if y does exist as a directory.

y must be either a text vector or a (negative!) tie number of a native file. If it is a number but not a tie number then an error is signalled.

Returns a 1 if y is a symbolic link and a 0 otherwise, even if y does exist. y must be a text vector.

Lists all directories (but nothing else) in path.

path must of course be a directory. Specify (not case sensitive) string “recursive” as left argument to make the function work recursively.

path might contain wildcard characters (* and ?) but only in the last part of the path and only if “recursive” is not specified as left argument.

Returns a vector of text vectors in case anything was found and '' otherwise.

Lists all files (but nothing else) in path.

path must of course be a directory. Specify (not case sensitive) string “recursive” as left argument to make the function work recursively.

path might contain wildcard characters (* and ?) but only in the last part of the path and only if “recursive” is not specified as left argument.

Returns a vector of text vectors in case anything was found and '' otherwise.

Make directory. If the directory already exists no action is taken and a 1 returned.

Any part of path which does not already exist will be created in preparation of creating path itself.

In comparison with ⎕MKDIR there are two differences:

• This method normalizes path, meaning that any \ is changed into /.
• Errors 19 & 22 are trapped. success is 1 in case the directory was created successfully or already existed, otherwise 0.

Moves source to target.

The function returns a return code and a textual message which is empty in case of success.

The left argument must be a either a text vector representing a filename or a vector of text vectors representing a vector of filenames.

The right argument might be a filename or a folder in case the left argument is a single filename. If the left argument is a vector of filenames then the right argument must be either a single directory name or a vector of te same length than the left argument with filenames and/or directory names.

If the right argument specifies a folder the filename part of source is used for the new file.

Notes:

• ildcard characters are not supported.
• If you try to move a non-existing file you get a ¯1 as return code and an appropriate message on more.
• If there is a name clash in target the already existing file will be overwritten.

The function returns a two-item vector. The first item is one of:

• ¯1 for internal errors (invalid argument(s) etc).
• 0 for success.
• OS error codes otherwise

The second item is an empty vector in case of success but may be a text vector with additional information otherwise.

Both items will be vectors themselves in case source is a nested vector.

This function will move file(s) by first copying them over and then attempt to delete the source file. Note however that when the delete operation fails the copied file will be deleted. This is consistent with the behaviour of the Windows MoveFileEx function.

Examples:

'C:\readme.txt' FilesAndDirs.MoveTo 'D:\buffer\' 
'C:\readme.txt' FilesAndDirs.MoveTo 'D:\buffer\newname.txt' 

All \ are converted to /, no matter what operating system this code is running under.
This is in line with what Dyalog's ⎕N functions are doing.

However, sometimes you need to pass a path with '' chars under Windows because otherwise a .NET call or a third-party software (7Zip is an example) refuse to work with / chars. In that case you may use EnforceBackSlash; see there.

Note that by default a relative path remains relative. You can change this by specifying “expand” as the (optional) left argument. In that case path is expanded to an absolute path.

Notes:

• The left argument is not case sensitive.
• Any pair of // or \\ is reduced to a single / or \.

If ⎕WSID is relative (no / or \ char in the path) the function does nothing.

Otherwise the current directory is changed so that it becomes the path part of ⎕WSID.

Returns '' or the old directory in case of a change.

Print Work Directory; same as Cd''.

Removes path.

The method attempts to remove path and, by default, all its contents.

If for some reason you want to make sure that path is only removed when empty you can specify a 1 as left argument. In that case the method will not do anything if path is not empty.

Note that this method may fail for reasons as trivial as somebody looking into path at the moment of execution. However, the method may still be partly sucessful because it might have deleted files in path before it actually fails to remove path itself.

The result is a three-element vector:

1. rc: return code that indicates success (0) or failure (1).
2. en: event number (⎕EN) in case of an error.
3. more: empty text vector in case rc is 0.

Note that wildcard characters (* and ?) are not allowed as part of path. If such characters are specified anyway then an error is signalled.

• 1.1.1
• Documentation fixed (ADOC).
• 1.1.0
• ListDirs and ListFiles allow wildcard characters now.
• DeleteFiles crashed on empty vectors.
• Methods IsFile, IsDir and IsSymbolicLink except nested arguments now.
• 1.0.0 - First version