MGED CMD ls

From BRL-CAD

ls[edit]

Syntax[edit]

ls [-A -o -a -c -r -s -p -l] [objects]


Argument(s)[edit]

[-A]
Optional. Use attribute name/value pairs.
[-o]
Optional. Match at least one attribue name value pair.
[-a]
Optional. List all objects in db.
[-c]
Optional. List all non-hidden objects in database.
[-r]
Optional. List all non-hidden regions in database.
[-s]
Optional. List all non-hidden primitives in database.
[-p]
Optional. List all non-hidden primitives in database.
[-l]
Optional. Display results in long format showing object name, object type, major type, minor type, and length.
[objects]
Optional. Object(s) to list.


Return Value(s)[edit]

No Return Values for this command.


Description[edit]

The "ls" command with no object argument lists the name of every object in the database (in alphabetical order) except for those marked as hidden with the hide command. If the object argument is supplied, only those objects are listed. The object argument may include regular expressions. If the -A option is used, then the arguments are expected to be a list of attribute name/value pairs, and objects having attributes that match the provided list are listed. By default, an object must match all the specified attributes in order to be listed; however, the -o flag indicates that an object matching at least one attribute name/value pair should be listed. See the attr command for information on how to set or get attributes. Regular expressions are not supported for attributes.


Example(s)[edit]

mged> ls shape*
List all objects with names beginning with "shape" (output is formatted).
mged> ls -a shape*
List all objects with names beginning with "shape."
mged> ls -p wheel*
List all primitives with names beginning with "wheel."
mged> ls -r wheel*
List all regions with names beginning with "wheel."
mged> ls -c suspension*
List all combinations with names beginning with "suspension."
mged> ls -A -o -r Comment {First comment} Comment {Second comment}
List all regions that have a "Comment" attribute that is set to either "First comment" or "Second comment."


See Also[edit]

l
lm
hide
attr

Page Generated by David Loman on: 10/11/2007 at: 1:48:34 PM