[Contents]
[Index]
[Help]
[Browse <]
[Browse >]
lister query <handle> entry <name>
Returns information about the specified entry.
name is the actual name of the entry to return information about. You can
supply #xxx for the name (where xxx is a number), to specify the cardinal
number of the desired entry.
Note that you do not include the path in the name.
The information returned is in the format
<name> <size> <type> <selection> <seconds> <protect> <comment>
where name is the full name of the entry (no path),
size is the size of the entry (bytes),
type is the type of the entry (<0 means a file,
>0 means a directory),
selection indicates the selection status of the entry
(1 if the entry is selected, 0 if it is not selected),
seconds is the datestamp of the entry in seconds from 1/1/78,
protect is the protection bits of the file
(in ASCII format, eg "h---rwed"),
comment is the comment of the entry (if any).
The ARexx calender/date functions provide routines perfect for converting
various time formats to the datestamp entry and back again.
For example,
+ lister query 121132636 entry ENV
> ENV -1 2 0 543401724 ----rwed
lister query <handle> entry <name> var <varname>
This is exactly the same as lister query entry , except that the result
is stored in the variable called varname instead of RESULT .
For example,
+ lister query 121132636 entry "disk.info" var myvar
would return
myvar = "Disk.info 828 -1 0 590488349 ----rw-d"
lister query <handle> entry <name> stem <stemname>
This is exactly the same as lister query entry , except that the result
is stored in a stem variable whose base-name is stemname .
The specified stem variable will have several fields, each containing
information about the entry in question. These fields are as follows:-
name - entry name (no path)
size - file size (bytes)
type - type (<0 = file, >0 = dir)
selected - 0 (selected) or 1 (not selected)
date - seconds since 1/1/78
protect - protection bits (long value)
datestring - datestamp in ASCII form
protstring - protection bits in ASCII form, eg "----rwed"
comment - file comment (if any)
filetype - file type (if any)
version - version number
revision - revision number
verdate - version date in numerical dd.mm.yy format
datenum - file date in numerical dd.mm.yy format
time - file time in hh:mm:ss 24 hour format
userdata - userdata value (see lister addstem )
display - display line (if any) (see lister addstem )
For example,
> lister query 121132636 entry "Disk.info" stem fileinfo.
would return,
fileinfo.name = "Disk.info"
fileinfo.size = 828
fileinfo.type = -1
fileinfo.selected = 0
fileinfo.date = 590488349
fileinfo.protect = 2
fileinfo.datestring = "17-Sep-96 08:32:29"
fileinfo.protstring = "----rw-d"
fileinfo.comment = "" (There comment is empty)
fileinfo.filetype = "" (Filetypes not shown in the lister)
fileinfo.version = "" (Versions not shown in the lister,
fileinfo.revision = "" and the file has no version string
fileinfo.verdate = "" inside it anyway).
fileinfo.datenum = "17-09-96"
fileinfo.time = "08:32:29"
fileinfo.userdata = 0 (This is the default userdata value)
fileinfo.display = ""
See also:
lister add
lister addstem
lister query dirs
lister query entries
lister query files
lister query firstsel
lister query numdirs
lister query numentries
lister query numfiles
lister query numseldirs
lister query numselentries
lister query numselfiles
lister query seldirs
lister query selentries
lister query selfiles
lister select
Converted on 04 Nov 1998 with RexxDoesAmigaGuide2HTML 2.2 by Michael Ranner.