Table of Contents
Advertisement
Software
File Time and Date Functions Overview
®
284
SIMPL+
These versions of the Time and Date functions in a given SIMPL+ program are used
to retrieve information about the current date and time from the file info structure
returned from FINDFIRST/FINDNEXT. Values can be retrieved as text strings i.e.
"January" or integer values. Typically, integer values are used if computations need
to be performed (i.e. when the date is the 25th, perform a specific action).
WriteLongIntegerArray
Name:
WriteLongIntegerArray
Syntax:
SIGNED_INTEGER WriteLongIntegerArray ( INTEGER
file_handle,
LONG_INTEGER ilArray[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 long integer is
written as a four 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
function and when to use the related functions: FileWrite, WriteInteger, WriteString,
WriteStructure, WriteSignedInteger, WriteLongInteger, WriteLongSignedInteger,
WriteIntegerArray, WriteSignedIntegerArray, WriteLongIntegerArray,
WriteLongSignedIntegerArray, WriteStringArray.
Parameters:
FILE_HANDLE specifies the file handle of the previously opened file (from
FileOpen).
ilArray is the array whose values are Write.
Return Value:
Number of bytes written to the file. If the return value is negative, it is an error code.
Crestron SIMPL+
118
for a discussion of when to use this
Language Reference Guide - DOC. 5797G
®
Advertisement
Table of Contents
