NSFileManager クラスリファレンス 翻訳元
このページの最終更新:2011-04-13
ADCの最終更新:2010-05-11
ADCの最終更新:2010-05-11
継承するクラス | NSObject |
準拠しているプロトコル | NSObject (NSObject) |
フレームワーク | /System/Library/Frameworks/Foundation.framework |
使用可能な環境 | Mac OS X v10.0以降 |
宣言ファイル | NSFileManager.h |
コンパニオンガイド | Low-Level File Management Programming Topics? |
サンプルコード | CocoaSlides? Core Data HTML Store? CoreRecipes? ImageKitDemo? Quartz Composer WWDC 2005 TextEdit? |
概観(Overview)
NSFileManagerクラスは、一般的なファイル操作を可能にし、アプリケーションをファイルシステムから独立させます。
Mac OS X v10.5以降もうこのクラスをシングルトンインスタンスとして使う制限はすでになくなっています。NSFileManagerクラスのインスタンスは[[NSFileManager alloc] init]を使った時に、スレッドセーフを考慮して作られます。
Mac OS X v10.5以降もうこのクラスをシングルトンインスタンスとして使う制限はすでになくなっています。NSFileManagerクラスのインスタンスは[[NSFileManager alloc] init]を使った時に、スレッドセーフを考慮して作られます。
このクラスでできること(Tasks)
ファイルマネージャの生成(Creating a File Manager)
アイテムの移動(Moving an Item)
– fileManager:shouldMoveItemAtPath:toPath: delegate method
– fileManager:shouldMoveItemAtURL:toURL: delegate method
– moveItemAtPath:toPath:error:
– moveItemAtURL:toURL:error:
– fileManager:shouldProceedAfterError:movingItemAtPath:toPath: delegate method
– fileManager:shouldProceedAfterError:movingItemAtURL:toURL: delegate method
– movePath:toPath:handler: Deprecated in Mac OS X v10.5
– fileManager:shouldMoveItemAtURL:toURL: delegate method
– moveItemAtPath:toPath:error:
– moveItemAtURL:toURL:error:
– fileManager:shouldProceedAfterError:movingItemAtPath:toPath: delegate method
– fileManager:shouldProceedAfterError:movingItemAtURL:toURL: delegate method
– movePath:toPath:handler: Deprecated in Mac OS X v10.5
アイテムの複製(Copying an Item)
– fileManager:shouldCopyItemAtPath:toPath: delegate method
– fileManager:shouldCopyItemAtURL:toURL: delegate method
– copyItemAtPath:toPath:error:
– copyItemAtURL:toURL:error:
– fileManager:shouldProceedAfterError:copyingItemAtPath:toPath: delegate method
– fileManager:shouldProceedAfterError:copyingItemAtURL:toURL: delegate method
– copyPath:toPath:handler: Deprecated in Mac OS X v10.5
– fileManager:shouldCopyItemAtURL:toURL: delegate method
– copyItemAtPath:toPath:error:
– copyItemAtURL:toURL:error:
– fileManager:shouldProceedAfterError:copyingItemAtPath:toPath: delegate method
– fileManager:shouldProceedAfterError:copyingItemAtURL:toURL: delegate method
– copyPath:toPath:handler: Deprecated in Mac OS X v10.5
アイテムの削除(Removing an Item)
– fileManager:shouldRemoveItemAtPath: delegate method
– fileManager:shouldRemoveItemAtURL: delegate method
– removeItemAtPath:error:
– removeItemAtURL:error:
– fileManager:shouldProceedAfterError:removingItemAtPath: delegate method
– fileManager:shouldProceedAfterError:removingItemAtURL: delegate method
– removeFileAtPath:handler: Deprecated in Mac OS X v10.5
– fileManager:shouldRemoveItemAtURL: delegate method
– removeItemAtPath:error:
– removeItemAtURL:error:
– fileManager:shouldProceedAfterError:removingItemAtPath: delegate method
– fileManager:shouldProceedAfterError:removingItemAtURL: delegate method
– removeFileAtPath:handler: Deprecated in Mac OS X v10.5
アイテムの作成(Creating an Item)
– createDirectoryAtPath:withIntermediateDirectories:attributes:error:
– createFileAtPath:contents:attributes:
– createDirectoryAtPath:attributes: Deprecated in Mac OS X v10.5
– createFileAtPath:contents:attributes:
– createDirectoryAtPath:attributes: Deprecated in Mac OS X v10.5
アイテムの連結(Linking an Item)
– fileManager:shouldLinkItemAtPath:toPath: delegate method
– fileManager:shouldLinkItemAtURL:toURL: delegate method
– linkItemAtPath:toPath:error:
– linkItemAtURL:toURL:error:
– fileManager:shouldProceedAfterError:linkingItemAtPath:toPath: delegate method
– fileManager:shouldProceedAfterError:linkingItemAtURL:toURL: delegate method
– linkPath:toPath:handler: Deprecated in Mac OS X v10.5
– fileManager:shouldLinkItemAtURL:toURL: delegate method
– linkItemAtPath:toPath:error:
– linkItemAtURL:toURL:error:
– fileManager:shouldProceedAfterError:linkingItemAtPath:toPath: delegate method
– fileManager:shouldProceedAfterError:linkingItemAtURL:toURL: delegate method
– linkPath:toPath:handler: Deprecated in Mac OS X v10.5
シンボリックリンクの操作(Symbolic-Link Operations)
– createSymbolicLinkAtPath:withDestinationPath:error:
– destinationOfSymbolicLinkAtPath:error:
– createSymbolicLinkAtPath:pathContent: Deprecated in Mac OS X v10.5
– pathContentOfSymbolicLinkAtPath: Deprecated in Mac OS X v10.5
– destinationOfSymbolicLinkAtPath:error:
– createSymbolicLinkAtPath:pathContent: Deprecated in Mac OS X v10.5
– pathContentOfSymbolicLinkAtPath: Deprecated in Mac OS X v10.5
ファイル操作の制御(Handling File Operations)
このセクションで説明しているメソッドはNSFileManagerのいくつかのメソッドに渡されるコールバックハンドラによって定義されます。これらのメソッドはMac OS X v10.5では非推奨のメソッドです。代わりに対応する委譲メソッドを使用して下さい。
– fileManager:shouldProceedAfterError: delegate method Deprecated in Mac OS X v10.5
– fileManager:willProcessPath: delegate method Deprecated in Mac OS X v10.5
– fileManager:shouldProceedAfterError: delegate method Deprecated in Mac OS X v10.5
– fileManager:willProcessPath: delegate method Deprecated in Mac OS X v10.5
ファイルコンテンツの取得と比較(Getting and Comparing File Contents)
ディレクトリコンテンツの検索(Discovering Directory Contents)
– mountedVolumeURLsIncludingResourceValuesForKeys:options:
– contentsOfDirectoryAtURL:includingPropertiesForKeys:options:error:
– contentsOfDirectoryAtPath:error:
– enumeratorAtPath:
– enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:
– subpathsAtPath:
– subpathsOfDirectoryAtPath:error:
– directoryContentsAtPath: Deprecated in Mac OS X v10.5
– contentsOfDirectoryAtURL:includingPropertiesForKeys:options:error:
– contentsOfDirectoryAtPath:error:
– enumeratorAtPath:
– enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:
– subpathsAtPath:
– subpathsOfDirectoryAtPath:error:
– directoryContentsAtPath: Deprecated in Mac OS X v10.5
ファイルへのアクセス判断(Determining Access to Files)
– fileExistsAtPath:
– fileExistsAtPath:isDirectory:
– isReadableFileAtPath:
– isWritableFileAtPath:
– isExecutableFileAtPath:
– isDeletableFileAtPath:
– fileExistsAtPath:isDirectory:
– isReadableFileAtPath:
– isWritableFileAtPath:
– isExecutableFileAtPath:
– isDeletableFileAtPath:
ファイル属性の取得と設定(Getting and Setting Attributes)
– componentsToDisplayForPath:
– displayNameAtPath:
– attributesOfItemAtPath:error:
– attributesOfFileSystemForPath:error:
– setAttributes:ofItemAtPath:error:
– changeFileAttributes:atPath: Deprecated in Mac OS X v10.5
– fileAttributesAtPath:traverseLink: Deprecated in Mac OS X v10.5
– fileSystemAttributesAtPath: Deprecated in Mac OS X v10.5
– displayNameAtPath:
– attributesOfItemAtPath:error:
– attributesOfFileSystemForPath:error:
– setAttributes:ofItemAtPath:error:
– changeFileAttributes:atPath: Deprecated in Mac OS X v10.5
– fileAttributesAtPath:traverseLink: Deprecated in Mac OS X v10.5
– fileSystemAttributesAtPath: Deprecated in Mac OS X v10.5
ファイルパス表現の取得(Getting Representations of File Paths)
委譲先の管理(Managing the Delegate)
現在のディレクトリの管理(Managing the Current Directory)
システムディレクトリの位置づけ(Locating System Directories)
安全なファイルの置き換え(Safely Replace a File)
クラスメソッド
defaultManager
ファイルシステムごとの標準のNSFileManagerオブジェクトを返します。
+ (NSFileManager *)defaultManger
戻り値
+ (NSFileManager *)defaultManger
戻り値
- ファイルシステムの標準のNSFileManagerオブジェクトです。
解説
- このメソッドは常に同じファイルマネージャインスタンスを返します。このメソッドによって取得したオブジェクトはスレッドセーフではありません。
- Mac OS X v10.5以降ではもうこのクラスをシングルトンとして使う必要はありません。他のクラスでするようにこのクラスのインスタンスを生成し、初期化することができます。[[NSFileManager alloc] init]という手順を使った場合、返されるNSFileManagerオブジェクトはスレッドセーフです。
使用可能な環境
- Mac OS X v10.0以降
サンプルコード
宣言ファイル
- NSFileManager.h
インスタンスメソッド
attributesOfFileSystemForPath:error:
attributesOfItemAtPath:error:
changeCurrentDirectoryPath:
componentsToDisplayForPath:
contentsAtPath:
contentsEqualAtPath:andPath:
contentsOfDirectoryAtPath:error:
与えられたディレクトリに含まれるディレクトリとファイル(シンボリックリンクを含む)を返します。
- (NSArray *)contentsOfDirectoryAtPath:(NSString *)path error:(NSError **)error
パラメータ
- (NSArray *)contentsOfDirectoryAtPath:(NSString *)path error:(NSError **)error
パラメータ
- path
- ディレクトリのパス。
- error
- エラーが起きた場合、そのエラーについて記述されたNSErrorオブジェクトが格納されます。エラー情報が必要ない場合はNULLを渡してください。
戻り値
- pathに含まれるディレクトリやファイル(シンボリックリンクを含む)名のNSStringオブジェクトの配列です。ディレクトリが存在していてもコンテンツを含んでいない時には空の配列が返ります。pathで指定されたディレクトリが存在しないか、アクセス時に何かエラーが起きた時はnilが返ります。
解説
- 検索は浅く行われます。したがって戻り値はサブディレクトリを含みません。戻り値の配列は現在のディレクトリ(".")、親ディレクトリ("..")、リソースフォーク("._")の文字列を含まず、シンボリックリンクを辿ることもしません。
使用可能な環境
- Max OS X v10.5以降
関連項目
サンプルコード
宣言ファイル
- NSFileManager.h
contentsOfDirectoryAtURL:includingPropertiesForKeys:options:error:
copyItemAtPath:toPath:error:
copyItemAtURL:toURL:error:
createDirectoryAtPath:withIntermediateDirectories:attributes:error:
createFileAtPath:contents:attributes:
createSymbolicLinkAtPath:withDestinationPath:error:
currentDirectoryPath
delegate
destinationOfSymbolicLinkAtPath:error:
displayNameAtPath:
パスで与えられたファイルまたはディレクトリをユーザに提示するためのローカライズされた書式にして返します。
- (NSString *)dispalyNameAtPath:(NSString *)path
パラメータ
- (NSString *)dispalyNameAtPath:(NSString *)path
パラメータ
- path
- ファイルまたはディレクトリのパス。
戻り値
- ファイルまたはディレクトリの名前
解説
- 戻り値は必要に応じてローカライズされています。たとえばシステムの言語としてフランス語を選択している場合、以下のコードのログは "Bibliothèque" です。
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES); if ([paths count] > 0) { NSString *documentsDirectory = [paths objectAtIndex:0]; NSFileManager *fileManager = [[NSFileManager alloc] init]; NSString *displayNameAtPath = [fileManager displayNameAtPath:documentsDirectory]; NSLog(@"%@", displayNameAtPath); [fileManager release]; } |
使用可能な環境
- Max OS X v10.1以降
関連項目
- – lastPathComponent ( NSString )
サンプルコード
宣言ファイル
- NSFileManager.h
enumeratorAtPath:
enumeratorAtURL:includingPropertiesForKeys:options:
errorHandler:
fileExistsAtPath:
fileExistsAtPath:isDirectory:
fileSystemRepresentationWithPath:
init
初期化された NSFilemanager のインスタンスを返します。
- init
戻り値
- init
戻り値
- 初期化された NSFilemanager のインスタンスです。
解説
- Mac OS X v 10.4 以前のバージョンでは init メッセージの送信は定義されていません。iOS と Mac OS X 10.5 以降のバージョンでレシーバを初期化します。
isDeletableFileAtPath:
isExecutableFileAtPath:
isReadableFileAtPath:
isWritableFileAtPath:
linkItemAtPath:toPath:error:
linkItemAtURL:toURL:error:
mountedVolumeURLsIncludingResourceValuesForKeys:options:
moveItemAtPath:toPath:error:
与えられたパスによって特定されるディレクトリまたはファイルをもう一方のパスで識別される別のファイルシステムの位置に移動します。
- (BOOL)moveItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath error:(NSError **)error
パラメータ
- (BOOL)moveItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath error:(NSError **)error
パラメータ
- srcPath
- 移動元のディレクトリまたはファイルのパス。srcPath は存在していなければなりません。
- dstPath
- srcPath の移動先のディレクトリまたはファイルのパスです。移動先のディレクトリまたファイルが既に存在してはいけません。移動先のパスはディレクトリ名またはファイル名で終わっていなければなりません。ソース名が暗黙裏に採択されることはありません。
- error
- エラーが発生した場合、戻ったときに問題を記述した NSError オブジェクトが含まれます。エラー情報が必要でない場合は NULL を渡します。
戻り値
- 移動のオペレーションが成功した場合は YES です。成功しない場合でもデリゲートのメッセージ fileManager:shouldProceedAfterError:movingItemAtPath:toPath: が YES を返せば moveItemAtPath:toPath:error: も YES を返します。そうでない場合は NO です。
解説
- ソースのパスと移動先のパスが同じデバイス上にない場合、NSFilenaMager は 移動先のパスにコピーを実行してからオリジナルを削除します。コピーが成功しなかった場合、このメソッドはエラーを返し、NSFileManager は不完全なコピーを削除します。オリジナルはそのまま残ります。
- NSFileManager は移動オペレーションを開始するとき fileManager:shouldMoveItemAtPath:toPath: をデリゲートに送ります。デリゲートが YES を返す場合、NSFilemanager はアイテムの移動を試みます。NO を返す場合、moveItemAtPath:toPath:error: はアイテムの移動をしません。
- NSFilemanager は工程でエラーに遭遇したとき fileManager:shouldProceedAfterError:movingItemAtPath:toPath: をデリゲートに送ります。デリゲートが YES を返す場合、そのとき NSFileManamer はエラーが発生しなかったものとして続行します。NO を返す場合、moveItemAtPath:toPath:error: は終了し、エラーパラメータに戻ってエラーを渡します。
使用可能な環境
- Max OS X v10.5以降
関連項目
- - moveItemAtURL:toURL:error:
- - fileManager:shouldMoveItemAtPath:toPath:
- - copyItemAtPath:toPath:error:
- - linkItemAtPath:toPath:error:
- - removeItemAtPath:error:
サンプルコード
宣言ファイル
- NSFileManager.h
moveItemAtURL:toURL:error:
与えられたURLによって特定されるディレクトリまたはファイルをもう一方のURLで識別される別のファイルシステムの位置に移動します。
- (BOOL)moveItemAtURL:(NSURL? *)srcURL toURL:(NSURL? *)dstURL error:(NSError **)error
パラメータ
- (BOOL)moveItemAtURL:(NSURL? *)srcURL toURL:(NSURL? *)dstURL error:(NSError **)error
パラメータ
- srcURL
- 移動元のディレクトリまたはファイルのURL。srcURL は存在していなければなりません。
- dstURL
- srcURL の移動先のディレクトリまたはファイルのURLです。移動先のディレクトリまたファイルが既に存在してはいけません。移動先のURLはディレクトリ名またはファイル名で終わっていなければなりません。ソース名が暗黙裏に採択されることはありません。
- error
- エラーが発生した場合、戻ったときに問題を記述した NSError オブジェクトが含まれます。エラー情報が必要でない場合は NULL を渡します。
戻り値
- 移動のオペレーションが成功した場合は YES です。成功しない場合でもデリゲートのメッセージ fileManager:shouldProceedAfterError:movingItemAtURL:toURL: が YES を返せば moveItemAtURL:toURL:error: も YES を返します。そうでない場合は NO です。
解説
- ソースのパスと移動先のパスが同じデバイス上にない場合、NSFilenaMager は 移動先のパスにコピーを実行してからオリジナルを削除します。コピーが成功しなかった場合、このメソッドはエラーを返し、NSFileManager は不完全なコピーを削除します。オリジナルはそのまま残ります。
- NSFileManager は移動オペレーションを開始するとき fileManager:shouldMoveItemAtURL:toURL: をデリゲートに送ります。デリゲートが YES を返す場合、NSFilemanager はアイテムの移動を試みます。NO を返す場合、moveItemAtURL:toURL:error: はアイテムの移動をしません。
- NSFilemanager は工程でエラーに遭遇したとき fileManager:shouldProceedAfterError:movingItemAtURL:toURL: をデリゲートに送ります。デリゲートが YES を返す場合、そのとき NSFileManamer はエラーが発生しなかったものとして続行します。NO を返す場合、moveItemAtURL:toURL:error: は終了し、エラーパラメータに戻ってエラーを渡します。
使用可能な環境
- Max OS X v10.6 以降
関連項目
- - moveItemAtPath:toPath:error:
- - fileManager:shouldMoveItemAtURL:toURL:
- - copyItemAtURL:toURL:error:
- - linkItemAtURL:toURL:error:
- - removeItemAtURL:error:
宣言ファイル
- NSFileManager.h
removeItemAtPath:error:
removeItemAtURL:error:
replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error:
setAttributes:ofItemAtPath:error:
setDelegate:
stringWithFileSystemRepresentation:length:
subpathsAtPath:
subpathsOfDirectoryAtPath:error:
与えられたディレクトリに含まれるディレクトリとファイル(シンボリックリンクを含む)を返します。
- (NSArray *)subpathsOfDirectoryAtPath:(NSString *)path error:(NSError **)error
パラメータ
- (NSArray *)subpathsOfDirectoryAtPath:(NSString *)path error:(NSError **)error
パラメータ
- path
- リストアップするディレクトリのパス。
- error
- エラーが起きた場合、そのエラーについて記述されたNSErrorオブジェクトが格納されます。エラー情報が必要ない場合はNULLを渡してください。
戻り値
- pathで指定されたディレクトリとそのサブディレクトリに含まれるアイテムを再帰的に検索しそのファイルネームを表すNSStringオブジェクトの配列を返します。pathがシンボリックリンクであれば、subpathsOfDirectoryAtPath:error:メソッドはそのリンクを辿ります。[the device of the linked-to file]が取得できない場合はnilを返します。
解説
- このディレクトリコンテンツのリストはかなり深くまで至り、ゆえに巨大なファイルシステムツリーではとても役立ちます。このメソッドは"."と".."をスキップします。
使用可能な環境
- Max OS X v10.5以降
関連項目
宣言ファイル
- NSFileManager.h
URLForDirectory:inDomain:appropriateForURL:create:error:
URLsForDirectory:inDomains:
委譲メソッド(Delegate Method)
fileManager:shouldCopyItemAtPath:toPath:
NSFileManager オブジェクトは与えられたパスへのコピーを実行する直前にこのメッセージを送信します。
- (BOOL)fileManager:(NSFileManager *)fileManager shouldCopyItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath
パラメータ
- (BOOL)fileManager:(NSFileManager *)fileManager shouldCopyItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath
パラメータ
- fileManager
- このメッセージを送信した NSFileManager オブジェクトです。
- srcPath
- fileManager がコピーを実行しようとしているコピー元のファイルまたはディレクトリのパスです。
- dstPath
- fileManager がコピーを実行しようとしているコピー先のファイルまたはディレクトリのパスです。
戻り値
- この操作が続行されるべきなら YES を返します。そうでないならば、NO を返します。
解説
- このメソッドが NO を返すと NSFilemanager はアイテムをコピーしようとすることを停止します。スキップされたアイテムがディレクトリの場合、そのディレクトリが内包するものはコピーされません。同様にこれらの内包するものについてデリゲートに通知しません。
使用可能な環境
- Max OS X v10.5 以降
関連項目
- - copyItemAtPath:toPath:error:
- - fileManager:shouldProceedAfterError:copyingItemAtPath:toPath:
- - fileManager:shouldCopyItemAtURL:toURL:
宣言ファイル
- NSFileManager.h
fileManager:shouldCopyItemAtURL:toURL:
fileManager:shouldLinkItemAtPath:toPath:
fileManager:shouldLinkItemAtURL:toURL:
fileManager:shouldMoveItemAtPath:toPath:
NSFileManager オブジェクトは与えられたパスへの移動を実行する直前にこのメッセージを送信します。
- (BOOL)fileManager:(NSFileManager *)fileManager shouldMoveItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath
パラメータ
- (BOOL)fileManager:(NSFileManager *)fileManager shouldMoveItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath
パラメータ
- fileManager
- このメッセージを送信した NSFileManager オブジェクトです。
- srcPath
- fileManager が移動を実行しようとしている移動元のファイルまたはディレクトリのパスです。
- dstPath
- fileManager が移動を実行しようとしている移動先のファイルまたはディレクトリのパスです。
戻り値
- この操作が続行されるべきなら YES を返します。そうでないならば、NO を返します。
解説
- このメソッドが NO を返すと NSFilemanager はアイテムの移動を停止します。移動のオペレーションでは、ソースのパスと移動先のパスが同じデバイス上にない場合、NSFilenaMager は 移動先のパスにコピーを実行してからオリジナルを削除します。コピーが成功しなかった場合、NSFileManager はエラーを返し、不完全なコピーを削除します。オリジナルはそのまま残ります。
使用可能な環境
- Max OS X v10.5 以降
関連項目
宣言ファイル
- NSFileManager.h
fileManager:shouldMoveItemAtURL:toURL:
NSFileManager オブジェクトは与えられた URL への移動を実行する直前にこのメッセージを送信します。
- (BOOL)fileManager:(NSFileManager *)fileManager shouldMoveItemAtURL:(NSURL? *)srcURL toURL:(NSURL? *)dstURL
パラメータ
- (BOOL)fileManager:(NSFileManager *)fileManager shouldMoveItemAtURL:(NSURL? *)srcURL toURL:(NSURL? *)dstURL
パラメータ
- fileManager
- このメッセージを送信した NSFileManager オブジェクトです。
- srcURL
- fileManager が移動を実行しようとしている移動元のファイルまたはディレクトリの URL です。
- dstPath
- fileManager が移動を実行しようとしている移動先のファイルまたはディレクトリの URL です。
戻り値
- この操作が続行されるべきなら YES を返します。そうでないならば、NO を返します。
解説
- このメソッドが NO を返すと NSFilemanager はアイテムの移動を停止します。移動のオペレーションでは、ソースの URL と移動先の URL が同じデバイス上にない場合、NSFilenaMager は 移動先の URL にコピーを実行してからオリジナルを削除します。コピーが成功しなかった場合、NSFileManager はエラーを返し、不完全なコピーを削除します。オリジナルはそのまま残ります。
使用可能な環境
- Max OS X v10.6 以降
関連項目
宣言ファイル
- NSFileManager.h
fileManager:shouldProceedAfterError:copyingItemAtPath:toPath:
fileManager:shouldProceedAfterError:copyingItemAtURL:toURL:
fileManager:shouldProceedAfterError:linkingItemAtPath:toPath:
fileManager:shouldProceedAfterError:linkingItemAtURL:toURL:
fileManager:shouldProceedAfterError:movingItemAtPath:toPath:
NSFileManager オブジェクトは与えられたパスへの移動を実行する間にエラーが発生した場合、このメッセージを送信します。
- (BOOL)fileManager:(NSFileManager *)fileManager shouldProceedAfterError:(NSError *)error movingItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath
パラメータ
- (BOOL)fileManager:(NSFileManager *)fileManager shouldProceedAfterError:(NSError *)error movingItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath
パラメータ
- fileManager
- このメッセージを送信した NSFileManager オブジェクトです。
- error
- 移動を実行する間に発生したエラーです。
- srcPath
- fileManager が移動を実行しようとしている移動元のファイルまたはディレクトリのパスです。
- dstPath
- fileManager が移動を実行しようとしている移動先のファイルまたはディレクトリのパスです。
戻り値
- この操作が続行されるべきなら YES を返します。そうでないならば、NO を返します。
解説
- このメソッドが YES を返す場合、NSFileManager のインスタンスはエラーが発生しなかったものとして動作を継続します。NO を返す場合、アイテムの移動を停止し moveItemAtPath:toPath:error: は NO を返します。そして、このメソッドのエラーの引数にエラーを提供します。
使用可能な環境
- Max OS X v10.5 以降
関連項目
宣言ファイル
- NSFileManager.h
fileManager:shouldProceedAfterError:movingItemAtURL:toURL:
NSFileManager オブジェクトは与えられた URL への移動を実行する間にエラーが発生した場合、このメッセージを送信します。
- (BOOL)fileManager:(NSFileManager *)fileManager shouldProceedAfterError:(NSError *)error movingItemAtURL:(NSURL? *)srcURL toURL:(NSURL? *)dstURL
パラメータ
- (BOOL)fileManager:(NSFileManager *)fileManager shouldProceedAfterError:(NSError *)error movingItemAtURL:(NSURL? *)srcURL toURL:(NSURL? *)dstURL
パラメータ
- fileManager
- このメッセージを送信した NSFileManager オブジェクトです。
- error
- 移動を実行する間に発生したエラーです。
- srcURL
- fileManager が移動を実行しようとしている移動元のファイルまたはディレクトリの URL です。
- dstURL
- fileManager が移動を実行しようとしている移動先のファイルまたはディレクトリの URL です。
戻り値
- この操作が続行されるべきなら YES を返します。そうでないならば、NO を返します。
解説
- このメソッドが YES を返す場合、NSFileManager のインスタンスはエラーが発生しなかったものとして動作を継続します。NO を返す場合、アイテムの移動を停止し moveItemAtURL:toURL:error: は NO を返します。そして、このメソッドのエラーの引数にエラーを提供します。
使用可能な環境
- Max OS X v10.6 以降
関連項目
宣言ファイル
- NSFileManager.h
fileManager:shouldProceedAfterError:removingItemAtPath:
fileManager:shouldProceedAfterError:removingItemAtURL:
fileManager:shouldRemoveItemAtPath:
fileManager:shouldRemoveItemAt
定数(Constants)
Mounted Volume Enumeration Options
Directory Enumeration Options
NSFileManagerItemReplacementOptions
ファイル属性キー(File Attribute Keys)
これらのキーは
- setAttributes:ofItemAtPath:error:、
- attributesOfItemAtPath:error:、
- createDirectoryAtPath:withIntermediateDirectories:attributes:error:、
- createFileAtPath:contents:attributes:
のメソッドを使って得たNSDictionaryオブジェクトに格納されているファイル属性値を取得する為のものです。
NSString * const NSFileType;
NSString * const NSFileSize;
NSString * const NSFileModificationDate;
NSString * const NSFileReferenceCount;
NSString * const NSFileDeviceIdentifier;
NSString * const NSFileOwnerAccountName;
NSString * const NSFileGroupOwnerAccountName;
NSString * const NSFilePosixPermissions;
NSString * const NSFileSystemNumber;
NSString * const NSFileSystemFileNumber;
NSString * const NSFileExtensionHidden;
NSString * const NSFileHFSCreatorCode;
NSString * const NSFileHFSTypeCode;
NSString * const NSFileImmutable;
NSString * const NSFileAppendOnly;
NSString * const NSFileCreationDate;
NSString * const NSFileOwnerAccountID;
NSString * const NSFileGroupOwnerAccountID;
NSString * const NSFileBusy;
定数
- setAttributes:ofItemAtPath:error:、
- attributesOfItemAtPath:error:、
- createDirectoryAtPath:withIntermediateDirectories:attributes:error:、
- createFileAtPath:contents:attributes:
のメソッドを使って得たNSDictionaryオブジェクトに格納されているファイル属性値を取得する為のものです。
NSString * const NSFileType;
NSString * const NSFileSize;
NSString * const NSFileModificationDate;
NSString * const NSFileReferenceCount;
NSString * const NSFileDeviceIdentifier;
NSString * const NSFileOwnerAccountName;
NSString * const NSFileGroupOwnerAccountName;
NSString * const NSFilePosixPermissions;
NSString * const NSFileSystemNumber;
NSString * const NSFileSystemFileNumber;
NSString * const NSFileExtensionHidden;
NSString * const NSFileHFSCreatorCode;
NSString * const NSFileHFSTypeCode;
NSString * const NSFileImmutable;
NSString * const NSFileAppendOnly;
NSString * const NSFileCreationDate;
NSString * const NSFileOwnerAccountID;
NSString * const NSFileGroupOwnerAccountID;
NSString * const NSFileBusy;
定数
- NSFileAppendOnly
- ファイルが読み取り専用かどうかを示すファイル属性辞書のキーです。
- 対応する値は論理値を格納したNSNumberオブジェクトです。
- Mac OS X v10.2以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileBusy
- ファイルが使用中かどうかを示すファイル属性辞書のキーです。
- 対応する値は論理値を格納したNSNumberオブジェクトです。
- Mac OS X v10.4以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileCreationDate
- ファイルの作成日を示すファイル属性辞書のキーです。
- 対応する値はNSDateオブジェクトです。
- Mac OS X v10.2以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileOwnerAccountName
- ファイル所有者の名前を示すファイル属性辞書のキーです。
- 対応する値はNSStringオブジェクトです。
- Mac OS X v10.0以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileGroupOwnerAccountName
- ファイル所有者グループの名前を示すファイル属性辞書のキーです。
- 対応する値はNSStringオブジェクトです。
- Mac OS X v10.0以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileDeviceIdentifier
- ファイルが存在するデバイスのIDを示すファイル属性辞書のキーです。
- 対応する値はunsignd long型を格納したNSNumberオブジェクトです。
- Mac OS X v10.0以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileExtensionHidden
- ファイルの拡張子が隠れているかどうかを示すファイル属性辞書のキーです。
- 対応する値は論理値を格納したNSNumberオブジェクトです。
- Mac OS X v10.1以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileGroupOwnerAccountID
- ファイルのグループIDを示すファイル属性辞書のキーです。
- 対応する値はunsigned long型を格納したNSNumberオブジェクトです。
- Mac OS X v10.2以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileHFSCreatorCode
- ファイルのHFSクリエータコードを示すファイル属性辞書のキーです。
- 対応する値はunsigned long型を格納したNSNumberオブジェクトです。適切な値についてはHFS File Types?を参照してください。
- Mac OS X v10.1以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileHFSTypeCode
- ファイルのHFSタイプコードを示すファイル属性辞書のキーです。
- 対応する値はunsigned long型を格納したNSNumberオブジェクトです。適切な値についてはHFS File Types?を参照してください。
- Mac OS X v10.1以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileImmutable
- ファイルが変更可能かどうかを示すファイル属性辞書のキーです。
- 対応する値は論理値を格納したNSNumberオブジェクトです。
- Mac OS X v10.2以降で使用可能です。
- NSFileManager.hで宣言されています
- NSFileModificationDate
- ファイルの最終変更日を示すファイル属性辞書のキーです。
- 対応する値はNSDateオブジェクトです。
- Mac OS X v10.0以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileOwnerAccountID
- ファイルの所有者のアカウントIDを示すファイル属性辞書のキーです。
- 対応する値はunsignd long型を格納したNSNumberオブジェクトです。
- Mac OS X v10.2以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFilePosixPermissions
- ファイルの[Posix permissions]を示すファイル属性辞書のキーです。
- 対応する値はunsignd long型を格納したNSNumberオブジェクトです。
- Mac OS X v10.0以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileReferenceCount
- ファイルのリファレンスカウントを示すファイル属性辞書のキーです。
- 対応する値はunsignd long型を格納したNSNumberオブジェクトです。
- この数字はファイルへのハードリンクの数です。
- Mac OS X v10.0以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileSize
- ファイルサイズをバイト単位で示すファイル属性辞書のキーです。
- 対応する値はunsignd long long型を格納したNSNumberオブジェクトです。
重要:ファイルがリソースフォークを持っている場合、戻り値にはその分のサイズは含まれません。 |
- Mac OS X v10.0以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileSystemFileNumber
- ファイルのファイルシステムナンバーを示すファイル属性辞書のキーです。
- 対応する値はunsignd long型を格納したNSNumberオブジェクトです。[The value corresponds to the value of st_ino, as returned by stat(2).]
- Mac OS X v10.0以降で使用可能です。
- NSFileManager.hで宣言されています。
- NSFileType
- ファイルタイプを示すファイル属性辞書のキーです。
- 対応する値はNSStringオブジェクトです(適切なlink_anchor plugin error : idが指定されていないか、存在しないページを指定しています。{「NSFileType Attribute Values」を参照してください)。
- Mac OS X v10.0以降で使用可能です。
- NSFileManager.hで宣言されています。
解説
- NSFileDeviceIdentifierはリモートデバイスのIDにアクセスするのに使われます。
宣言ファイル
- NSFileManager.h