  |
GoFiler Legato Script Reference
Legato v 1.5b Application v 5.24b
|
| Table of Contents | < < Previous | Next >> |
Chapter Five — General 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
| Table of Contents | < < Previous | Next >> |
© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.