Promotic
WikipediaLinkedInYoutubeTwitterFacebook

SetHexaString - method of object PmBuffer

Description:
Writing data block in the form of HexaString.
Syntax:
Empty SetHexaString(Long nOffset, String sValue)
Calling:
PmBuffer.SetHexaString(nOffset, sValue)
Parameters:
nOffset(Long) Defines the position of written value in the data block.

The whole written item muyst be inside the data block, or the whole item is added to the end of the data block. The item is written either whole or not read at all.

>= 0 - Index (in bytes, zero-based index) in data block.
-2 - The whole item is added to the end of the data block. The size of the data bloc is then increased by the written item.
-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 better to use this automated positioning.

sValue(String) Data block in the form of HexaString that is being written.
Note:
This method is also functional for Web panels.
Example:
Creating a data block by continuous writing of 4, 2 and 1 byte integer value (7 bytes total) and then reading the whole content of the data block in the form of a HexaString. For inverse example see SetHexaString.
JavaScriptSelect and copy to clipboard

var b = Pm.CreatePmBuffer();
b.SetHexaString(-2, "40302010605070");
var i32 = b.GetInt32(0);  //The result will be a value 0x10203040
var i16 = b.GetInt16(-4);  //The result will be a value 0x5060
var ui8 = b.GetUint8(-4);  //The result will be a value 0x70

History:
Pm9.00.04: Created
PROMOTIC 9.0.6 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice