Latest revision |
Your text |
Line 1: |
Line 1: |
− | [[Category:MGED|Ls]]
| + | h |
− | [[category:MGED geometry information commands|Ls]]
| |
− | =ls=
| |
− | __TOC__
| |
− | | |
− | ==Syntax==
| |
− | :ls [-A -o -a -c -r -s -p <nowiki>-l</nowiki>] [objects]
| |
− | | |
− | | |
− | ==Argument(s)==
| |
− | : '''[-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)==
| |
− | : No Return Values for this command.
| |
− | | |
− | | |
− | ==Description==
| |
− | 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 [[MGED_CMD_hide|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 [[MGED_CMD_attr|attr]] command for information on how to set or get attributes. Regular expressions are not supported for attributes.
| |
− | | |
− | | |
− | ==Example(s)==
| |
− | : '''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==
| |
− | : [[MGED_CMD_l|l]]
| |
− | : [[MGED_CMD_lm|lm]]
| |
− | : [[MGED_CMD_hide|hide]]
| |
− | : [[MGED_CMD_attr|attr]]
| |
− | | |
− | ----
| |
− | | |
− | Page Generated by David Loman on: 10/11/2007 at: 1:48:34 PM
| |