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

Returns the names of all 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 files
        > "abc" "Disk.info" 
        + lister query 121132636 files ,
        > "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 files in
the lister. In previous versions of Opus 5, however, this was not the case. 


lister query <handle> files var <varname>

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

For example,
        + lister query 121132636 files var fillies
would return
        fillies        = '"abc" "Disk.info"'


lister query <handle> files stem <stemname>

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

For example,
        + lister query 121132636 files stem fyels
would return
        fyels.count    = 2
        fyels.0        = abc
        fyels.1        = 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 entries 
 lister query firstsel 
 lister query numfiles 
 lister query numselfiles 
 lister query selfiles 


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