Ets_State_Block_Double_Read()
Note: Requires OPNET Development Kit
Abstract
Read double value from cross-platform block storage.
Syntax
Ets_State_Block_Double_Read (block_hndl, dbl_ptr)
| Argument | Type | Description |
|---|---|---|
block_hndl |
EtsT_State_Block_Handle |
Handle to block of cross-platform data |
dbl_ptr |
double * |
Pointer to variable where read value is stored |
Return Type
EtsT_Compcode
EtsC_Compcode_Success if read operation was successful, EtsC_Compcode_Failure otherwise.
Header
ets_pstate.h
Details
Blocks provide an abstraction away from a raw file. A block can be thought of as if it were a piece of a file (but there are no seek functions). Data stored via blocks is cross-platform: this means that writing a double to a block on a Windows platform reads in correctly when running on a Linux platform.
Read will return EtsC_Compcode_Failure in any of the following situations:
- there is no more data left in the block
- the pointer for the target variable is null
- the block handle is invalid
If there was a failure, a recoverable error will be issued.
There are no seek functions; however, the block will (likely) be cached in memory.