nWriteBytes = PmBuffer.SaveToFile(nOffset, sFile, nFileOffset, nLength)
|nOffset||(Long) Defines the position of read value in the data block. |
The read value must be inside the data block. The item is read either whole or not read at all.
>= 0 - Index (in bytes, zero-based index) in data block.
-4 - The internal automatic position is used (see AutoOffset). It points behind the last read or written value and increases continually.
If the items are read/written one by one then it is not necessary to define the position, but it is handy to use this automated positioning.
|sFile||(String) The file name with the path. |
If a full path is not entered, then it is completed relative to the application folder.
It is recommended to use the PROMOTIC path syntax - see PROMOTIC path to files and folders.
|nFileOffset||[optional] (Long) Defines the position of written value in the binary file in bytes. The value 0 (default) means writing from the beginning of the file.|
|nLength||[optional] (Long) Defines the number of written bytes.|
>=0 - Number (count) in bytes
-1 (default) - Writing all values up to the end of the data block.
-2 - Writing all values up to the end of the data block and then sets the end of the file.
var oBuf = Pm.CreatePmBuffer();
nSize = oBuf.SaveToFile(0, "#data:Test.bin", 0, -1);