Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter FiveGeneral Functions (continued)

RealizedToNative Function

Overview

The RealizedToNative function translates a non-tabbed position to a native tabbed position.

Syntax/Parameters

Syntax

int = RealizedToNative ( string reference | [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.

position

An int specifying the zero-based character position to translate.

Return Value

Returns an int as the translated position or a formatted error code on failure.

Remarks

The RealizedToNative 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