823

Say I have a string here:

var fullName: String = "First Last"

I want to split the string base on white space and assign the values to their respective variables

var fullNameArr = // something like: fullName.explode(" ") 

var firstName: String = fullNameArr[0]
var lastName: String? = fullnameArr[1]

Also, sometimes users might not have a last name.

4
  • 16
    Hi, i dont have my Mac to check. But you can try 'fullName.componentsSeparatedByString(string:" ")' Dont copy and paste, use the autocompletefunction, so you get the right function. Sep 5, 2014 at 4:08
  • If you are only splitting by one character, using fullName.utf8.split( <utf-8 character code> ) works as well (replace .utf8 with .utf16 for UTF-16). For example, splitting on + could be done using fullName.utf8.split(43)
    – Jojodmo
    Dec 25, 2015 at 7:41
  • Also, sometimes last names have spaces in them, as in "Daphne du Maurier" or "Charles de Lint"
    – Berry
    Jul 27, 2017 at 16:45

41 Answers 41

1193

Just call componentsSeparatedByString method on your fullName

import Foundation

var fullName: String = "First Last"
let fullNameArr = fullName.componentsSeparatedByString(" ")

var firstName: String = fullNameArr[0]
var lastName: String = fullNameArr[1]

Update for Swift 3+

import Foundation

let fullName    = "First Last"
let fullNameArr = fullName.components(separatedBy: " ")

let name    = fullNameArr[0]
let surname = fullNameArr[1]
11
  • 4
    Be noted that this is actually an underlying NSString (Swift automatically swaps them when importing Foundation).
    – Can
    May 31, 2015 at 9:06
  • 2
    Which is no longer the case in Swift 1.2, in which Apple no longer converts Swift's String into NSString automagically.
    – elcuco
    Jun 17, 2015 at 14:02
  • 8
    This answer works in Xcode 7 beta 4 and Swift 2.0. Xcode now auto-completes Foundation methods on Swift String objects without type casting to an NSString, which is not the case in Xcode 6.4 with Swift 1.2.
    – Andrew
    Jul 21, 2015 at 22:31
  • 1
    It didn't work in the REPL until I imported Foundation. Oct 6, 2015 at 13:10
  • 1
    This works exactly as expected (i.e. fullNameArr is an [String]) in Xcode 7.2.
    – Jon Cox
    Jan 27, 2016 at 14:23
830

The Swift way is to use the global split function, like so:

var fullName = "First Last"
var fullNameArr = split(fullName) {$0 == " "}
var firstName: String = fullNameArr[0]
var lastName: String? = fullNameArr.count > 1 ? fullNameArr[1] : nil

with Swift 2

In Swift 2 the use of split becomes a bit more complicated due to the introduction of the internal CharacterView type. This means that String no longer adopts the SequenceType or CollectionType protocols and you must instead use the .characters property to access a CharacterView type representation of a String instance. (Note: CharacterView does adopt SequenceType and CollectionType protocols).

let fullName = "First Last"
let fullNameArr = fullName.characters.split{$0 == " "}.map(String.init)
// or simply:
// let fullNameArr = fullName.characters.split{" "}.map(String.init)

fullNameArr[0] // First
fullNameArr[1] // Last 
18
  • 104
    In my tests, componentsSeparatedByString is usually significantly faster, especially when dealing with strings that require splitting into many pieces. But for the example listed by the OP, either should suffice. Nov 25, 2014 at 13:58
  • 10
    As of Xcode 6.2b3 split can be used as split("a:b::c:", {$0 == ":"}, maxSplit: Int.max, allowEmptySlices: false).
    – Pascal
    Jan 7, 2015 at 15:46
  • 15
    Just remember that you still need to use the old componentsSeparatedByString() method if your separator is anything longer than a single character. And as cool as it would be to say let (firstName, lastName) = split(fullName) {$0 == ' '}, that doesn't work, sadly.
    – NRitH
    Feb 17, 2015 at 18:29
  • 3
    @Kashif then you could use split("a,b;c,d") {$0 == "," || $0 == ";"} or split("a,b;c,d") {contains(",;", $0)}
    – Ethan
    May 20, 2015 at 5:04
  • 4
    Correct code for Xcode 7.0 is let fullNameArr = fullName.characters.split{$0 == " "}.map(String.init). Tried to edit, but it got rejected.
    – skagedal
    Sep 22, 2015 at 19:35
