TABLE.CREATE_BEGIN Function
Syntax
Arguments
- FieldnameCharacter
The name of the field.
- FieldtypeCharacter
The field types, the single character codes used to represent them, and the valid parameters associated with them are:
- Field Type
- Type Code and Valid Parameters
- Bitmap
"B", Fieldname, Field Type
- Character
"C", Fieldname, Field Type, Width
- Date
"D", Fieldname, Field Type
- Exponent Numeric
"E", Fieldname, Field Type
- Linked image
"I", Fieldname, Field Type
- JPEG
"J", Fieldname, Field Type
- Logical
"L", Fieldname, Field Type
- Memo
"M", Fieldname, Field Type
- Numeric
"N", Fieldname, Field Type, Width , Decimal Width
- OLE
"O", Fieldname, Field Type
- Rich text memo
"R", Fieldname, Field Type
- Time
"T", Fieldname, Field Type
- Short Time
"Y", Fieldname, Field Type
- Field_WidthNumeric
The number of characters (including any decimal characters) to allocate to the field. Available if Field_Type is "C" or "N".
- Field_DecimalNumeric
The number of characters after the decimal point. Only available if Field_Type is "N".
- flagsCharacter
Additional flags.
Description
Start defining a new Table, defines the first field.
Discussion
The TABLE.CREATE_BEGIN() method is used together with the TABLE.FIELD_ADD() and TABLE.CREATE_END() methods to define and create a new table file. The first field of the table is defined in TABLE.CREATE_BEGIN(). Subsequent fields are then defined using TABLE.FIELD_ADD(). When the table definition is complete, use TABLE.CREATE_END() to actually create and open the table file.
A field definition consists of at least two parameters, the Field_Name and Field_Type, and can contain up two optional parameters, Width and Decimal_Width. Field_Type is a string containing a single-character code representing one of the field types.
The chosen field type determines how the optional parameters are used. If the Field_Type is Character, an additional Width parameter is supplied, and if the Field Type is Numeric, the additional Width and optional Decimal Width parameters are specified. Date, Memo, Rich text memo, Bitmap, OLE, and Logical fields are always defined with two parameters because the field widths for these field types are set automatically.
Example
Create a table.
table.create_begin("firstname","c",30)
table.field_add("lastname","c",30)
table.field_add("price","n",5,2)
table.field_add("quantity","n",2)
table.field_add("birthday","d")
'The create_end() method creates the table and assign an object pointer to the table
tbl = table.create_end("c:\sample.dbf")
' optionally get the fully qualified name of the new table and add it to the workspace
newtable = tbl.filename_get()
file_add_to_db(newtable)
tbl.close()See Also