Memory_Copy

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Core Language > BuiltIn Functions > Memory handling and pointers >

Memory_Copy

 

Description

 

Copy a memory area from one starting address to a destination address.

 

Syntax

 

s = Memory_Copy(SourceAddress, DestinationAddress, Size)

 

Returns

 

String: a copy of the memory area involved into copy operation

 

Parameters

 

Name

Type

Optional

Meaning

SourceAddress

Numeric

No

A valid 32-bit memory address specifying the location in memory where data retrieval should begin

DestinationAddress

Numeric

No

A valid 32-bit memory address specifying the location in memory where data destination will take place

Size

Numeric

Yes

A numeric expression that specifies the number of consecutive bytes to be read from string buffer.

If omitted, the full string buffer will be considered

 

Remarks

 

Attention:it is programmer responsibility to be sure that at source and destination addresses there are at least Size bytes already allocated otherwise application will crash with a GPF (General Protection Failure) runtime error will be fired by the operating system

 

Restrictions

 

See also

 

Examples