apple.foundation.protocol

Interface NSFileManagerDelegate

public interface NSFileManagerDelegate

Method Summary

Modifier and Type	Method and Description
default boolean	fileManagerShouldCopyItemAtPathToPath(NSFileManager fileManager, java.lang.String srcPath, java.lang.String dstPath) fileManager:shouldCopyItemAtPath:toPath: gives the delegate an opportunity to filter the resulting copy.
default boolean	fileManagerShouldCopyItemAtURLToURL(NSFileManager fileManager, NSURL srcURL, NSURL dstURL)
default boolean	fileManagerShouldLinkItemAtPathToPath(NSFileManager fileManager, java.lang.String srcPath, java.lang.String dstPath) fileManager:shouldLinkItemAtPath:toPath: acts as the other "should" methods, but this applies to the file manager creating hard links to the files in question.
default boolean	fileManagerShouldLinkItemAtURLToURL(NSFileManager fileManager, NSURL srcURL, NSURL dstURL)
default boolean	fileManagerShouldMoveItemAtPathToPath(NSFileManager fileManager, java.lang.String srcPath, java.lang.String dstPath) fileManager:shouldMoveItemAtPath:toPath: gives the delegate an opportunity to not move the item at the specified path.
default boolean	fileManagerShouldMoveItemAtURLToURL(NSFileManager fileManager, NSURL srcURL, NSURL dstURL)
default boolean	fileManagerShouldProceedAfterErrorCopyingItemAtPathToPath(NSFileManager fileManager, NSError error, java.lang.String srcPath, java.lang.String dstPath) fileManager:shouldProceedAfterError:copyingItemAtPath:toPath: gives the delegate an opportunity to recover from or continue copying after an error.
default boolean	fileManagerShouldProceedAfterErrorCopyingItemAtURLToURL(NSFileManager fileManager, NSError error, NSURL srcURL, NSURL dstURL)
default boolean	fileManagerShouldProceedAfterErrorLinkingItemAtPathToPath(NSFileManager fileManager, NSError error, java.lang.String srcPath, java.lang.String dstPath) fileManager:shouldProceedAfterError:linkingItemAtPath:toPath: allows the delegate an opportunity to remedy the error which occurred in linking srcPath to dstPath.
default boolean	fileManagerShouldProceedAfterErrorLinkingItemAtURLToURL(NSFileManager fileManager, NSError error, NSURL srcURL, NSURL dstURL)
default boolean	fileManagerShouldProceedAfterErrorMovingItemAtPathToPath(NSFileManager fileManager, NSError error, java.lang.String srcPath, java.lang.String dstPath) fileManager:shouldProceedAfterError:movingItemAtPath:toPath: functions much like fileManager:shouldProceedAfterError:copyingItemAtPath:toPath: above.
default boolean	fileManagerShouldProceedAfterErrorMovingItemAtURLToURL(NSFileManager fileManager, NSError error, NSURL srcURL, NSURL dstURL)
default boolean	fileManagerShouldProceedAfterErrorRemovingItemAtPath(NSFileManager fileManager, NSError error, java.lang.String path) fileManager:shouldProceedAfterError:removingItemAtPath: allows the delegate an opportunity to remedy the error which occurred in removing the item at the path provided.
default boolean	fileManagerShouldProceedAfterErrorRemovingItemAtURL(NSFileManager fileManager, NSError error, NSURL URL)
default boolean	fileManagerShouldRemoveItemAtPath(NSFileManager fileManager, java.lang.String path) fileManager:shouldRemoveItemAtPath: allows the delegate the opportunity to not remove the item at path.
default boolean	fileManagerShouldRemoveItemAtURL(NSFileManager fileManager, NSURL URL)

Method Detail

fileManagerShouldCopyItemAtPathToPath

default boolean fileManagerShouldCopyItemAtPathToPath(NSFileManager fileManager,
                                                      java.lang.String srcPath,
                                                      java.lang.String dstPath)

fileManager:shouldCopyItemAtPath:toPath: gives the delegate an opportunity to filter the resulting copy. Returning YES from this method will allow the copy to happen. Returning NO from this method causes the item in question to be skipped. If the item skipped was a directory, no children of that directory will be copied, nor will the delegate be notified of those children.

If the delegate does not implement this method, the NSFileManager instance acts as if this method returned YES.

fileManagerShouldCopyItemAtURLToURL

default boolean fileManagerShouldCopyItemAtURLToURL(NSFileManager fileManager,
                                                    NSURL srcURL,
                                                    NSURL dstURL)

fileManagerShouldLinkItemAtPathToPath

default boolean fileManagerShouldLinkItemAtPathToPath(NSFileManager fileManager,
                                                      java.lang.String srcPath,
                                                      java.lang.String dstPath)

fileManager:shouldLinkItemAtPath:toPath: acts as the other "should" methods, but this applies to the file manager creating hard links to the files in question.

If the delegate does not implement this method, the NSFileManager instance acts as if this method returned YES.

fileManagerShouldLinkItemAtURLToURL

default boolean fileManagerShouldLinkItemAtURLToURL(NSFileManager fileManager,
                                                    NSURL srcURL,
                                                    NSURL dstURL)

fileManagerShouldMoveItemAtPathToPath

