n = Pm.FileBinaryWrite(sFile, nOffset, nAttr, Values)
|sFile||(String) The file name with the path. If a full path is not entered, then it is completed relatively according to the application file 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)|
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