|
|
1 NAME
2 get_dir - get information about files in a directory
3
4 SYNOPSIS
5 mixed **get_dir(string file)
6
7
8 DESCRIPTION
9 Get information about a file or files in a directory. The return
10 value is of the form
11
12 ({ ({ file names }), ({ file sizes }), ({ file mod times }) })
13
14 If a file is a directory, the file size will be given as -2.
15 If the last path component of the specified file can be interpreted
16 as a regular expression, all files which match this regular expression
17 are collected. Otherwise, only the file itself is taken. If no files
18 match, or if the file is not present, the return value of get_dir()
19 will be ({ ({ }), ({ }), ({ }) }).
20 The following characters have a special meaning in a regular expression:
21
22 ? any single character
23 * any (possibly empty) string
24 [a-z] any character in the range a-z
25 [^a-z] any character not in range a-z
26 \c the character c, not interpreted as having a special
27 meaning
28
29 The files will be sorted by file name.
30 Only as many files as specified by status()[ST_ARRAYSIZE], with
31 ST_ARRAYSIZE defined in the include file <status.h>, will be collected.
32
33 SEE ALSO
34 kfun/make_dir, kfun/remove_dir
This page was automatically generated by the
LXR engine.
Visit the LXR main site for more
information.