TABLE_RESTRUCTURE Function
Syntax
Arguments
- Field_List
CR-LF delimited list of field specifications in the format: Field_Name [ = Original_Name ], Type [ + ], Width, Dec [ = Expression ]
- Field_Name
The new name of the field to restructure.
- Original_Name
Optional. Default = Field_Name. The original name of the field to restructure. You need to specify this if you are renaming the field. "" = delete the existing field named Field_Name and create a new one.
- Type
The data type of the field. Adding a "+" after the field type will define the field as an auto-increment field.
- Width
Optional. The width of the field in characters. Required only for character and numeric fields.
- Dec
Optional. The number of decimal characters. Required only for numeric fields.
- Expression
Optional. Defines the expression to use and creates a calculated field that will not appear in the table structure.
Description
The TABLE_RESTRUCTURE() function takes a CR-LF delimited list of field specifications in the format [=],,, and restructures a table.
Example
The following example modifies the Cust2 table.
dim c2 as P
c2 = table.open("cust2",FILE_RW_EXCLUSIVE)
c2.table_restructure(<<%str%
CUSTOMER_ID,Character,8,0
FIRSTNAME,Character,25,0
LASTNAME,Character,25,0
COMPANY,Character,32,0
PN=PHONE,Character,20,0
FAX,Character,20,0
BILL_ADDRESS_1,Character,40,0
BILL_ADDRESS_2,Character,40,0
BILL_CITY,Character,20,0
BILL_STATE_REGION,Character,20,0
BILL_POSTAL_CODE,Character,10,0
BILL_COUNTRY,Character,20,0
SHIP_ADDRESS_1,Character,40,0
SHIP_ADDRESS_2,Character,40,0
SHIP_CITY,Character,20,0
SHIP_STATE_REGION,Character,20,0
SHIP_POSTAL_CODE,Character,10,0
SHIP_COUNTRY,Character,20,0
SHIP_SAME,Logical,1,0
EMAIL,Character,60,0
NOTE,RTF
%str%)
c2.close()Limitations
Desktop applications only.
See Also