Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.4j

Application v 5.22b

  

 

Chapter FiveGeneral Functions (continued)

SkipToWordSpace Function

Overview

The SkipToWordSpace function scans a string forwards from a specified position until either a word space character is found or the end of the string is reached. 

Syntax/Parameters

Syntax

int = SkipToWordSpace ( string data, [int index] );

Parameters

data

A string.

index

An int containing the zero-based starting index position. If omitted, the function starts at 0.

Return Value

Returns an int containing the zero-based index of the first word space character encountered forwards from position index or -1 on failure. Use the GetLastError function to retrieve error information.

Remarks

The SkipToWordSpace function (and other skip functions) can be used to manually parse or scan a string for information. Word spaces are counted as spaces (0x20/32), carriage returns (0x0D/13), newlines (0x0A/10), tabs (0x09/9), tab placeholders/backspaces (0x08/8), and form feeds (0x0C/12).

If the index parameter contains a negative number, the GetLastError function will return ERROR_RANGE. If a word space character cannot be found, the GetLastError function will return ERROR_EOD.

Related Functions

Platform Support

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

Legato IDE, Legato Basic