  |
GoFiler Legato Script Reference
Legato v 1.5d Application v 5.25a
|
| Table of Contents | < < Previous | Next >> |
Chapter Five — General Functions (continued)
Overview
The NativeToRealized function translates a tabbed position to a realized position.
Syntax/Parameters
Syntax
int = NativeToRealized ( string reference, int position, [int tab_stops] );
int = NativeToRealized ( handle hMappedText, int line, int position );
Parameters
reference
A source string containing the data to use as a reference for translation. The source cannot exceed 1,048,575 characters in size. When reference is used, hMappedText and line cannot be used.
hMappedText
A handle to a Mapped Text or Edit Object to use to source the reference string. When used, reference cannot be supplied and line must be supplied.
line
An int specifying a valid zero-based line position for the reference string within the Mapped Text Object. This parameter is only used with a Mapped Text Object.
position
An int specifying the zero-based character position to translate.
tab_stops
An optional int specifying the size/stop position of tab characters. By default this value is 8 characters. This parameter may only be used with the reference parameter.
Return Value
Returns an int as the translated position or a formatted error code on failure.
Remarks
The NativeToRealized function scans the string and creates a native position based on the number of characters/tabs and their fill characters. When used with a Mapped Text Object, the expansion is performed automatically. To use a string, the ExpandTabs function must be called on the string prior to performing the translation.
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.