`ARRAY::FLAT` 1g 2023-11-23 laplante@plcb.ca GOWEB/ARRAY — Flatten an Array

title: “ARRAY::FLAT” version: “1g” date: 2023-11-23 author: “laplante@plcb.ca”

category: “GOWEB/ARRAY”

array::flat Flatten an Array

array::flat(expression[, deep: bool, error: id])
flat(expression[, deep: bool, error: id])

The flat function takes one or more arrays and flattens them into a single array.

deep (default: true) — if true, nested arrays are recursively flattened.
If false, only the top-level is flattened.
error — optional variable to catch any errors.

res={{
    flat([1, "2", 3.0], 5, "6", 7.0, null, true, false, {"x" : [ [1],2 ]});
}}.

Returns:

[1,"2",3,5,"6",7,null,true,false,{"x":[1,2]}]

res={{
    flat(deep: true, [1, "2", 3.0], 5, "6", 7.0, null, true, false, {"x" : [ [1],2 ]});
}}.

Returns:

[1,"2",3,5,"6",7,null,true,false,{"x":[1,2]}]

res={{
    x := [ [1,2], [3,4], [5,6] ];
    x; "\n";
    flat(x); "\n";
    x := [ [[1],[2]], [3,4], [5,6] ];
    x; "\n";
    flat(x); "\n";
}}.

Returns:

[[1,2],[3,4],[5,6]]
[1,2,3,4,5,6]
[[[1],[2]],[3,4],[5,6]]
[1,2,3,4,5,6]

res={{
    flat(deep: false, [1, "2", 3.0], 5, "6", 7.0, null, true, false, {"x" : [ [1],2 ]});
}}.

Returns:

[1,"2",3,5,"6",7,null,true,false,{"x":[[1],2]}]

laplante@plcb.ca