SetBuffer - method of the PmBuffer object

Description:

Writing data block in the form of the PmBuffer object.

Syntax:

Empty SetBuffer(Long nOffset, Object oBuff)

Parameters:

nOffset	(Long) Specifies the position of written value in the data block. The whole written value must 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 the data block. -2 - The whole item is added to the end of the data block. The size of the data block is increased by the written item. -4 - The internal automatic position is used (see the AutoOffset property). It points behind the last read or written value. This operation shifts the internal automatic position behind the read/written value. If the items are read/written one by one then it is not necessary to define the position manually, but it is better to use this automated positioning.
oBuff	(Object) Data block in the form of the PmBuffer object that is being written.

nOffset

(Long) Specifies the position of written value in the data block.
The whole written value must 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 the data block.

-2 - The whole item is added to the end of the data block. The size of the data block is increased by the written item.

-4 - The internal automatic position is used (see the AutoOffset property). It points behind the last read or written value.
This operation shifts the internal automatic position behind the read/written value.
If the items are read/written one by one then it is not necessary to define the position manually, but it is better to use this automated positioning.

oBuff

(Object) Data block in the form of the PmBuffer object that is being written.

Note:

This method is also functional in Web panels.

Example:

JavaScriptSelect and copy to clipboard



var oBuf = Pm.CreatePmBuffer();

var s1 = "4030201060";

oBuf.SetHexaString(-2, s1);

var nSize = oBuf.GetBuffer();
  // nSize = 7


var oBuf2 = Pm.CreatePmBuffer();

var s2 = "5070";

oBuf2.SetHexaString(-2, s2);


oBuf.SetSize(nSize + 2, 1);

oBuf.SetBuffer(nSize, oBuf2);

var val = oBuf.GetHexaString();
  // val = "40302010605070"