Promotic
WikipediaLinkedInYoutubeTwitterFacebook

GetHexaString - method of object PmBuffer

Description:
Reading the data block in the form of HexaString.
Syntax:
String GetHexaString([Long nOffset], [Long nSize], [Long nAttr])
Calling:
Value = PmBuffer.GetHexaString(nOffset, nSize, nAttr)
Parameters:
nOffset[optional] (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.

Default: 0.

>= 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.

nSize[optional] (Long) The size of read data block. The value -1 (default) means that the data block is read from the defined starting position to the end.
nAttr[optional] (Long) Defines how the HexaString is generated.
0 (default) - The hexa characters will be lowercase.
1 - The hexa characters will be uppercase.
Note:
This method is also functional in 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.SetInt32(-2, 0x10203040);
b.SetInt16(-2, 0x5060);
b.SetUint8(-2, 0x70);
var s = b.GetHexaString();  //The result will be a HexaString "40302010605070"

History:
Pm9.00.05: New parameter nAttr that defines the way the HexaString is generated.
Pm9.00.04: Created
PROMOTIC 9.0.7 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