ArrayToString (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ArrayToString (Function)

In french: TableauVersChaîne

Converts a one-dimensional array or a two-dimensional array into a character string.

Remark: This function can only be used on the WLanguage arrays.

Versions 21 and later

This function is now available in browser code.

New in version 21

This function is now available in browser code.

Example

// One-dimensional array
sMyValues is string
// Initial array
MyArray is array of 3 strings
MyArray[1] = "A"
MyArray[2] = "B"
MyArray[3] = "C"
sMyValues = ArrayToString(MyArray)
// sMyValues contains: "A" + CR + "B" + CR + "C"

// Two-dimensional array
sMyValues is string
// Initial array
MyArray is array of 2 by 3 strings
MyArray[1,1] = "A"; MyArray[1,2] = "B"
MyArray[1,3] = "C"; MyArray[2,1] = "D"
MyArray[2,2] = "E"; MyArray[2,3] = "F"

sMyValues = ArrayToString(MyArray)
// sMyValues contains: "A" + TAB + "B" + TAB + "C" +CR+ "D" + TAB + "E" + TAB + "F"

Syntax

Converting a one-dimensional array Hide the details

<Result> = ArrayToString(<WLanguage array> [, <Element separator>])

<Result>: Character string

Character string containing the different values found in the array. The array elements are converted into character strings and added to the string while being separated by the <Element separator>.

<WLanguage array>: Array variable

Name of the one-dimensional array that must be converted into a character string. This array must be created

<Element separator>: Optional character string (with quotes)

Separator used to separate the values of the different array elements. The element separator used by default is the CR character (Carriage Return).

Converting a two-dimensional array Hide the details

<Result> = ArrayToString(<WLanguage array> [, <Row separator> [, <Column separator>]])

<Result>: Character string

Character string containing the different values found in the array. The array elements are converted into character strings and added to the string. The rows are separated by <Row separator> and the columns are separated by <Column separator>.

<WLanguage array>: Array variable

Name of the two-dimensional array that must be converted into a character string. This array must be created

<Row separator>: Optional character string (with quotes)

Separator used to separate the values of the different rows. The row separator used by default is the CR character (Carriage Return).

<Column separator>: Optional character string (with quotes)

Separator used to separate the values of different columns. The column separator used by default is TAB.

Remarks

The structure arrays supported are the one-dimensional arrays only. In this case, the order of parameters defines the order in the result string.
The arrays containing UNICODE strings or variants are not supported.
For the Duration type, the value is converted into thousands of a second.

Component : wd250vm.dll