Initializing help system before first use

# 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:
SYS_NODIR | Do not report directories (only files)
SYS_DIRONLY | Report only directories
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
untar, newtar, ziplist, getsysstat
Module
mmsystem
Parent Topic Procedures and functions

© 2001-2026 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.