*tableupdatecolumn
Updates the values in a column of a table.
Syntax
*tableupdatecolumn name data_flag data_type column_label_flag column_label string_array number_of_strings column_index
Type
HyperMesh Tcl Modify Command
Description
Updates the values in a column of a table.
Inputs
- name
- The name of the table to update.
- data_flag
- A flag defining if the data_type and column data contained in string_array should be updated (1) or ignored (0).
- data_type
- The data type of the column. See *tablecreate for valid values. Ignored if data_flag=0.
- column_label_flag
- A flag defining if the column_label should be updated (1) or ignored (0).
- column_label
- The label of the column. Ignored if column_label_flag=0,
- string_array
- The ID of the string array that contains the column data to update. The string array is created using the *createstringarray command. This should always be set to 1. Ignored if data_flag=0.
- number_of_strings
- Integer indicating the size (number of strings) in the string array created using *createstringarray. This must equal the number of columns in the table. Ignored if data_flag=0.
- column_index
- The index of the column to update. Tables are indexed starting from 1 (1 to n columns).
Example
To update the data of column 3 of "table1" which has 7 rows of integers, but ignore the
label:
*createstringarray 7 1 2 3 4 5 6 7
*tableupdatecolumn table1 1 int 0 "" 1 7 3Errors
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