[Contents] [Index] [Help] [Browse <] [Browse >]
lister query <handle> entries [<separator>]

Returns the names of all entries (that is, both files and directories) in
the lister ( handle ), surrounded by quotes. If you specify a  separator 
character it will be placed between the quotes, otherwise space is used.

For example, (The quotes are included in the strings)
        + lister query 121132636 entries
        > "Clipboards" "ENV" "T" "abc" "Disk.info" 
        + lister query 121132636 entries ,
        > "Clipboards","ENV","T","abc","Disk.info" 

You should not rely on the ARexx Word() function to traverse the list
because it does not support quotes and any entry with a space in its name
will cause your script to malfunction. Use a stem variable instead (see
below). 

Note that the empty string will be returned if there are no entries in
the lister. In previous versions of Opus 5, however, this was not the case. 


lister query <handle> entries var <varname>

This is exactly the same as  lister query entries , except that the result
is stored in the variable called  varname  instead of  RESULT .

For example,
        + lister query 121132636 entries var ents
would return
        ents   = '"Clipboards" "ENV" "T" "abc" "Disk.info"'


lister query <handle> entries stem <stemname>

This is exactly the same as  lister query entries , except that the result
is stored in a stem variable whose base-name is  stemname .

For example,
        + lister query 121132636 entries stem ents
would return
        ents.count     = 5
        ents.0         = Clipboards
        ents.1         = ENV
        ents.2         = T
        ents.3         = abc
        ents.4         = Disk.info

Note that the stem count will correctly return 0 if there are no
entries.

See also:

 lister query entry 
 lister query dirs 
 lister query files 
 lister query numentries 
 lister query numselentries 
 lister query selentries 


Converted on 04 Nov 1998 with RexxDoesAmigaGuide2HTML 2.2 by Michael Ranner.