Progress
Language Reference


PUT-BYTES Statement

Interfaces
OS
SpeedScript
All
All
Yes

Copies a RAW or MEMPTR variable to the specified location in another RAW or MEMPTR variable.

SYNTAX

PUT-BYTES ( destination , position ) = expression 

destination

An expression that returns a target RAW or MEMPTR variable. If destination is the UNKNOWN value, PUT-BYTES does nothing.

position

An integer value greater than 0 that indicates the byte position where you want to put the data. If position is less than 1, Progress generates a runtime error.

For a RAW variable, if position is greater than the length of destination, Progress increases the length of destination to position plus the remaining bytes needed to store expression. The gap between the original destination length and position is padded with null bytes.

For a MEMPTR variable, if position is greater than the length of destination or does not leave sufficient room to store expression, Progress generates a runtime error. If destination is a RAW and position plus the length of expression is greater than 32K, Progress generates a runtime error.

expression

An expression that returns a RAW or MEMPTR variable.

SEE ALSO

GET-BYTES Function, LENGTH Function, LENGTH Statement (ORACLE only), RAW Function (ORACLE only), RAW Statement (ORACLE only), SET-SIZE Statement


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