@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.




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:


@FILECLOSEClose a file handle
@FILEOPENOpen a file handle
@FILEREADRead next line from a file handle
@FILESEEKMove a file handle pointer
@FILESEEKLMove a file handle pointer to a specified line
@FILEWRITEBWrite data to a file handle
@TRUNCATETruncate the file at the current position of the file handle pointer.