*tablecreate

Creates a new table.

Syntax

*tablecreate name color config string_array number_of_columns number_of_rows

Type

HyperMesh Tcl Modify

Description

Adds a row of data to the bottom of a table.

Inputs

name
The name of the table to create.
color
The color of the table. Valid values are 1-64.
config
Currently reserved for future use. Must be set to 1.
string_array
The ID of the string array that contains the data type of each column. The string array is created using the *createstringarray command. This should always be set to 1.
Valid column data types are:
  • bool
  • string
  • int
  • unsignedint
  • float
  • double
  • triple
  • HM
  • entity
  • types (e.g. elements, plies, components, etc...)
number_of_columns
Integer indicating the size (number of strings) in the string array created using *createstringarray. This must equal the number of columns in the table.
number_of_rows
Integer indicating the number of rows to pre-reserve in the table.

Example

To create a table named "table1" with color 3, 4 columns of data (integer, double, string, elements), and no pre-reserved rows:

*createstringarray 4 INT DOUBLE STRING elements
*tablecreate table1 3 1 1 4 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

11.0