get-list

get-list


get-fof Index Level get.pick
Syntax gl {{file.reference} list.name {list.name...} } {(attr.ref} {(options}
get-list {{file.reference} list.name {list.name...} } {(attr.ref} {(options}
Category TCL
Type Verb
Description activates an item-list from a file. The default file is the "pointer-file".

Multiple list.names may be specified to create longer lists. If the optional "file.reference" is used the specified file is used to retrieve the item. "list.name" is the list that contains attributes to place in the active list. If more than one "list.name" is specified, the lists are concatenated into a single list.

If no "list.name" is specified, the default name, "%user.name", is used.

"attr.ref" indicates an attribute name or number. This creates a list from the specified attribute. Note that temporary attribute-defining items may also be used.
Options s    Creates a "secondary" list.
u    Inhibits selection of duplicated items within multiple lists.
See Also copy-list save-list select el delete-list nselect copy readnext readnext qselect sselect active list secondary list pointer-file sort-list gl edit-list READNEXT u1195 fl compare-list
Example gl xx yy
[404] 358 items selected out of 2 items.
>

get-list duplicates
[404] 67 items selected out of 1 items.
>     

get-list old.invoices new.invoices (u
[404] 405 items selected out of 2 items.
This combines the two lists, "old.invoices" and "new.invoices" into one list. The "u" option eliminates redundant references within the list.
Warnings In R83, only a single list may be specified.
Compatibility D3 7.0 R83 AP
get-fof Index Level get.pick