tarlist
tarlist |
Purpose
Get the list of files included in a Unix tar archive.
Synopsis
procedure tarlist(opt:integer,tarfile:text,lsf:list of text, filters:string)
procedure tarlist(tarfile:text,lsf:list of text)
Arguments
|
opt
|
Options:
|
||||
|
tarfile
|
File name of the archive
|
||||
|
lsf
|
Resulting list of file names
|
||||
|
filters
|
File name filters (default: all files reported)
|
Example
The following prints the list of files included in the archive
myfiles.tar:
tarlist("myfiles.tar",lsf)
writeln(lsf)
Further information
1. The
filters argument has a similar structure as the corresponding argument of procedure
findfiles except that wildcard characters
"*" and
"?" may appear anywhere in a path. A file is reported if it matches any of the patterns of this list.
2. When evaluating the filters, file name matching is achieved using function
pathmatch and differences may be observed depending on the operating system (
e.g. file names are case sensitive under Posix systems but not under Windows).
3. This implementation processes only regular files and directories: other file types included in the archive (like links) are silently ignored.
4. By default file names are expected to be represented according the current system encoding in the archive. To select a different encoding use the
enc: file name prefix (see Section
Character encoding of text files) on the archive name (
e.g.
"enc:utf-8,myarc.tar").
Related topics
Module