Reads a number of rows from a HiQ numeric text file beginning at a character offset and converts the data to a 2D double-precision array of numbers. You can optionally transpose the array. This VI opens the HiQ file before reading from it and closes the HiQ file after reading from it.
![]() |
format indicates how to convert the numbers to characters. If the format string is %.15g (default), the VI creates a string long enough to contain the number, with fifteen digits to the right of the decimal point. If the format is %d, the VI converts the data to integer form using as many characters as necessary to contain the entire number. Refer to the description of formatting strings and the Array To Spreadsheet String function. |
![]() |
file path is the path name of the file. If file path is empty (default) or is Not A Path, the VI displays a dialog box from which you can select a file. Error 43 occurs if you cancel the dialog box. |
![]() |
number of rows is the maximum number of rows or lines the VI reads. For this VI, a row is a character string ending with a carriage return, line feed, or a carriage return followed by a line feed; a string ending at the end of file; or a string that has the maximum line length specified by the max characters per row input. If number of rows is <0, the VI reads the entire file. The default is 1. |
![]() |
start of read offset is the position in the file, measured in characters (or bytes), at which the VI begins reading. The offset unit is bytes rather than numbers because byte stream files can contain segments of different types of data. Therefore, to read an array of 100 numbers that follows a header of 57 characters, set start of read offset to 57. |
![]() |
max chars/row is the maximum number of characters the VI reads before ending the search for the end of a row or line. The default is 0, which indicates that there is no limit to the number of characters the VI reads. |
![]() |
If transpose? is TRUE, the VI transposes the data after converting it from a string. The default is FALSE. |
![]() |
new file path is the path of the file from which the VI reads data. You can use this output to determine the path of a file that you open using a file dialog box. new file path returns Not A Path if you select Cancel from the dialog box. |
![]() |
all rows is the data read from the file in the form of a 2D array of double-precision numbers. |
![]() |
first row is the first row of the all rows array in the form of a 1D array of double-precision numbers. Use this output when you want to read one row into a 1D array. |
![]() |
file position after read is the location of the file mark after the read; it points to the character in the file following the last character read. |
![]() |
EOF? is TRUE if you attempt to read past the end of file. |