GET-UNSIGNED-SHORT function

Returns the unsigned 16-bit value at the specified memory location as an INTEGER value.

Syntax

GET-UNSIGNED-SHORT ( source , position )

source

A function or variable that returns a RAW or MEMPTR value. If source is the Unknown value (?), GET-UNSIGNED-SHORT returns the Unknown value (?).

position

An integer value greater than 0 that indicates the byte position where you want to find the information. If position is greater than the length of source, the AVM returns the Unknown value (?). If position is less than 1, the AVM generates a run-time error.

Examples

For examples of how to use the GET-UNSIGNED-SHORT function, see the GET-BYTE function reference entry.

Notes

This function supports byte-swapping only if source is a MEMPTR data type. The function will first examine the byte-order setting of the MEMPTR and then swap the bytes appropriately before interpreting them. The AVM does not swap the bytes in the MEMPTR’s memory, but does the byte-swap as it creates the return value.
For more information on using the MEMPTR and RAW data types, see OpenEdge Development: Programming Interfaces.

See also

LENGTH function, PUT-SHORT statement, RAW function, RAW statement, SET-SIZE statement

OpenEdge Release 10.2B

Copyright © 2009 Progress Software Corporation