ADD-NEW-FIELD( ) method

Adds a field with the specified properties to the temp-table. Additional properties can be manipulated by creating a buffer-field object for this field.

This method cannot be called after TEMP-TABLE-PREPARE( ) has been called unless CLEAR( ) is called first.

Return type: LOGICAL

Applies to: Temp-table object handle

Syntax

ADD-NEW-FIELD ( field-name-exp , datatype-exp[ , extent-exp[ , format-exp 
  [ , initial-exp[ , label-exp[ , column-label-exp ]]]]] )
field-name-exp
A character expression that evaluates to the name of the field to be created in the temp-table.
datatype-exp
A character expression that evaluates to the data type of the specified field.
extent-exp
An integer expression specifying the extent of an array. If extent-exp is 0, 1 or the Unknown value (?), it is ignored.
format-exp
A character expression that evaluates to the data format for the defined data type. If format-exp is "" or the Unknown value (?), it is ignored and the default format of the specified data type is used.
initial-exp
An expression that evaluates to the initial value of the defined field. initial-exp can be any compatible data type, but is usually character. If initial-exp is not entered, the default for the data type is used.
label-exp
An optional character expression that evaluates to the label of the defined field. If you do not specify a value, or you pass the Unknown value (?), label-exp defaults to the value of the field-name-exp parameter.
column-label-exp
An optional character expression that evaluates to the label of the column associated with the defined field. If you do not specify a value, or you pass the Unknown value (?), column-label-exp defaults to the value of the label-exp parameter (or the field-name-exp parameter, if the label-exp parameter is not specified).

The following example fragment adds a new character field called "abfield" which is initialized to "abc" to a temp-table:

tth:ADD-NEW-FIELD("abfield","char",0,,"abc").
Note: There is a limit to the number of fields that can be accommodated in a temp-table object. The limit depends on how large the field information (initial value, validate information, help messages, etc.) is, but you should plan on a limit of approximately 1,000 fields.