Instance Method

write(to:atomically:)

Writes the data object's bytes to the location specified by a given URL.

Declaration

func write(to url: URL, atomically: Bool) -> Bool

Parameters

aURL

The location to which to write the receiver's bytes. Only file:// URLs are supported.

atomically

If true, the data is written to a backup location, and then—assuming no errors occur—the backup location is renamed to the name specified by aURL; otherwise, the data is written directly to aURL. atomically is ignored if aURL is not of a type the supports atomic writes.

Return Value

true if the operation succeeds, otherwise false.

Discussion

Since at present only file:// URLs are supported, there is no difference between this method and write(toFile:atomically:), except for the type of the first argument.

This method may not be appropriate when writing to publicly accessible files. To securely write data to a public location, use FileHandle instead. For more information, seeSecuring File Operations in Secure Coding Guide.

See Also

Writing Data to File

func write(toFile: String, atomically: Bool)

Writes the data object's bytes to the file specified by a given path.

func write(toFile: String, options: NSData.WritingOptions = [])

Writes the data object's bytes to the file specified by a given path.

func write(to: URL, options: NSData.WritingOptions = [])

Writes the data object's bytes to the location specified by a given URL.

struct NSData.WritingOptions

Options for methods used to write data objects.