212

The easiest method to do this is by using componentsSeparatedBy:

For Swift 2:

import Foundation
let fullName : String = "First Last";
let fullNameArr : [String] = fullName.componentsSeparatedByString(" ")

// And then to access the individual words:

var firstName : String = fullNameArr[0]
var lastName : String = fullNameArr[1]

For Swift 3:

import Foundation

let fullName : String = "First Last"
let fullNameArr : [String] = fullName.components(separatedBy: " ")

// And then to access the individual words:

var firstName : String = fullNameArr[0]
var lastName : String = fullNameArr[1]
4
  • Is this documented anywhere, Maury? What if I need to split on something other than a single character?
    – NRitH
    Feb 17, 2015 at 18:30
  • 13
    @NRitH consider .componentsSeparatedByCharactersInSet(.whitespaceAndNewlineCharacterSet())
    – rmp251
    May 13, 2015 at 22:56
  • @Crashalot there are two functions: componentsSeparatedByString and componentsSeparatedByCharactersInSet
    – rmp251
    Jul 16, 2015 at 23:43
  • @MdRais you should ask a new question, this one is 6 years old
    – Wyetro
    Jul 23, 2020 at 20:17
162

Swift Dev. 4.0 (May 24, 2017)

A new function split in Swift 4 (Beta).

import Foundation
let sayHello = "Hello Swift 4 2017";
let result = sayHello.split(separator: " ")
print(result)

Output:

["Hello", "Swift", "4", "2017"]

Accessing values:

print(result[0]) // Hello
print(result[1]) // Swift
print(result[2]) // 4
print(result[3]) // 2017

Xcode 8.1 / Swift 3.0.1

Here is the way multiple delimiters with array.

import Foundation
let mathString: String = "12-37*2/5"
let numbers = mathString.components(separatedBy: ["-", "*", "/"])
print(numbers)

Output:

