fread_delimited (MathScript RT Module Function)
Owning Class: support
Requires: MathScript RT Module
Syntax
m = fread_delimited(file, d)
m = fread_delimited(file, d, range)
m = fread_delimited(file, d, row, col)
Legacy Name: dlmread
Description
Reads an ASCII delimited file.
Inputs
| Name | Description |
|---|---|
| file | Specifies the file you want to read. file is a string |
| d | Specifies the delimiter that separates the values in the file. For example, a value of \t specifies a single tab character as the delimiter. d is a string. |
| range | Specifies the range of the data you want to read. range is a vector of four elements [a b c d], where [a b] is the upper-left corner of the data you want to read and [c d] is the lower-right corner of the data you want to read. You also can use Microsoft Excel spreadsheet notation to specify range, as in range = 'A1..B3'. |
| row, col | Specify the location at which you want to start reading the data. row and col are zero-based. |
Outputs
| Name | Description |
|---|---|
| m | Returns the matrix. |
Details
If you use this function in a stand-alone application or shared library and file is a relative path, LabVIEW searches for the file in the path where you installed the application or shared library. If file is an absolute path, LabVIEW searches for the file on the local machine or target at the specified location. (Real-Time Module) If you deploy this function to an RT target and file is a relative path, LabVIEW searches for the file in the path returned by the Default Data Directory VI.
Examples
In the following example, LabVIEW creates test.dlm in the LabVIEW Data directory. LabVIEW then reads the values in test.dlm and returns these values as a matrix.
fwrite_delimited('test', magic(5), '/', 2, 2);a = fread_delimited('test', '/', 'A2..C3')