The Write Delimited Spreadsheet function converts a 2D or 1D array of strings, signed integers, or double-precision numbers to a text string and writes the string to a new byte stream file or appends the string to an existing file. Wire data to the 2D data input or 1D data input to determine the polymorphic instance to use or manually select the instance.
Usage
This VI is polymorphic and has three instances:
Double Instance
Data Type
Name
Description
format
format specifies how to convert the numbers to characters. If the format is %.3f (default), the VI creates a string long enough to contain the number, with three digits to the right of the decimal point. If format is %d, the VI converts the data to integer form using as many characters as necessary to contain the entire number. If format is %s, the VI copies the input string. Use the format string syntax.
file path
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.
2D data
2D data specifies the data to write to the file if 1D data is not wired or is empty.
1D data
1D data specifies the data to write to the file if this input is not empty. The VI converts the 1D array into a 2D array before proceeding.
append to file?
append to file? appends data to an existing file, if TRUE (). If append to file? is FALSE (default) (), the VI replaces data in an existing file. If there is no existing file, the VI creates a new file.
error in
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
transpose?
transpose? specifies whether the VI transposes the data after converting it from a string. The default is FALSE ().
delimiter
delimiter is the character or string of characters to use to separate fields in the spreadsheet file. For example, a value of , (comma) specifies a single comma as the delimiter. The default is \t, which specifies a single tab character as the delimiter.
new file path
new file path returns the path to the file.
error out
error out contains error information. This output provides standard error out functionality.
Integer Instance
Data Type
Name
Description
format
format specifies how to convert the numbers to characters. If the format is %.3f (default), the VI creates a string long enough to contain the number, with three digits to the right of the decimal point. If format is %d, the VI converts the data to integer form using as many characters as necessary to contain the entire number. If format is %s, the VI copies the input string. Use the format string syntax.
file path
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.
2D data
2D data specifies the data to write to the file if 1D data is not wired or is empty.
1D data
1D data specifies the data to write to the file if this input is not empty. The VI converts the 1D array into a 2D array before proceeding.
append to file?
append to file? appends data to an existing file, if TRUE (). If append to file? is FALSE (default) (), the VI replaces data in an existing file. If there is no existing file, the VI creates a new file.
error in
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
transpose?
transpose? specifies whether the VI transposes the data after converting it from a string. The default is FALSE ().
delimiter
delimiter is the character or string of characters to use to separate fields in the spreadsheet file. For example, a value of , (comma) specifies a single comma as the delimiter. The default is \t, which specifies a single tab character as the delimiter.
new file path
new file path returns the path to the file.
error out
error out contains error information. This output provides standard error out functionality.
String Instance
Data Type
Name
Description
format
format specifies how to convert the numbers to characters. If the format is %.3f (default), the VI creates a string long enough to contain the number, with three digits to the right of the decimal point. If format is %d, the VI converts the data to integer form using as many characters as necessary to contain the entire number. If format is %s, the VI copies the input string. Use the format string syntax.
file path
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.
2D data
2D data specifies the data to write to the file if 1D data is not wired or is empty.
1D data
1D data specifies the data to write to the file if this input is not empty. The VI converts the 1D array into a 2D array before proceeding.
append to file?
append to file? appends data to an existing file, if TRUE (). If append to file? is FALSE (default) (), the VI replaces data in an existing file. If there is no existing file, the VI creates a new file.
error in
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
transpose?
transpose? specifies whether the VI transposes the data after converting it from a string. The default is FALSE ().
delimiter
delimiter is the character or string of characters to use to separate fields in the spreadsheet file. For example, a value of , (comma) specifies a single comma as the delimiter. The default is \t, which specifies a single tab character as the delimiter.
new file path
new file path returns the path to the file.
error out
error out contains error information. This output provides standard error out functionality.
History
History information is needed. What changes have occurred over previous versions?