Returns the concatenated elements of this sequence of sequences, inserting the given separator between each element.
SDK
- Xcode 8.0+
Framework
- Swift Standard Library
Declaration
func joined<Separator>(separator: Separator) -> Joined Sequence<Self> where Separator : Sequence, Separator.Element == Self.Element.Element
Available when Element conforms to Sequence.
Parameters
separatorA sequence to insert between each of this sequence’s elements.
Return Value
The joined sequence of elements.
Discussion
This example shows how an array of [Int] instances can be joined, using another [Int] instance as the separator:
let nestedNumbers = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]
let joined = nestedNumbers.joined(separator: [-1, -2])
print(Array(joined))
// Prints "[1, 2, 3, -1, -2, 4, 5, 6, -1, -2, 7, 8, 9]"