Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.4j

Application v 5.22b

  

 

Chapter FiveGeneral Functions (continued)

SkipBackWordSpaces Function

Overview

The SkipBackWordSpaces function scans a string backwards from a specified position until either a non-space is found or the beginning of the string is reached.

Syntax/Parameters

Syntax

int = SkipBackWordSpaces ( string data, int index );

Parameters

data

A string.

index

An int containing the zero-based starting index position. If the index exceeds the zero terminate end of string, it is automatically set to the end of the string.

Return Value

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

Remarks

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