["12", "37", "2", "5"]
3
  • 9
    Make sure to add import Foundation to the class you're using this in. #SavedYouFiveMinutes
    – Adrian
    Feb 6, 2017 at 23:46
  • 4
    Attention (Swift 4): If you have a string like let a="a,,b,c" and you use a.split(separator: ",") you get an array like ["a", "b", c"] by default. This can be changed using omittingEmptySubsequences: false which is true by default.
    – OderWat
    Aug 21, 2017 at 22:41
  • 2
    Any multi-character splits in Swift 4+?
    – pkamb
    Sep 7, 2018 at 0:35
81

Update for Swift 5.2 and the simpliest way

let paragraph = "Bob hit a ball, the hit BALL flew far after it was hit. Hello! Hie, How r u?"

let words = paragraph.components(separatedBy: [",", " ", "!",".","?"])

This prints,

["Bob", "hit", "a", "ball", "", "the", "hit", "BALL", "flew", "far", "after", "it", "was", "hit", "", "Hello", "", "Hie", "", "How", "r", "u", ""]

However, if you want to filter out empty string,

let words = paragraph.components(separatedBy: [",", " ", "!",".","?"]).filter({!$0.isEmpty})

Output,

["Bob", "hit", "a", "ball", "the", "hit", "BALL", "flew", "far", "after", "it", "was", "hit", "Hello", "Hie", "How", "r", "u"]

But make sure, Foundation is imported.

1
  • Note that this has different behaviour in some edge cases. For example: "/users/4" with split will result in two elements, whereas with components, there will be three, the first one being the empty string. Feb 10, 2021 at 10:23
71

Swift 4 or later

If you just need to properly format a person name, you can use PersonNameComponentsFormatter.

The PersonNameComponentsFormatter class provides localized representations of the components of a person’s name, as represented by a PersonNameComponents object. Use this class to create localized names when displaying person name information to the user.


// iOS (9.0 and later), macOS (10.11 and later), tvOS (9.0 and later), watchOS (2.0 and later)
let nameFormatter = PersonNameComponentsFormatter()

let name =  "Mr. Steven Paul Jobs Jr."
// personNameComponents requires iOS (10.0 and later)
if let nameComps  = nameFormatter.personNameComponents(from: name) {
    nameComps.namePrefix   // Mr.
    nameComps.givenName    // Steven
    nameComps.middleName   // Paul
    nameComps.familyName   // Jobs
    nameComps.nameSuffix   // Jr.

    // It can also be configured to format your names
    // Default (same as medium), short, long or abbreviated

    nameFormatter.style = .default
    nameFormatter.string(from: nameComps)   // "Steven Jobs"

    nameFormatter.style = .short
    nameFormatter.string(from: nameComps)   // "Steven"

    nameFormatter.style = .long
    nameFormatter.string(from: nameComps)   // "Mr. Steven Paul Jobs jr."

    nameFormatter.style = .abbreviated
    nameFormatter.string(from: nameComps)   // SJ

    // It can also be use to return an attributed string using annotatedString method
    nameFormatter.style = .long
    nameFormatter.annotatedString(from: nameComps)   // "Mr. Steven Paul Jobs jr."
}

enter image description here

edit/update:

Swift 5 or later

For just splitting a string by non letter characters we can use the new Character property isLetter:

let fullName = "First Last"

let components = fullName.split{ !$0.isLetter }
print(components)  // "["First", "Last"]\n"
2
  • 4
    @DarrellRoot you just need to map the substrings fullName.split { $0.isWhitespace }.map(String.init)
    – Leo Dabus
    Jul 18, 2019 at 3:13
  • 2
    I love that new API but keep in mind it returns Substrings. I needed Strings (and wanted to split on whitespace in general) so I did this: let words = line.split{ $0.isWhitespace }.map{ String($0)} Thanks @LeoDabus for your version (my original comment had code missing). Also I suggest moving the Swift 5 version to the top of the answer. Jul 18, 2019 at 5:19
58

As an alternative to WMios's answer, you can also use componentsSeparatedByCharactersInSet, which can be handy in the case you have more separators (blank space, comma, etc.).

With your specific input:

let separators = NSCharacterSet(charactersInString: " ")
var fullName: String = "First Last";
var words = fullName.componentsSeparatedByCharactersInSet(separators)

// words contains ["First", "Last"]

Using multiple separators:

let separators = NSCharacterSet(charactersInString: " ,")
var fullName: String = "Last, First Middle";
var words = fullName.componentsSeparatedByCharactersInSet(separators)

// words contains ["Last", "First", "Middle"]
3
  • 3
    Most useful answer in my view, since you might want to allow separation of strings with , or ; or any other separator
    – Chris
    Jun 4, 2015 at 13:29
  • @MdRais you can use for:in to access the individual characters in a string - note that each element is a Character
    – Antonio
    Jul 24, 2020 at 8:24
  • This should be the accepted answer. The accepted answers don't split by whitespace, they only split by the space character.
    – Sam
    Mar 21 at 15:46
51

Swift 4

let words = "these words will be elements in an array".components(separatedBy: " ")
1
  • Try converting the word to a char data type.
    – Bobby
    Jul 24, 2020 at 4:17
40

The whitespace issue

Generally, people reinvent this problem and bad solutions over and over. Is this a space? " " and what about "\n", "\t" or some unicode whitespace character that you've never seen, in no small part because it is invisible. While you can get away with

A weak solution

import Foundation
let pieces = "Mary had little lamb".componentsSeparatedByString(" ")

If you ever need to shake your grip on reality watch a WWDC video on strings or dates. In short, it is almost always better to allow Apple to solve this kind of mundane task.

Robust Solution: Use NSCharacterSet

The way to do this correctly, IMHO, is to use NSCharacterSet since as stated earlier your whitespace might not be what you expect and Apple has provided a whitespace character set. To explore the various provided character sets check out Apple's NSCharacterSet developer documentation and then, only then, augment or construct a new character set if it doesn't fit your needs.

NSCharacterSet whitespaces

Returns a character set containing the characters in Unicode General Category Zs and CHARACTER TABULATION (U+0009).

let longerString: String = "This is a test of the character set splitting system"
let components = longerString.components(separatedBy: .whitespaces)
print(components)
1
  • 2
    Agreed. The first thing that occurred to me after seeing the answers that split by " " is: What happens if the input text contains several consecutive spaces? What if it has tabs? Full-width (CJK) space? etc. Jul 1, 2016 at 2:23
38

In Swift 4.2 and Xcode 10

//This is your str
let str = "This is my String" //Here replace with your string

Option 1

let items = str.components(separatedBy: " ")//Here replase space with your value and the result is Array.
//Direct single line of code
//let items = "This is my String".components(separatedBy: " ")
let str1 = items[0]
let str2 = items[1]
let str3 = items[2]
let str4 = items[3]
//OutPut
print(items.count)
print(str1)
print(str2)
print(str3)
print(str4)
print(items.first!)
print(items.last!)

Option 2

let items = str.split(separator: " ")
let str1 = String(items.first!)
let str2 = String(items.last!)
//Output
print(items.count)
print(items)
print(str1)
print(str2)

Option 3

let arr = str.split {$0 == " "}
print(arr)

Option 4

let line = "BLANCHE:   I don't want realism. I want magic!"
print(line.split(separator: " "))
// Prints "["BLANCHE:", "I", "don\'t", "want", "realism.", "I", "want", "magic!"]"

By Apple Documentation....

let line = "BLANCHE:   I don't want realism. I want magic!"
print(line.split(separator: " "))
// Prints "["BLANCHE:", "I", "don\'t", "want", "realism.", "I", "want", "magic!"]"

print(line.split(separator: " ", maxSplits: 1))//This can split your string into 2 parts
// Prints "["BLANCHE:", "  I don\'t want realism. I want magic!"]"

print(line.split(separator: " ", maxSplits: 2))//This can split your string into 3 parts

print(line.split(separator: " ", omittingEmptySubsequences: false))//array contains empty strings where spaces were repeated.
// Prints "["BLANCHE:", "", "", "I", "don\'t", "want", "realism.", "I", "want", "magic!"]"

print(line.split(separator: " ", omittingEmptySubsequences: true))//array not contains empty strings where spaces were repeated.
print(line.split(separator: " ", maxSplits: 4, omittingEmptySubsequences: false))
print(line.split(separator: " ", maxSplits: 3, omittingEmptySubsequences: true))
0
26

Only the split is the correct answer, here are the difference for more than 2 spaces.

Swift 5

var temp = "Hello world     ni hao"
let arr  = temp.components(separatedBy: .whitespacesAndNewlines)
// ["Hello", "world", "", "", "", "", "ni", "hao"]
let arr2 = temp.components(separatedBy: " ")
// ["Hello", "world", "", "", "", "", "ni", "hao"]
let arr3 = temp.split(whereSeparator: {$0 == " "})
// ["Hello", "world", "ni", "hao"]
0
23

Swift 4 makes it much easier to split characters, just use the new split function for Strings.

Example: let s = "hi, hello" let a = s.split(separator: ",") print(a)

Now you got an array with 'hi' and ' hello'.

1
  • Note that this do not return an array of String, but array of Substring which is awkward to use.
    – Lirik
    Feb 20, 2019 at 22:52
21

Swift 3

let line = "AAA    BBB\t CCC"
let fields = line.components(separatedBy: .whitespaces).filter {!$0.isEmpty}
  • Returns three strings AAA, BBB and CCC
  • Filters out empty fields
  • Handles multiple spaces and tabulation characters
  • If you want to handle new lines, then replace .whitespaces with .whitespacesAndNewlines
0
18

Swift 4, Xcode 10 and iOS 12 Update 100% working

let fullName = "First Last"    
let fullNameArr = fullName.components(separatedBy: " ")
let firstName = fullNameArr[0] //First
let lastName = fullNameArr[1] //Last

See the Apple's documentation here for further information.

0
14

Xcode 8.0 / Swift 3

let fullName = "First Last"
var fullNameArr = fullName.components(separatedBy: " ")

var firstname = fullNameArr[0] // First
var lastname = fullNameArr[1] // Last

Long Way:

var fullName: String = "First Last"
fullName += " " // this will help to see the last word

var newElement = "" //Empty String
var fullNameArr = [String]() //Empty Array

for Character in fullName.characters {
    if Character == " " {
        fullNameArr.append(newElement)
        newElement = ""
    } else {
        newElement += "\(Character)"
    }
}


var firsName = fullNameArr[0] // First
var lastName = fullNameArr[1] // Last
1
  • 1
    @MdRais let name = "JOHN" print(Array(name))
    – NikaE
    Jul 23, 2020 at 19:25
11

Most of these answers assume the input contains a space - not whitespace, and a single space at that. If you can safely make that assumption, then the accepted answer (from bennett) is quite elegant and also the method I'll be going with when I can.

When we can't make that assumption, a more robust solution needs to cover the following siutations that most answers here don't consider:

  • tabs/newlines/spaces (whitespace), including recurring characters
  • leading/trailing whitespace
  • Apple/Linux (\n) and Windows (\r\n) newline characters

To cover these cases this solution uses regex to convert all whitespace (including recurring and Windows newline characters) to a single space, trims, then splits by a single space:

Swift 3:

let searchInput = "  First \r\n \n \t\t\tMiddle    Last "
let searchTerms = searchInput 
    .replacingOccurrences(
        of: "\\s+",
        with: " ",
        options: .regularExpression
    )
    .trimmingCharacters(in: .whitespaces)
    .components(separatedBy: " ")

// searchTerms == ["First", "Middle", "Last"]
0
10

I had a scenario where multiple control characters can be present in the string I want to split. Rather than maintain an array of these, I just let Apple handle that part.

The following works with Swift 3.0.1 on iOS 10:

let myArray = myString.components(separatedBy: .controlCharacters)
9

I found an Interesting case, that

method 1

var data:[String] = split( featureData ) { $0 == "\u{003B}" }

When I used this command to split some symbol from the data that loaded from server, it can split while test in simulator and sync with test device, but it won't split in publish app, and Ad Hoc

It take me a lot of time to track this error, It might cursed from some Swift Version, or some iOS Version or neither

It's not about the HTML code also, since I try to stringByRemovingPercentEncoding and it's still not work

addition 10/10/2015

in Swift 2.0 this method has been changed to

var data:[String] = featureData.split {$0 == "\u{003B}"}

method 2

var data:[String] = featureData.componentsSeparatedByString("\u{003B}")

When I used this command, it can split the same data that load from server correctly


Conclusion, I really suggest to use the method 2

string.componentsSeparatedByString("")
1
  • 1
    I'd say this is close to "not an answer" status, in that it's mostly commentary on existing answers. But it is pointing out something important.
    – rickster
    Jul 29, 2015 at 19:08
9

Steps to split a string into an array in Swift 4.

  1. assign string
  2. based on @ splitting.

Note: variableName.components(separatedBy: "split keyword")

let fullName: String = "First Last @ triggerd event of the session by session storage @ it can be divided by the event of the trigger."
let fullNameArr = fullName.components(separatedBy: "@")
print("split", fullNameArr)
9

This gives an array of split parts directly

var fullNameArr = fullName.components(separatedBy:" ")

then you can use like this,

var firstName: String = fullNameArr[0]
var lastName: String? = fullnameArr[1]
8

Or without closures you can do just this in Swift 2:

let fullName = "First Last"
let fullNameArr = fullName.characters.split(" ")
let firstName = String(fullNameArr[0])
1
  • This still works in Swift5 and fixes issues with double spaces that components(seperatedBy: " ") has.
    – Brett
    Jun 4 at 8:23
6

Swift 4

let string = "loremipsum.dolorsant.amet:"

let result = string.components(separatedBy: ".")

print(result[0])
print(result[1])
print(result[2])
print("total: \(result.count)")

Output

loremipsum
dolorsant
amet:
total: 3
0
5

The simplest solution is

let fullName = "First Last"

let components = fullName.components(separatedBy: .whitespacesAndNewlines).compactMap { $0.isEmpty ? nil : $0 }

This will handled multiple white spaces in a row of different types (white space, tabs, newlines etc) and only returns a two element array, you can change the CharacterSet to include more character you like, if you want to get cleaver you can use Regular Expression Decoder, this lets you write regular expression that can be used to decoded string directly into your own class/struct that implement the Decoding protocol. For something like this is over kill, but if you are using it as an example for more complicate string it may make more sense.

4

Let's say you have a variable named "Hello World" and if you want to split it and store it into two different variables you can use like this:

var fullText = "Hello World"
let firstWord = fullText.text?.components(separatedBy: " ").first
let lastWord = fullText.text?.components(separatedBy: " ").last
3

This has Changed again in Beta 5. Weee! It's now a method on CollectionType

Old:

var fullName = "First Last"
var fullNameArr = split(fullName) {$0 == " "}

New:

var fullName = "First Last"
var fullNameArr = fullName.split {$0 == " "}

Apples Release Notes

3

String handling is still a challenge in Swift and it keeps changing significantly, as you can see from other answers. Hopefully things settle down and it gets simpler. This is the way to do it with the current 3.0 version of Swift with multiple separator characters.

Swift 3:

let chars = CharacterSet(charactersIn: ".,; -")
let split = phrase.components(separatedBy: chars)

// Or if the enums do what you want, these are preferred. 
let chars2 = CharacterSet.alphaNumerics // .whitespaces, .punctuation, .capitalizedLetters etc
let split2 = phrase.components(separatedBy: chars2)
3

I was looking for loosy split, such as PHP's explode where empty sequences are included in resulting array, this worked for me:

"First ".split(separator: " ", maxSplits: 1, omittingEmptySubsequences: false)

Output:

["First", ""]
0
2
let str = "one two"
let strSplit = str.characters.split(" ").map(String.init) // returns ["one", "two"]

Xcode 7.2 (7C68)

0
2

Swift 2.2 Error Handling & capitalizedString Added :

func setFullName(fullName: String) {
    var fullNameComponents = fullName.componentsSeparatedByString(" ")

    self.fname = fullNameComponents.count > 0 ? fullNameComponents[0]: ""
    self.sname = fullNameComponents.count > 1 ? fullNameComponents[1]: ""

    self.fname = self.fname!.capitalizedString
    self.sname = self.sname!.capitalizedString
}
0
2

OFFTOP:

For people searching how to split a string with substring (not a character), then here is working solution:

// TESTING
let str1 = "Hello user! What user's details? Here user rounded with space."
let a = str1.split(withSubstring: "user") // <-------------- HERE IS A SPLIT
print(a) // ["Hello ", "! What ", "\'s details? Here ", " rounded with space."]

// testing the result
var result = ""
for item in a {
    if !result.isEmpty {
        result += "user"
    }
    result += item
}
print(str1) // "Hello user! What user's details? Here user rounded with space."
print(result) // "Hello user! What user's details? Here user rounded with space."
print(result == str1) // true

/// Extension providing `split` and `substring` methods.
extension String {
    
    /// Split given string with substring into array
    /// - Parameters:
    ///   - string: the string
    ///   - substring: the substring to search
    /// - Returns: array of components
    func split(withSubstring substring: String) -> [String] {
        var a = [String]()
        var str = self
        while let range = str.range(of: substring) {
            let i = str.distance(from: str.startIndex, to: range.lowerBound)
            let j = str.distance(from: str.startIndex, to: range.upperBound)
            let left = str.substring(index: 0, length: i)
            let right = str.substring(index: j, length: str.length - j)
            a.append(left)
            str = right
        }
        if !str.isEmpty {
            a.append(str)
        }
        return a
    }
    
    /// the length of the string
    public var length: Int {
        return self.count
    }
    
    /// Get substring, e.g. "ABCDE".substring(index: 2, length: 3) -> "CDE"
    ///
    /// - parameter index:  the start index
    /// - parameter length: the length of the substring
    ///
    /// - returns: the substring
    public func substring(index: Int, length: Int) -> String {
        if self.length <= index {
            return ""
        }
        let leftIndex = self.index(self.startIndex, offsetBy: index)
        if self.length <= index + length {
            return String(self[leftIndex..<self.endIndex])
        }
        let rightIndex = self.index(self.endIndex, offsetBy: -(self.length - index - length))
        return String(self[leftIndex..<rightIndex])
    }

}

Not the answer you're looking for? Browse other questions tagged or ask your own question.