[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.