Instance Method

addRegularFileWithContents: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

- (NSString *)addRegularFileWithContents:(NSData *)data preferredFilename:(NSString *)fileName;

Parameters

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 initRegularFileWithContents:, 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.

See Also

Accessing File-Wrapper Information

fileWrappers

The file wrappers contained by a directory file wrapper.

- addFileWrapper:

Adds a child file wrapper to the receiver, which must be a directory file wrapper.

- removeFileWrapper:

Removes a child file wrapper from the receiver, which must be a directory file wrapper.

- addFileWithPath:

Creates a file wrapper from a given file-system node and adds it to the receiver, which must be a directory file wrapper.

Deprecated
- addSymbolicLinkWithDestination:preferredFilename:

Creates a symbolic-link file wrapper pointing to a given file-system node and adds it to the receiver, which must be a directory file wrapper.

Deprecated
- keyForFileWrapper:

Returns the dictionary key used by a directory to identify a given file wrapper.

- symbolicLinkDestination

Provides the pathname referenced by the file wrapper object, which must be a symbolic-link file wrapper.

Deprecated
symbolicLinkDestinationURL

The URL referenced by the file wrapper object, which must be a symbolic-link file wrapper.