table.IMPORT_ASCII_TABLE Function
Syntax
Arguments
- Record_Count
The number of records processed, imported and not imported (because they violated a field rule in the target table). The format of the result string is:
- Record_CountProcessed:xxx
- Total:xxx
- Violated:xxx
- ascii_filename
The name of the file to import.
- skip_lines
Optional. Default = 0. Indicates how many rows to skip in the file being imported. If the file that you are importing has field names in row 1, then you would set Skip_Lines to 1.
- silent
Optional. Default = .T.
- .T. = Alpha Anywhere does not display a confirmation message.
- .F. = Alpha Anywhere does display a confirmation message after the data is imported.
Description
Imports a fixed length ascii file into an existing table. Ascii file must match the structure of the table. If ascii file has fieldnames, set skip_lines to 1
Discussion
The .IMPORT_ASCII_TABLE() method imports a CR-LF delimited ASCII file directly into a table. The ASCII data must exactly mach the format of the table. For example, assume that the table that you want to import data into has this structure:
Customer,C,20 City,C,1 5 State,C,2
The ASCII file must have "Customer" data starting in column 1, "City" data starting in column 21, and "State" data starting in column 36.
Example
The following Xbasic snippet shows how this method can be used to import data contained in a file called "c:\tabledata.txt" into a table called "customers":
Dim tbl as P Tbl = table.open("customers") Tbl.Import_Ascii_Table("c:\tabledata.txt",1,.f.) Tbl.close()
See Also