Crestron simpl plus language ref 사용자 설명서
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
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.
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).
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.
writing functions, just internal variables.