hm_getincludesentities

Selects entities and returns the entity types contained in specified include files.

Syntax

hm_getincludesentities <select_type>=<selection> outputmark=<mark_id?

Type

HyperMesh Tcl Query Command

Description

Selects entities and returns the entity types contained in specified include files. The return value is the list of entity types found in the specified includes. The actual entities are populated on the specified mark.

Inputs

<select_type>=<selection>

The entity or entities that are to be queried. There are several ways to provide the entities to be queried. Only one option can be used at a time:

includeids=<ids>: The IDs of the includes to query.
includenames=<names>: The names of the includes to query.

outputmark=<mark_id>

The ID of the mark that contains the found entities. Valid values are 1 and 2.

Examples

To find all of the entities in include IDs 1,2,3,4:

hm_getincludesentities includeids={1 2 3 4} outputmarkid=1

To find all of the entities in include names inc1, inc2, inc3, inc4:

hm_getincludesentities includenames={inc1 inc2 inc3 inc4} outputmarkid=1

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2021