Creates a file and appends an incrementing number suffix to the filename if the file already exists at a specified path. If the file does not exist, this node creates the file without appending an incrementing number suffix to the filename.
A string that uses format specifiers to determine how to convert the data into what you specify.
Syntax Elements for Creating a Format Specifier
Use the following syntax elements to create a format specifier for the input string.
Format Specifier Examples for Format String
format string | file path | actual path | Comments |
---|---|---|---|
%d | C:\test.txt | C:\test (1).txt | The %d in format string specifies that the node appends an incrementing number starting with 1 to the filename before the period (.). |
%4d | C:\test.txt | C:\test 1.txt | The 4 in format string specifies that the suffix after the filename and before the period (.) has a width of 4. |
Default: %d
Absolute path to the file you want to create. If you specify an empty or relative path, this node returns an error.
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
Default: No error
A reference to the file this node creates.
Path to the file this node creates.
The node produces this output according to standard error behavior.
This node can return the following error codes.
1430 | The path is empty or relative. You must use an absolute path. |
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
Where This Node Can Run:
Desktop OS: Windows
FPGA: Not supported
Web Server: Not supported in VIs that run in a web application