*CE_MarkSplitLink

Split group links into individual links.

Syntax

*CE_MarkSplitLink mark_id search_type search_rule search_string_array search_number_of_strings ?keep_realized?

Type

HyperMesh Tcl Modify Command

Description

Split group links into individual links.

Inputs

mark_id
The ID of the mark of connectors to split. Valid values are 1 and 2.
search_type
The specific link type to search in the connector.
search_rule
The rule by which the link entity was added to the connector:
0 - Undefined
1 - None
2 - Use ID
3 - Use Name
4 - Proximity
5 - Use UID
search_string_array
A string array containing the list of of link IDs/names/UIDs in the group link, created using*createstringarray. This must be set to 1.
The strings are generally IDs/names/UIDs based on the search_rule.
search_number_of_strings
Integer indicating the size (number of strings) in the search_string_array created using *createstringarray.
keep_realized
Option to keep the current connector state after the update operation:
0 - Unrealize if needed (default)
1 - Keep current state

Examples

To split the group link of 3 components consisting of component IDs: 1, 2 and 4 in connector ID 5:

*createmark connectors 1 5
*createstringarray 3 1 2 4
*CE_MarkSplitLink 1 comps 1 1 3 0

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

2019