BLOB to real

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 6.0


BLOB to real (blob; realFormat{; offset}) Real

ParameterTypeDescription
blobBLOBBLOB from which to get the Real value
realFormatNumber0  Native real format
1  Extended real format
2   Macintosh Double real format
3   Windows Double real format
offsetVariableOffset within the BLOB (expressed in bytes)
New offset after reading
Function resultRealReal value

Description

The BLOB to real command returns a Real value read from the BLOB blob.

The realFormat parameter fixes the internal format and byte ordering of the Real value to be read. You pass one of the following predefined constants provided by 4th Dimension:

ConstantTypeValue
Native real formatLong Integer0
Extended real formatLong Integer1
Macintosh double real formatLong Integer2
PC double real formatLong Integer3

Note regarding Platform Independence: If you exchange BLOBs between Macintosh and PC platforms, it is up to you to manage real formats and byte swapping issues while using this command.

If you specify the optional offset variable parameter, the Read value is read at the offset (starting from zero) within the BLOB. If you do not specify the optional offset variable parameter, the first 8 or 10 bytes of the BLOB are read.

Note: You should pass an offset value between 0 (zero) and the size of the BLOB minus 8 or 10. If you do not do so, an error -111 is generated.

After the call, the variable is incremented by the number of bytes read. Therefore, you can reuse that same variable with another BLOB reading command to read another value.

Example

The following example reads 20 Real values from a BLOB, starting at the offset 0x200:

   $vlOffset:=0x200
   For ($viLoop;0;19)
      $vrValue:=BLOB to real(vxSomeBlob;PC byte ordering;$vlOffset)
         ` Do something with $vrValue
   End for

See Also

BLOB to integer, BLOB to longint, BLOB to text, INTEGER TO BLOB, LONGINT TO BLOB, REAL TO BLOB, TEXT TO BLOB.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next