Writing Files with Swift: A Guide to File I/O in iOS and macOS

By /

Writing Files with Swift: A Guide to File I/O in iOS and macOS

Programming in Swift is a great way to build apps for both iOS and macOS. One of the most important tasks when creating an app is being able to read and write files. This article will introduce you to file I/O in Swift, and show you how to read and write files in both iOS and macOS.

First, let’s take a look at the basics of file I/O. In Swift, you can access the contents of a file using what’s called a FileHandle. A FileHandle is an object that allows you to read and write data from a file. You can create a FileHandle by passing in a path to the file you want to access. 

let filePath = "/path/to/file.txt"
let fileHandle = try FileHandle(forReadingFrom: URL(fileURLWithPath: filePath))

Once you have a FileHandle, you can start reading and writing data to the file. To read data from a file, you can use the readData() method. This method returns a Data object, which contains the contents of the file. You can then convert this Data object into a string, or any other data type you need.

let data = fileHandle.readData()
let string = String(data: data, encoding: .utf8)

To write data to a file, you can use the write() method. This method takes a Data object, which contains the data you want to write to the file. 

let data = "This is a string".data(using: .utf8)
fileHandle.write(data)

File I/O is a bit different on iOS than it is on macOS. On iOS, you can only access files that are stored in the app’s documents directory. This is a special folder that is created when the app is installed, and it is where all of the app’s data is stored. To access the documents directory, you can use the FileManager class. 

let fileManager = FileManager.default
let documentsDirectory = fileManager.urls(for: .documentDirectory, in: .userDomainMask).first!
let fileURL = documentsDirectory.appendingPathComponent("file.txt")

Once you have the URL for the file, you can create a FileHandle and read and write data to the file just like you would on macOS.

On macOS, you can access any file on the user’s filesystem. To do this, you can use the NSOpenPanel class. This class displays a dialog box that allows the user to select a file. Once the user has selected a file, you can get the URL of the file and create a FileHandle to read and write data to the file. 

let openPanel = NSOpenPanel()
openPanel.canChooseFiles = true
openPanel.canChooseDirectories = false
openPanel.begin { (result) in
    if result == .success {
        let fileURL = openPanel.urls.first!
        let fileHandle = try FileHandle(forReadingFrom: fileURL)
        // ...
    }
}

In this article, we’ve taken a look at how to read and write files in Swift. We’ve seen how to access the documents directory on iOS, and how to use the NSOpenPanel class on macOS. With this knowledge, you should be able to read and write files in your own apps.

Scroll to Top