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
- CTRL Debugger
  With the CTRL Debugger you can debug the programming language Control.

blobSetValue()

Writes "value" from byte position "offset" with "len" bytes to the blob.

Synopsis

int blobSetValue(blob &target, int offset, type value, int len[, bool bigEndian])

Parameters


Parameter	Description
target	The blob
offset	From this position a value is that to a blob
value	Value of any type, which has to be inserted
len	Length of the value
bigEndian	Defines whether a value is a Big Endian or Little Endian, TRUE uses bigEndian

Return Value

With an error -1, otherwise offset + length of the value as an integer

Errors

Missing or wrong arguments

Note that the null byte is not written in case of string variables.

Description

If data are sent in a blob, then the data have to be treated with CTRL functions for using the data in CTRL. Writes "value" from byte position "offset" with "len" bytes to the blob.

Example

main()
{
  blob target;
  int len, pos;
  string s;
  int value;
  bool bigendian;

  s = "FFAB003AFFAB";
  target = s;
  DebugN(target);
  len = 1;
  pos = 3;
  value = 5;
  bigendian = TRUE;
  DebugN("Blob SetValue : " + blobSetValue( target, pos,
  value, len, bigendian ));

// debugs the pos+len= 4, where the value has been set
  DebugN(target);
//ff ab 0 5 ff ab
}

Assignment

Blob functions

Availability

CTRL