Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.4j

Application v 5.22b

  

 

Chapter FiveGeneral Functions (continued)

DataObjectInsertSection Function

Overview

The DataObjectInsertSection function inserts a zero section of memory from a Data Object.

Syntax/Parameters

Syntax

int = DataObjectInsertSection ( handle hData, int position, int size );

Parameters

hData

A handle specifying the Data Object.

position

An int specifying the zero-based position to insert space from in bytes.

size

An int specifying the size of the area to insert in bytes.

Return Value

Returns an int specifying the revised size of the Data Object or zero on failure. Use the GetLastError function to retrieve a formatted error code. Note that the delete operation can delete all the data and return zero without an error.

Remarks

Memory is shifted to the right (or down) to insert the area. The end position, or size, is adjusted to reflect the shift and the inserted area is zeroed. If allocation is required, the insert operation automatically adjusts the size of the object.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic