make_file


The make_file function creates a file of zero length. The file name is specified using its full path, for example, a string or value equal to "D:\\data\\2022-06-14\\data\\my_new_file.txt". Note that Windows directory components must be separated by the '\\' or '/' characters.

Syntax

bSuccess, sMsg = make_file( sFullPathName )

bullet.gif    sFullPathName is the full path name of the new file.

bullet.gif    bSuccess is true if the function is successful or false if not.

bullet.gif    sMsg is an optional message string that recieves information about the failure.

Remarks

This function does not change the current directory to the path of the file it creates. If the target file already exists or cannot be created, make_file will fail and return false plus an error message. You can use is_file to test whether the file was created.

The new file has zero length but may be filled and otherwise manipulated using many different classes and functions, for example, the CFile class or the Printf function.

Related Topics

Directory Functions, is_file, remove_file, rename_file, make_dir, CFile class


Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics, Inc. All Rights Reserved.