dotSCAD/docs/lib3x-flat.md

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.
• depth : Default to 1. The depth level specifying how deep a nested list should be flattened.

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]
);