[Contents]
[Index]
[Help]
[Browse <]
[Browse >]
lister query <handle> selfiles [<separator>]
Returns the names of all selected files 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 selfiles
> "abc" "Disk.info"
+ lister query 121132636 selfiles ,
> "abc","Disk.info"
You should not rely on the ARexx Word() function to traverse the list
because it does not support quotes and any file 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
files in the lister. In previous versions of Opus 5, however, this was not
the case.
lister query <handle> selfiles var <varname>
This is exactly the same as lister query selfiles , except that the result
is stored in the variable called varname instead of RESULT .
For example,
+ lister query 121132636 selfiles var sellyfilles
would return
sellyfilles = '"abc" "Disk.info"'
lister query <handle> selfiles stem <stemname>
This is exactly the same as lister query selfiles , except that the result
is stored in a stem variable whose base-name is stemname .
For example,
+ lister query 121132636 selfiles stem sellyfilles
would return
sellyfilles.count = 2
sellyfilles.0 = abc
sellyfilles.1 = Disk.info
Note that the stem count will correctly return 0 if there are no
selected files.
See also:
lister query files
lister query firstsel
lister query numfiles
lister query numselfiles
lister query seldirs
lister query selentries
lister select
Converted on 04 Nov 1998 with RexxDoesAmigaGuide2HTML 2.2 by Michael Ranner.