NAME

iosListObjects - list the name of all objects, that are currently within the IOSYS® database

SYNOPSIS

iosListObjects ?-client clientId? ?pattern?

DESCRIPTION

This command returns a list of all object names, which are currently registered in the IOSYS® database. If a search pattern is supplied, only those objects, which match the pattern (glob style matching), are returned. If the -client option is specified, then only those objects owned (=created) by the given client Id are listed.

Example: 

set objects [iosListObjects]           ;# return all objects, but never more than 65535
set objects [iosListObjects filler*]   ;# return all objects whose name starts with filler
set objects [iosListObjects -client 1] ;# return all objects created by client 1
The result is a list of object names. The internal API call is limited to max. 65535 objects to be returned, so lists not longer than this can be returned. As there is a bug in the API (pattern a* returns also objects matching *a), this limit can also be reached by supplying a pattern. The API return value is always rematched with the original search pattern to correct the bug.

KEYWORDS

Copyright © 2000 Gerhard Hintermayer.