Structures and Enums
StrExtArgs_typ
This structure contains an array of four booleans, integers, strings, and reals. These values can be used in the error string by adding a ‘%’ and the corresponding letter. The error string will be populated with the first member of the array and then will count up based on the error string.
| Direction | Name | Type | Description |
|---|---|---|---|
| In | r | REAL[0..4] | An array of 5 REAL values that can be used to add more description to the logbook entry |
| In | s | UDINT[0..4] | An array of 5 UDINT pointing to strings that can be used to add more description to the logbook entry |
| In | b | BOOL[0..4] | An array of 5 BOOL values that can be used to add more description to the logbook entry |
| In | i | DINT[0..4] | An array of 5 DINT values that can be used to add more description to the logbook entry |
Errors/Status
Enumerate possible errors that can occur, their ID’s, and explain them.
| Name | Value | Description |
|---|---|---|
| STREXT_ERR_INVALID_INPUT | -1 | Invalid input, such as a null pointer |
| STREXT_ERR_INVALID_FORMAT | -2 | String is not a valid literal of the expected form Sincev1.1.0 |
| STREXT_ERR_RANGE | -3 | Value does not fit in the destination type Sincev1.1.0 |
| STREXT_ERR_BUFFER_TOO_SMALL | -4 | Destination buffer is too small for the result Sincev1.1.0 |
STREXT_HEXPREFIX_enum
Sincev1.1.0
Selects the notation used by UDINTToHexString.
| Name | Value | Result for 255 |
|---|---|---|
| STREXT_HEXPREFIX_NONE | 0 | FF |
| STREXT_HEXPREFIX_0X | 1 | 0xFF |
| STREXT_HEXPREFIX_IEC | 2 | 16#FF |
| STREXT_HEXPREFIX_DOLLAR | 3 | $FF |