User Guide

Software Crestron SIMPL+
®
146 z SIMPL+
®
Language Reference Guide - DOC. 5797G
FileWrite
Name:
FileWrite
Syntax:
SIGNED_INTEGER FileWrite (INTEGER handle, STRING buffer,
INTEGER count )
Description:
Writes data from a file as a series of bytes into a buffer, starting at the current file
position. Refer to the section entitled “Reading and Writing Data to a File” on page
118 for a discussion of when to use this function and when to use the related functions
FileWrite, WriteInteger, WriteString, WriteStructure, WriteSignedInteger,
WriteLongInteger, WriteLongSignedInteger, WriteIntegerArray,
WriteSignedIntegerArray, WriteLongIntegerArray, WriteLongSignedIntegerArray,
WriteStringArray.
Parameters:
HANDLE specifies the file handle of the previously opened file (from FileOpen).
BUFFER is the variable containing the bytes to be written.
COUNT specifies the number of bytes to write.
Return Value:
Number of bytes written to the file. If the return value is negative, it is an error code.
NOTE: Input and Output variables of any kind are not allowed in the file reading and
writing functions, just internal variables.