Gets the address of an element with a format.
a0tError | a0GetElementOffset( | | | |
| | a0tFormat | *format, | |
| | void | *address, | |
| | int | count, | |
| | void | **offset );
| |
| Name | rd/wr | Description |
| format | read | Format to use. |
| address | write | Address of the beginning of the data. |
| count | read | Number of the element. |
| offset | write | Address of the element. |
This function is used to calculate the address of an element inside formatted data. The address of the wanted element is found by skipping count elements of format format, from the starting address address.
This function is used to successively send or pack parts of formatted data. It allows the program to calculate the memory address of the data existing just after the amount sent or packed.
On return of this function, the variable pointed by offset contains the address of the given element with a format.
| Error Code | Description |
A0ErrOk| Successful completion. | |
a0UseFormats() a0NewMapFormat() a0NewFunctionFormat()