fileinfo#

Purpose#

Returns names and information for files that match a specification.

Format#

{ fnames, finfo } = fileinfo(fspec)#

Parameters:

fspec (string) – file specification. Can include path and wildcards.

Returns:

fnames (Nx1 string array) – all file names that match, null string if none are found.

finfo (Nx13 matrix) –

information about matching files.

Linux

\([N, 1]\)	filesystem ID
\([N, 2]\)	inode number
\([N, 3]\)	mode bit mask
\([N, 4]\)	number of links
\([N, 5]\)	user ID
\([N, 6]\)	group ID
\([N, 7]\)	device ID (char/block special files only)
\([N, 8]\)	size in bytes
\([N, 9]\)	last access time
\([N,10]\)	last data modification time
\([N,11]\)	last file status change time
\([N,12]\)	preferred I/O block size
\([N,13]\)	number of 512-byte blocks allocated

Windows

\([N, 1]\)	drive number (A = 0, B = 1, etc.)
\([N, 2]\)	n/a, 0
\([N, 3]\)	mode bit mask
\([N, 4]\)	number of links, always 1
\([N, 5]\)	n/a, 0
\([N, 6]\)	n/a, 0
\([N, 7]\)	n/a, 0
\([N, 8]\)	size in bytes
\([N, 9]\)	last access time
\([N,10]\)	last data modification time
\([N,11]\)	creation time
\([N,12]\)	n/a, 0
\([N,13]\)	n/a, 0

finfo will be a scalar zero if no matches are found.

Examples#

{ fnames, finfo} = fileinfo("fourier_*");

// Print results
print "File names"; fnames;
print "File information"; finfo;

This prints results about all files starting with fourier_ in the current working directory:

File names

fourier_adf.e
fourier_adf_rev.e
fourier_adf_turkish.e

File information

2.00   0.00 33206.00   1.00   0.00   0.00   0.00 1270.00 1559719168.00 1559719168.00 1559718437.00   0.00   0.00
2.00   0.00 33206.00   1.00   0.00   0.00   0.00 1270.00 1559719236.00 1559719236.00 1559719236.00   0.00   0.00
2.00   0.00 33206.00   1.00   0.00   0.00   0.00 1277.00 1562820073.00 1562820073.00 1562820032.00   0.00   0.00

Remarks#

fnames will contain file names only; any path information that was passed is dropped.

The time stamp fields (finfo[N, 9:11]) are expressed as the number of seconds since midnight, Jan. 1, 1970, Coordinated Universal Time (UTC).