This function returns a word i16 read from a buffer at the specified offset.
Syntax |
i16 get_i16 (buff, i32 offset) |
---|---|
buff |
Can be an array, structure, or register |
offset |
Offset in bytes to which you want to read |
Result |
Returns the value read |
Validity |
Rule, Task |
Note |
No range check is performed, it is up to the user to check that adding the offset and the data size does not exceed the maximum buffer size |
NOTE: If the user wishes to extract a word from the buffer of a structure of type bbc_msguser then he must use the function bcc_get_i16().
Example usage: Once you have loaded the example program on a control, via a shell you can verify the functioning of get_i16(). To do this, set a value ((0-:-127) - sizeof(my_data)) to the offset variable, then set a non-zero value to the set_val variable and verify that the my_data variable is equal to set_val. |