Siebel eScript Language Reference > Methods Reference > BLOB Methods >

Write BLOB Data Method

The Write BLOB Data method writes data to a binary large object. It returns an integer that identifies the byte offset of the byte that occurs after the end of the data that this method writes. If it writes data at the end of the BLOB, then this integer identifies the size of the BLOB.

You can write code that adds data at any position in a BLOB. The data length is variable. This method does not pad each data element with null values as a way to make every data element a uniform length. The exact length depends on the CPU. Thirty two bytes is a common length.

For more information, see Usage of the Term Put.

Format A

Blob.put(blobVar[, offset], data, dataType)

Format B

Blob.put(blobVar[, offset], buffer, bufferLen)

Format C

Blob.put(blobVar[, offset], srcStruct, blobDescriptor dataDefinition)

To pass the contents of an existing BLOB that resides in the srcStruct argument to the blobVar argument, you can use format C.

Arguments

Table 47 describes the arguments for the Write BLOB Data method.

Example

Assume you send a data pointer to an external C library. Assume the library expects data in the following packed C structure:

struct foo
{
   signed char a;
   unsigned int b;
   double c;
};

The following example creates a structure from three corresponding variables and returns the offset of the next available byte:

function BuildFooBlob(a, b, c)
{
   var offset = Blob.put(foo, 0, a, SWORD8);
   offset = Blob.put(foo, offset, b, UWORD16);
   Blob.put(foo, offset, c, FLOAT64);
   return foo;
}

The following example creates a structure from three corresponding variables but does not include an offset:

functionBuildFooBlob(a, b, c)
{
   Blob.put(foo, a, SWORD8);
   Blob.put(foo, b, UWORD16);
   Blob.put(foo, c, FLOAT64);
   return foo;
}