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

Returns the names of all selected entires (files + dirs) 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 selentries
        > "ENV" "T" "abc" "Disk.info" 
        + lister query 121132636 selentries ,
        > "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 selected
entries in the lister. In previous versions of Opus 5, however, this was
not the case. 


lister query <handle> selentries var <varname>

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

For example,
        + lister query 121132636 selentries var sentryz
would return
        sentryz        = '"ENV" "T" "abc" "Disk.info"'


lister query <handle> selentries stem <stemname>

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

For example,
        + lister query 121132636 selentries stem stsentryz
would return
        stsentryz.count        = 4
        stsentryz.0            = ENV
        stsentryz.1            = T
        stsentryz.2            = abc
        stsentryz.3            = Disk.info

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


See also:

 lister query entry 
 lister query entries 
 lister query firstsel 
 lister query numentries 
 lister query numselentries 
 lister query seldirs 
 lister query selfiles 
 lister select 


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