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.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software