# componentsJoined(by:) Constructs and returns an `NSString` object that is the result of interposing a given separator between the elements of the array. ``` func componentsJoined(by separator: String) -> String ``` ## Parameters `separator` The string to interpose between the elements of the array. ## Return Value An `NSString` object that is the result of interposing `separator` between the elements of the array. If the array has no elements, returns an `NSString` object representing an empty string. ## Discussion For example, this code excerpt writes “`here be dragons`” to the console: ```objc NSArray *pathArray = [NSArray arrayWithObjects:@"here", @"be", @"dragons", nil]; NSLog(@"%@",[pathArray componentsJoinedByString:@" "]); ``` ### Special Considerations Each element in the array must handle `description`. ## See Also [`- componentsSeparatedByString:`](/documentation/Foundation/NSString/components(separatedBy:)-238fy) Returns an array containing substrings from the receiver that have been divided by a given separator. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)