Crestron simpl plus language ref 사용자 설명서

다운로드
페이지 374
Crestron SIMPL+
®
Software 
Language Reference Guide - DOC. 5797G
 SIMPL+
®
 
z 187
WriteIntegerArray
Name:
WriteIntegerArray
Syntax:
SIGNED_INTEGER WriteIntegerArray( INTEGER file_handle, 
INTEGER iArray[m][n] ) 
Description:
Writes the array from a file starting at the current file position. Two bytes are written, 
most significant first containing the row dimension of the array, then two more bytes 
are written, containing the column dimension of the array. Then each integer is 
written as a two byte quantity, most significant byte first. The integers are stored in 
row-major order, e.g. all the elements of row 0 first, then the elements of row 1, etc. 
Note that there is one more row and one more column than the dimensions that are 
written, because there is a row 0 and a column 0. Refer to the section entitled 
“Reading and Writing Data to a File” on page 
 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.
Use ReadLongIntegerArray to read this.
Parameters:
FILE_HANDLE specifies the file handle of the previously opened file (from 
FileOpen). 
IARRAY is the array whose values are written. 
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.