*tableinsertcolumn
Inserts a column of data into a table.
Syntax
*tableinsertcolumn name data_type column_label string_array number_of_strings column_index
Type
HyperMesh Tcl Modify Command
Description
Inserts a column of data into a table.
Inputs
- name
- The name of the table to update.
- data_type
- The data type of the column. See *tablecreate for valid values.
- column_label
- The label of the column.
- string_array
- The ID of the string array that contains the column data to add. The string array is created using the *createstringarray command. This should always be set to 1.
- number_of_strings
- Integer indicating the size (number of strings) in the string array created using *createstringarray. This must equal the number of rows in the table.
- column_index
- The index of the column to insert. Tables are indexed starting from 1 (1 to n columns).
Example
To insert column 4 of type integer and label INTEGERS to "table1" which has 7 rows:
*createstringarray 7 1 2 3 4 5 6 7
*tableinsertcolumn "table1" int INTEGER 1 7 4
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
11.0.101