CONTROL
- Introduction to CTRL
- Control Classes
- Types of Control Functions
- Control graphics
- CONTROL Functions
  - Funtions A
  - Funtions B
    - base64Decode()
      Decodes base64 encoded data.
    - base64Encode()
      Encodes data in the base64 encoding.
    - baseName()
      The function returns the last part of a file path.
    - beep()
      Issues a beep.
    - bitmapEditor() - obsolete
      This function opens the bitmap editor. To be able to use the function, the PVSSBitmapEditor.dll has to exist in the directory <version_path>/bin (obsolete from version 3.5 up).
    - blobAppendValue()
      Works like blobSetValue(), but the value is appended to the blob.
    - blobGetValue()
      Reads "value" from byte offset "offset" with "len" bytes from blob.
    - bloblen()
      The function returns the length of a blob in bytes.
    - blobRead()
      The function blobRead() reads the content of a file into a blob variable.
    - blobSetValue()
      Writes "value" from byte position "offset" with "len" bytes to the blob.
    - blobWrite()
      The function blobWrite writes the content of a blob variable into a file.
    - blobZero()
      Sets blob length to len bytes and initialize the blob with "0".
    - byteSizeToString()
      Converts a filesize in bytes to a string (for example, with getFileSize()).
  - Funtions C
  - Funtions D
  - Functions E
  - Functions F
  - Functions G
  - Functions H
  - Functions I
  - Functions J
  - Functions K
  - Functions L
  - Functions M
  - Functions N
  - Functions O
  - Functions P
  - Functions Q
  - Functions R
  - Functions S
  - Functions T
  - Functions U
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- CtrlExtension, basics
- CTRL Debugger
  You can use the CTRL debugger to debug the Control programming language. The debugger can be used via its own panel, which also enables the monitoring and setting of variable values during the execution of a script.

blobAppendValue()

Works like blobSetValue(), but the value is appended to the blob.

Synopsis

int blobAppendValue(blob &target, anytype value, int len[, bool bigEndian]);

Parameters


Parameter	Description
&target	The blob
value	Value of any type, which has to be appended
len	Length of the value that should be appended. The type can be of type "anytype" (for example, anytype len = 4; ).
bigEndian	Defines whether a value is a Big Endian or Little Endian, TRUE uses bigEndian

Return Value

The length of the target blob (after the value was appended).

Errors

Missing or wrong arguments

Description

If data are sent in a blob, then the data have to be treated with CTRL functions for using the data in CTRL. Similar to blobSetValue(), but this function append the value to the blob.

Example

main()
{
  blob target;
  int len, pos;
  string s;
  anytype value;
  bool bigendian;
  s = "FFAB003AFF";
  target = s;
  DebugN(target);
  len = 1;
  value = 5;
  bigendian = TRUE;
  DebugN("Blob AppendValue : " + blobAppendValue( target,
  value, len, bigendian ));
//length of blob is 6 = FF AB 0 3A FF 5
  DebugN(target);
//ff ab 0 3a ff 5
}

Assignment

Blob functions

Availability

CTRL