*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 3

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