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