addRegularFile(withContents:preferredFilename:)
Creates a regular-file file wrapper with the given contents and adds it to the receiver, which must be a directory file wrapper.
Declaration
func addRegularFile(withContents data: Data, preferredFilename fileName: String) -> StringParameters
- data:
Contents for the new regular-file file wrapper.
- fileName:
Preferred filename for the new regular-file file wrapper.
Return Value
Dictionary key used to store the new file wrapper in the directory’s list of file wrappers. The dictionary key is a unique filename, which is the same as the passed-in file wrapper’s preferred filename unless that name is already in use as a key in the directory’s dictionary of children. See Accessing File Wrapper Identities in File System Programming Guide for more information about the file-wrapper list structure.
Discussion
This is a convenience method. The default implementation allocates a new file wrapper, initializes it with init(regularFileWithContents:), set its preferredFilename property, adds it to the directory with addFileWrapper(_:), and returns what addFileWrapper(_:) returned.
Special Considerations
This method raises NSInternalInconsistencyException if the receiver is not a directory file wrapper.
This method raises NSInvalidArgumentException if you pass nil or an empty value for filename.