Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## GET-BYTES function

> Returns the specified number of bytes, from the specified location, into a RAW or MEMPTR variable.

> #### Syntax

>     GET-BYTES( source , position , numbytes )

> ``source``

> An expression that evaluates to a RAW or MEMPTR value that indicates the source location. If `source` is the Unknown value (`?`), GET-BYTES returns the Unknown value (`?`).

> ``position``

> An integer value greater than 0 that indicates the byte position of the first byte to get. If `position` is greater than the length of `source`, Progress returns the Unknown value (`?`). If `position` is less than 1, Progress generates a runtime error.

> ``numbytes``

> An integer value greater than 0 that indicates how many bytes to return as a RAW value. If `position` plus `numbytes` is greater than the size of `source`, Progress returns the Unknown value (`?`).

> If the variable that accepts the returned data is a RAW variable and `numbytes` is greater than its length but less than or equal to 32K, Progress increases the size of the variable to `numbytes`.

> If either the source location, `source`, or the variable that accepts the returned data is a RAW value, and `numbytes` is greater than 32K, Progress generates a runtime error.

> If the variable that accepts the returned data is a MEMPTR variable and `numbytes` is greater than its length, Progress generates a runtime error.

> #### See also

> PUT-BYTES statement

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095