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

Returns the names of all 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 dirs
        > "Clipboards" "ENV" "T" 
        + lister query 121132636 dirs ,
        > "Clipboards","ENV","T" 

You should not rely on the ARexx Word() function to traverse the list
because it does not support quotes and any directory 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 directories in
the lister. In previous versions of Opus 5, however, this was not the case. 


lister query <handle> dirs var <varname>

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

For example,
        + lister query 121132636 dirs var dirs
would return
        dirs   = '"Clipboards" "ENV" "T"'


lister query <handle> dirs stem <stemname>

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

For example,
        + lister query 121132636 dirs stem dirs
would return
        dirs.count     = 1
        dirs.0         = "Clipboards"
        dirs.1         = "ENV"
        dirs.2         = "T"

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

See also:

 lister query entry 
 lister query entries 
 lister query files 
 lister query numdirs 
 lister query numseldirs 
 lister query seldirs 


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