@FILEWRITE[n,text]: Writes a line to the file whose handle is n. Returns the number of characters written, or -1 if an error occurred. A CR/LF will be appended to text.
Numeric input may be entered in either decimal format (a sequence of 0-9 digits) or in hexadecimal format ("0x" followed by a sequence of 0-F hex digits).
This function should only be used with file handles returned by @FILEOPEN If you use it with any other number you may damage other files opened by TCC (or by the program which started TCC).
Beware of characters with special meaning to TCC, such as redirection and piping symbols, within the file. Use SETDOS /X with appropriate codes as needed.
Example:
set h=%@fileopen["d:\path\myfile.txt",w]
echo writing %@filewrite[%h,32]
echo closing handle #%h: %@fileclose[%h]
See also the related handle-based functions:
@FILECLOSE | Close a file handle |
@FILEOPEN | Open a file handle |
@FILEREAD | Read next line from a file handle |
@FILESEEK | Move a file handle pointer |
@FILESEEKL | Move a file handle pointer to a specified line |
@FILEWRITEB | Write data to a file handle |
@TRUNCATE | Truncate the file at the current position of the file handle pointer. |