addFileWrapper(_:)
Adds a child file wrapper to the receiver, which must be a directory file wrapper.
Declaration
func addFileWrapper(_ child: FileWrapper) -> StringParameters
- child:
File wrapper to add to the directory.
Return Value
Dictionary key used to store fileWrapper 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
Use this method to add an existing file wrapper as a child of a directory file wrapper. If the file wrapper does not have a preferred filename, set the preferredFilename property to give it one before calling addFileWrapper(_:). To create a new file wrapper and add it to a directory, use the addRegularFile(withContents:preferredFilename:) method.
Special Considerations
This method raises NSInternalInconsistencyException if the receiver is not a directory file wrapper.
This method raises NSInvalidArgumentException if the child file wrapper doesn’t have a preferred name.