Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## GET-STRING function

> Returns the null-terminated character string at the specified memory location as a CHARACTER value (not including the null terminator) or the number of bytes specified starting from the specified memory location as a CHARACTER value.

> #### Syntax

>     GET-STRING ( source , position [ , numbytes ] )

> ``source``

> A function or variable that returns a RAW or MEMPTR value. If `source` is the Unknown value (`?`), GET-STRING 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`, Progress returns the Unknown value (`?`). If `position` is less than 1, Progress generates a run-time error.

> ``numbytes``

> An integer value greater than 0 that indicates how many bytes to convert into the CHARACTER value that is returned. If `position` plus `numbytes` is greater than the length of `source`, Progress returns the Unknown value (`?`). If `numbytes` is not specified, or is -1, GET-STRING( ) returns all bytes until it encounters a NULL value.

> Examples

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

> #### Notes

> - For more information on using the MEMPTR data type, see OpenEdge Development: Programming Interfaces .

> - For more information on using the RAW data type, see OpenEdge Development: Programming Interfaces .

> #### See also

> LENGTH function, PUT-STRING statement, RAW function, RAW statement, SET-SIZE statement

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