Returns observations of a given id range in observs. The argument
after_id is the id of the observation after which the range
starts, before_id the id of the observation that limits the range.
The function returns the following error codes:
E_ALLOC if memory allocation failed.E_INVALID if observations of given ids are not related.E_DB_BIND if value binding failed.E_DB_DONE if statement finished.E_DB_FINALIZE if statement finalisation failed.E_DB_NO_ROWS if no rows are returned.E_DB_PREPARE if statement preparation failed.E_DB_STEP if step execution failed.E_DB_TYPE if returned columns are unexpected.| Type | Intent | Optional | Attributes | Name | ||
|---|---|---|---|---|---|---|
| type(db_type), | intent(inout) | :: | db |
Database type. |
||
| type(observ_type), | intent(out), | allocatable | :: | observs(:) |
Returned observation data. |
|
| character(len=*), | intent(in) | :: | after_id |
Id of observation with timestamp before first of range. |
||
| character(len=*), | intent(in), | optional | :: | before_id |
Id of observation with timestamp after last of range. |
|
| integer(kind=i8), | intent(in), | optional | :: | limit |
Max. number of observations. |
|
| logical, | intent(in), | optional | :: | stub |
Without receivers, requests, responses. |
|
| integer(kind=i8), | intent(out), | optional | :: | nobservs |
Total number of observations (may be greater than limit). |