default boolean fileManagerShouldMoveItemAtPathToPath(NSFileManager fileManager,
                                                      java.lang.String srcPath,
                                                      java.lang.String dstPath)

fileManager:shouldMoveItemAtPath:toPath: gives the delegate an opportunity to not move the item at the specified path. If the source path and the destination path are not on the same device, a copy is performed to the destination path and the original is removed. If the copy does not succeed, an error is returned and the incomplete copy is removed, leaving the original in place.

If the delegate does not implement this method, the NSFileManager instance acts as if this method returned YES.

fileManagerShouldMoveItemAtURLToURL

default boolean fileManagerShouldMoveItemAtURLToURL(NSFileManager fileManager,
                                                    NSURL srcURL,
                                                    NSURL dstURL)

fileManagerShouldProceedAfterErrorCopyingItemAtPathToPath

default boolean fileManagerShouldProceedAfterErrorCopyingItemAtPathToPath(NSFileManager fileManager,
                                                                          NSError error,
                                                                          java.lang.String srcPath,
                                                                          java.lang.String dstPath)

fileManager:shouldProceedAfterError:copyingItemAtPath:toPath: gives the delegate an opportunity to recover from or continue copying after an error. If an error occurs, the error object will contain an NSError indicating the problem. The source path and destination paths are also provided. If this method returns YES, the NSFileManager instance will continue as if the error had not occurred. If this method returns NO, the NSFileManager instance will stop copying, return NO from copyItemAtPath:toPath:error: and the error will be provied there.

If the delegate does not implement this method, the NSFileManager instance acts as if this method returned NO.

fileManagerShouldProceedAfterErrorCopyingItemAtURLToURL

default boolean fileManagerShouldProceedAfterErrorCopyingItemAtURLToURL(NSFileManager fileManager,
                                                                        NSError error,
                                                                        NSURL srcURL,
                                                                        NSURL dstURL)

fileManagerShouldProceedAfterErrorLinkingItemAtPathToPath

default boolean fileManagerShouldProceedAfterErrorLinkingItemAtPathToPath(NSFileManager fileManager,
                                                                          NSError error,
                                                                          java.lang.String srcPath,
                                                                          java.lang.String dstPath)

fileManager:shouldProceedAfterError:linkingItemAtPath:toPath: allows the delegate an opportunity to remedy the error which occurred in linking srcPath to dstPath. If the delegate returns YES from this method, the linking will continue. If the delegate returns NO from this method, the linking operation will stop and the error will be returned via linkItemAtPath:toPath:error:.

If the delegate does not implement this method, the NSFileManager instance acts as if this method returned NO.

fileManagerShouldProceedAfterErrorLinkingItemAtURLToURL

default boolean fileManagerShouldProceedAfterErrorLinkingItemAtURLToURL(NSFileManager fileManager,
                                                                        NSError error,
                                                                        NSURL srcURL,
                                                                        NSURL dstURL)

fileManagerShouldProceedAfterErrorMovingItemAtPathToPath

default boolean fileManagerShouldProceedAfterErrorMovingItemAtPathToPath(NSFileManager fileManager,
                                                                         NSError error,
                                                                         java.lang.String srcPath,
                                                                         java.lang.String dstPath)

fileManager:shouldProceedAfterError:movingItemAtPath:toPath: functions much like fileManager:shouldProceedAfterError:copyingItemAtPath:toPath: above. The delegate has the opportunity to remedy the error condition and allow the move to continue.

If the delegate does not implement this method, the NSFileManager instance acts as if this method returned NO.

fileManagerShouldProceedAfterErrorMovingItemAtURLToURL

default boolean fileManagerShouldProceedAfterErrorMovingItemAtURLToURL(NSFileManager fileManager,
                                                                       NSError error,
                                                                       NSURL srcURL,
                                                                       NSURL dstURL)

fileManagerShouldProceedAfterErrorRemovingItemAtPath

default boolean fileManagerShouldProceedAfterErrorRemovingItemAtPath(NSFileManager fileManager,
                                                                     NSError error,
                                                                     java.lang.String path)

fileManager:shouldProceedAfterError:removingItemAtPath: allows the delegate an opportunity to remedy the error which occurred in removing the item at the path provided. If the delegate returns YES from this method, the removal operation will continue. If the delegate returns NO from this method, the removal operation will stop and the error will be returned via linkItemAtPath:toPath:error:.

If the delegate does not implement this method, the NSFileManager instance acts as if this method returned NO.

fileManagerShouldProceedAfterErrorRemovingItemAtURL

default boolean fileManagerShouldProceedAfterErrorRemovingItemAtURL(NSFileManager fileManager,
                                                                    NSError error,
                                                                    NSURL URL)

fileManagerShouldRemoveItemAtPath

default boolean fileManagerShouldRemoveItemAtPath(NSFileManager fileManager,
                                                  java.lang.String path)

fileManager:shouldRemoveItemAtPath: allows the delegate the opportunity to not remove the item at path. If the delegate returns YES from this method, the NSFileManager instance will attempt to remove the item. If the delegate returns NO from this method, the remove skips the item. If the item is a directory, no children of that item will be visited.

If the delegate does not implement this method, the NSFileManager instance acts as if this method returned YES.

fileManagerShouldRemoveItemAtURL

default boolean fileManagerShouldRemoveItemAtURL(NSFileManager fileManager,
                                                 NSURL URL)