Documentation

FileWriteArray

The function writes arrays of any type except for string to a BIN file (can be an array of structures not containing strings or dynamic arrays).

int  FileWriteArray(
   int   file_handle               // File handle
   void  array[],                  // Array
   int   start_item=0,             // Start index in the array
   int   items_count=WHOLE_ARRAY   // Number of elements
   );

Parameters

file_handle

[in]  File descriptor returned by FileOpen().

array[]

[out] Array for recording.

start_item=0

[in]  Initial index in the array (number of the first recorded element).

items_count=WHOLE_ARRAY

[in]  Number of items to record (WHOLE_ARRAY means that records all items starting with the number start_item until the end of the array).

Return Value

Number of recorded items.

Note

String array can be recorded in a TXT file. In this case, strings are automatically ended by the line end characters "\r\n". Depending on the file type ANSI or UNICODE, strings are either converted to ansi-encoding or not.

See also

Variables