  |
GoFiler Legato Script Reference
Legato v 1.5d Application v 5.25a
|
| Table of Contents | < < Previous | Next >> |
Chapter Eighteen — DataView Integration (continued)
Overview
The DataViewPreallocate function allows the caller for preallocate various memory areas within the underlying Data Sheet to improve import or insert performance.
Syntax/Parameters
Syntax
int = DataViewPreallocate ( handle object, int pool, [int cells],
[int rows], [int cols]));
Parameters
object
A handle either to a Data View Object or to a window that employs Data View.
pool
An int specifying an amount of bytes to increase the size of the data string pool. If the incoming data will be string heavy, use this value to force more space to be allocated. To not adjust the size, set the value to zero (0).
cells
An optional int specifying an amount of records to increase the cell data array. If the incoming data will be cell heavy, use this value to force more space to be allocated. A rule of thumb is to multiply the number of expected cells by the the number of expected rows. To not adjust the size, set the value to zero (0).
rows
An optional int specifying an amount of row to increase the row array. If the incoming data will be row heavy, use this value to force more space to be allocated. To not adjust the size, set the value to zero (0).
cols
An optional int specifying an amount of columns to increase the column array. If the incoming data will be column heavy, use this value to force more space to be allocated. To not adjust the size, set the value to zero (0).
Return Value
An int as ERROR_NONE or a formatted error code on failure. Use the GetLastError function to determine the nature of the error.
Remarks
This function is useful to improve performance when the number of cells starts to grow in excess of 100,000. Overallocating has the adverse effect of simply wasting memory.
Related Functions
Platform Support
Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL
| 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.