2020-03-31 07:35:10 +08:00
|
|
|
# flat
|
|
|
|
|
|
|
|
|
|
returns a new list with all sub-list elements concatenated into it recursively up to the specified depth.
|
|
|
|
|
|
|
|
|
|
**Since:** 2.3
|
|
|
|
|
|
|
|
|
|
## Parameters
|
|
|
|
|
|
|
|
|
|
- `lt` : The original list.
|
2021-02-10 14:53:04 +08:00
|
|
|
- `depth` : Default to 1. The depth level specifying how deep a nested list should be flattened.
|
2020-03-31 07:35:10 +08:00
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
use <util/flat.scad>;
|
|
|
|
|
|
|
|
|
|
vt = [[[[1, 2], [3, 4]], [[5, 6], [7, 8]]]];
|
|
|
|
|
|
|
|
|
|
assert(
|
|
|
|
|
flat([1, 2, [3, 4]]) ==
|
|
|
|
|
[1, 2, 3, 4]
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
assert(
|
|
|
|
|
flat([[1, 2], [3, 4]]) ==
|
|
|
|
|
[1, 2, 3, 4]
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
assert(
|
|
|
|
|
flat([[[[1, 2], [3, 4]], [[5, 6], [7, 8]]]]) ==
|
|
|
|
|
[[[1, 2], [3, 4]], [[5, 6], [7, 8]]]
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
assert(
|
|
|
|
|
flat([[[[1, 2], [3, 4]], [[5, 6], [7, 8]]]], 2) ==
|
|
|
|
|
[[1, 2], [3, 4], [5, 6], [7, 8]]
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
assert(
|
|
|
|
|
flat([[[[1, 2], [3, 4]], [[5, 6], [7, 8]]]], 3) ==
|
|
|
|
|
[1, 2, 3, 4, 5, 6, 7, 8]
|
|
|
|
|
);
|
