*TREAD

*TREAD, Par, Fname, Ext, --, NSKIP
Reads data from an external file into a table array parameter.

Valid Products: Pro | Premium | Enterprise | PrepPost | Solver | AS add-on

Argument Descriptions

Par

Table array parameter name as defined by the *DIM command.

Fname

File name and directory path (248 characters maximum, including the characters needed for the directory path). An unspecified directory path defaults to the working directory; in this case, you can use all 248 characters for the file name.

File name has no default.

Ext

Filename extension (eight-character maximum).

Extension has no default.

--

Unused field.

NSKIP

Number of comment lines at the beginning of the file being read that will be skipped during the reading. Default = 0.

Notes

Use this command to read in a table of data from an external file into a table array parameter. The external file may be created using a text editor or by an external application or program. To be used by *TREAD, the external file's encoding format must be UTF-8, and the file must be in tab-delimited, blank-delimited, or comma-delimited format. The TABLE type array parameter must be defined before you can read in an external file. See *DIM for more information.

This command is not applicable to 4- or 5-D tables.

Menu Paths

Utility Menu>Parameters>Array Parameters>Read from File