FindReplaceBuffer - method of the PmBuffer object

Description:

Replaces the occurrences of the searched data block in the data block with another data block.

Syntax:

Long FindReplaceBuffer(Long nOffset, Object oFind, Object oReplace, [Long nCount])

Parameters:

nOffset	(Long) Specifies 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. >= 0 - Index (in bytes, zero-based index) in the data block. -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.
oFind	(Object) The searched data block in the form of the PmBuffer object, which will be replaced by the oReplace data block.
oReplace	(Object) The data block in the form of the PmBuffer object, which replaces the found data block oFind.
nCount	[optional] (Long) The number of replacements performed, where -1 (default) means to replace all found data blocks.

Return value:

Returns the number of substitutions made.

Note:

This method is not functional yet in Web panels.

Caution! If the size of oFind and oReplace are different, then each swap also results in an increased/decreased size of the data block.
This operation shifts the internal automatic position behind the last byte of the replaced data block.

Example:

JavaScriptSelect and copy to clipboard



var oBuf = Pm.CreatePmBuffer();

oBuf.SetUint8(-2, 0x10);
  // Offset: 0

oBuf.SetUint8(-2, 0x20);
  // Offset: 1

oBuf.SetUint8(-2, 0x30);
  // Offset: 2

oBuf.SetUint8(-2, 0x40);
  // Offset: 3

oBuf.SetUint8(-2, 0x10);
  // Offset: 4

oBuf.SetUint8(-2, 0x20);
  // Offset: 5

oBuf.SetUint8(-2, 0x30);
  // Offset: 6

oBuf.SetUint8(-2, 0x40);
  // Offset: 7

var oFind = Pm.CreatePmBuffer();

oFind.SetUint8(-2, 0x20);

oFind.SetUint8(-2, 0x30);

var oReplace = Pm.CreatePmBuffer();

oReplace.SetUint8(-2, 0xff);

var s0 = oBuf.GetHexaString(0);
  // The result will be "1020304010203040"

var n = oBuf.FindReplaceBuffer(0, oFind, oReplace, -1);
  // The result will be 2

var s1 = oBuf.GetHexaString(0);
  // The result will be "10ff4010ff40"