Try OpenEdge Now
skip to main content
ABL Reference
ABL Syntax Reference : SET-BYTE-ORDER statement
 

SET-BYTE-ORDER statement

Sets an internal indicator designating the byte-order of the data pointed to by the MEMPTR variable.
Note: Does not apply to SpeedScript programming.

Syntax

SET-BYTE-ORDER( memptr ) = integer-expression
memptr
An expression that returns a MEMPTR.
integer-expression
An expression that returns an integer value that will be used to indicate the byte-ordering of the data in the memory to which the MEMPTR points. integer-expression must be one of the reserved keywords defined in the following table or its corresponding value. If integer-expression is not valid, ABL generates an error.
Table 62. Byte order options
Keyword
Value
Description
HOST-BYTE-ORDER
1
Same format as the machine where the process that calls SET-BYTE-ORDER is running.
BIG-ENDIAN
2
A multiple-byte data type is stored with the high-order byte in the lowest address reserved for the data; successively lower-order bytes are stored at successively higher addresses. Note that Internet protocols use BIG-ENDIAN byte-ordering.
LITTLE-ENDIAN
3
A multiple-byte data type is stored with the low-order byte in the lowest address reserved for the data; successively higher-order bytes are stored at successively higher addresses.

Notes

*The byte order for a MEMPTR is HOST-BYTE-ORDER by default, that is, if SET-BYTE-ORDER has not been called for a given MEMPTR, its byte order is HOST-BYTE-ORDER.
*SET-BYTE-ORDER by itself never affects data currently in the MEMPTR, that is, it does not actually re-order the data. It only affects how subsequent calls to the PUT- statements and GET- functions work with that MEMPTR variable.

See also

GET-BYTE-ORDER function