Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter EightData Functions (continued)

ImplodeArray Function

Overview

The ImplodeArray function assembles an array of strings into a single string.

Syntax/Parameters

Syntax

string = ImplodeArray ( string[] array, [string glue] );

Parameters

array

A single-dimension array of strings.

glue

An optional string that is used to attach each segment. If the glue is omitted, the default is “\r\n” for de facto Windows line endings. Note that certain functions, such as writing a segment to a Mapped Text Object, accept single return characters “\r”. The maximum size of the glue string is 1024 characters.

Return Value

Returns a string containing the assembled array.

Remarks

The ImplodeArray function is essentially the opposite of the ExplodeString function. It assembles a string based on array elements with the glue string as a delimiter. Like the ExplodeString function, the ImplodeArray function is not sensitive to protected or encapsulated data. For example, if one of the source array entries contains the glue pattern, the function simply connects the elements without any additional actions. Therefore, if the source array has 50 elements, two of which contain “\r\n”, and the string is re-exploded, the resulting array will have 52 elements.

Related Functions

Platform Support

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

Legato IDE, Legato Basic