hm_attributesolverarrayvalues

Returns the solver code and all values for a 1D array attribute on an entity.

Syntax

hm_attributesolverarrayvalues entity_type entity_name_or_id search_type attribute_name_or_id ?extend_search?

Type

HyperMesh Tcl Query

Description

Returns the solver code and all values for a 1D array attribute on an entity. The command first searches to find the specified attribute for the current template. If the attribute is not found for the current template, the search can be extended to search all attributes assigned to the entity. If the attribute does not exist on the entity, an error is returned. The length of the returned list can be determined using the hm_attributearraylength command and adding 1.

Inputs

entity_type
The type of entity to query.
entity_name_or_id
The name or ID of the entity.
search_type
By default, HyperMesh searches for entities by name, and if the name is not found, it then searches by ID. This option allows you to specify how the search for an entity should be conducted. Valid values are:
-byname - Search only by name.
-byid - Search only by ID.
attribute_name_or_id
The name or ID of the attribute to query. If a name is specified, the attribute must exist in the current template.
extend_search
By default, the attribute will only be searched for the current template. However, the search can be extended to search all attributes assigned to the entity. If the attribute is specified by name, this argument is ignored and only the current template is considered. Valid values are:
0 - Search only attributes for the current template on the entity.
1 - Search all attributes on the entity.

Example

To get the solver code and all values of the 1D array for the attribute with name Example on material 6, considering only the current template:

hm_attributesolverarrayvalues material 6 Example –byid

or

hm_attributesolverarrayvalues material 6 Example –byid 0

To get the solver code and all values of the 1D array for the attribute with ID 100 on material 6, considering all attributes:

hm_attributesolverarrayvalues material 6 100 –byid 1

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}