This method is obsolete (but functional) and it is better to use the PmBuffer.SaveToFile method.
|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.
|nOffset||(Long) Byte offset that sets the beginning of writing into the binary file (e.g. 10 means writing into 10th byte of the file). If the value is -1, then offset is set to the end of the file. The parameter has the importance only for nAttr=1, otherwise nOffset=0 must be set.|
|nAttr||(Long) Bit attribute. It can be 0 or a sum of the following applicable values.|
If the file already exists, then its content will be overwritten from the offset (see the nOffset parameter).
If the value 1 is not set, then the entire content of the file will be cleared before writing.
2 - Value of the String type (text string) is stored without the string end character.
If the value 2 is not set, then the string is stored into the file and one more byte with the value 0 is added (the string end character).
|Values||(Variant) Variable of the Array type whose items are stored.|
Individual array items are stored according to their data type in this matter:
|Data type:||Number of stored bytes into the file:|
|String||number of characters + 1 (1 for the character 0, only if nAttr=2 is not set)|
1st item is of the Long type and thus 4 bytes are written.
2nd item is of the String type and thus 5 bytes are written (including ending 0),
3rd item if of the Double type and thus 8 bytes are written and
4th item if of the Byte type, and thus only one byte is written.
Thus altogether 4+5+8+1 bytes are written into the file.
Dim Length, Val
Val = Array(CLng(1), "test", CDbl(3.14), true)
Length = Pm.FileBinaryWrite("#data:File.bin", 0, 0, Val)
If Length = 4+5+8+1 Then
Pm.Debug "Data have successfully been written"
Pm.Debug "Writing data failed! Length=" & Length