Cocoaリファレンス日本語化計画

NSFileManager Class Reference

2011-04-13T01:23:39+09:00

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

Blocks and Variables

2010-05-12T18:15:35+09:00

//0.下はいじらない Tags:&tags() //1.以下に続けてADCでの分類を書き込みリンクする。「ガイド小見出し(日本語名)」、まで書く &link_toppage(トップ) > [[ガイド>Guides]] > ブロックプログラミング概論 //前後のページへのリンクをはる。ページ最下部にも同じものがあるので忘れずにリンクする [[前のページ>]]　　[[次のページ>]] *ブロックと変数 [[翻訳元>http://developer.apple.com/mac/library/documentation/Cocoa/Conceptual/Blocks/Articles/bxVariables.html#//apple_ref/doc/uid/TP40007502-CH6-SW1]] 　この記事ではブロックと変数間の内部的な働きをメモリ管理も含めて説明します。 //3.翻訳元の最終更新日を書くこのページの最終更新：&date() ADCの最終更新：2009-10-19 //目次は自動生成目次 #contents(fromhere=true) //4.以下、用語は頻繁に出てくる単語の翻訳ガイドラインを参照しながら翻訳する。 //5.ある程度書き終わったらタグ（未完または完成、カテゴリ名×3）をつけて下線を引く(広告との境)。これで終了。それではGood Luck! **変数の型(Types of Variable) ---- 　ブロックオブジェクトのコードの集合では、変数は五つの異なる形で扱われます。　三つの標準的な変数の型は関数内と全く同様に参照することができます。 - グローバル変数。静的変数を含む。 - グローバル関数(厳密には変数ではない)。 - スコープに囲まれたローカル変数とパラメータ。　またブロックは他に二つの変数の型をサポートしています。 + [At function level are __block variables.]これらはブロック(とスコープ)内で変更可能で、参照されているどんなブロックがヒープにコピーされても保護されます。 + constの取り込み　最後に、メソッドの実装中ではブロックはObjective-Cインスタンス変数を参照できます。「オブジェクトとブロック変数(Object and Block Variables)」を参照してください。　ブロック中で使用される変数には以下の規則が適用されます。 + グローバル変数とレキシカルスコープ中に存在する静的変数はアクセス可能です。 + ブロックに渡されたパラメータ(ちょうど関数の引数のように)はアクセス可能です。 + レキシカルスコープに囲まれた局所的なスタック(静的でない)変数はconst変数として切り取られます。&br()この変数はプログラム中でブロック表現にさしかかった時に取得されます。ネストされたブロックでは、この値は最も近いスコープから切り取られます。 + レキシカルスコープ中で__blockストレージ型修飾子で宣言された変数は参照で提供されるので変更可能になります。&br()そのレキシカルスコープ中での変更は同じスコープで宣言された他のブロックのも含め全て反映されます。これらは「__block ストレージ型(The __block Storage Type)」で詳説しています。 + ブロック中のレキシカルスコープ中で宣言されたローカル変数は関数中のローカル変数と全く同じように働きます。&br()ブロックの呼び出しではそれぞれこの変数の新しいコピーが作られます。これらの変数はブロック中のブロックでconstや参照変数として代わる代わる使うことができます。　以下の例では静的でないローカル変数の用法を説明しています。 |BGCOLOR(#eff):int x = 123;&br() &br()void (^printXAndY)(int) = ^(int y) {&br() &br() printf("%d %d\n", x, y);&br()};&br() &br()printXAndY(456); // prints: 123 456| 　注意してほしいのは、ブロック中でxで新しい値を参照しようとするとエラーになることです。 |BGCOLOR(#eff):int x = 123;&br() &br()void (^printXAndY)(int) = ^(int y) {&br() &br() x = x + y; // error&br() printf("%d %d\n", x, y);&br()};| 　変数をブロック中で変更できるようにするには、__blockストレージ型修飾子を使用します。「__block ストレージ型(The __block Storage Type)」をご覧ください。 **__block ストレージ型(The __block Storage Type) ---- 　__block型修飾子を適用することによって読み込んだ変数を変更可能であること、つまり読み書き可能であることを明示できます。__blockストレージ型はローカル変数を修飾するregister、auto、staticストレージ型と似ていますが、同時に使うことはできません。　__block変数はその変数のレキシカルスコープと、その中で生成または宣言された全てのブロックとその複製で共有されるストレージに確保されます。したがって、スタックフレームが破棄されても(例えば後で実行する為にどこかに待機させることで)、その中で宣言されたブロックの複製が生存していれば、ストレージは決して破棄されません。一つのレキシカルスコープ中の複数のブロックは共有する変数を同時に使うことがあります。　最適化の為に、ブロックストレージはブロック自体と同じようにまずスタック外に確保されます。もしブロックがBlock_copyを使って(またはObjective-Cでブロックにcopyを送って)コピーされれば、変数はヒープにコピーされます。つまり、&bold(){__block変数のアドレスは時間とともに変わることがあります。} 　__block変数にはもう二つの制限があり、可変長の配列がなること、C99可変長配列を含む構造体がなることはできません。　以下の例では__block変数の用法を説明しています。 |__block int x = 123; // xはブロックストレージ中に確保される&br() &br()void (^printXAndY)(int) = ^(int y) {&br() &br() x = x + y;&br() printf("%d %d\n", x, y);&br()};&br()printXAndY(456); // prints: 579 456&br()// 今xは579| 　以下の例ではいくつかの異なる型の変数とブロック間の相互作用を示しています。 |extern NSInteger CounterGlobal;&br()static NSInteger CounterStatic;&br() &br();{&br() NSInteger localCounter = 42;&br() __block char localCharacter;&br() &br() void (^aBlock)(void) = ^(void) {&br() ++CounterGlobal;&br() ++CounterStatic;&br() CounterGlobal = localCounter; // localCounter fixed at block creation&br() localCharacter = 'a'; // sets localCharacter in enclosing scope&br() };&br() &br() ++localCounter; // unseen by the block&br() localCharacter = 'b';&br() &br() aBlock(); // execute the block&br() // localCharacter now 'a'&br()}| **オブジェクトとブロック変数 ---- 　ブロックはObjective-CとC++のオブジェクトや別ブロックへのサポートを変数という形で提供しています。 *Objecive-Cオブジェクト　リファレンスカウンタ環境下では、ブロック中でObjective-Cオブジェクトを参照するときには通常そのオブジェクトを保持します。これはオブジェクトのインスタンス変数を単純に参照する場合でも当てはまります。ですが、__blockストレージ型修飾子のついたオブジェクト変数は保持されません。 |&bold(){注：}ガベージコレクタ環境下では、__weak修飾子や__block修飾子を変数に適用した場合、そのブロックではその変数が確保されていることを保証できません。| 　ブロックをメソッドの実装内で使用した場合、オブジェクトインスタンス変数のメモリ管理の規則はさらに巧妙になります。 - インスタンス変数に参照でアクセスしている場合には、selfが保持されます。 - インスタンス変数に値でアクセスしている場合には、その変数が保持されます。　以下の例ではこの異なる二つの状況を説明しています。 |dispatch_async(queue, ^{&br()&br() // instanceVariableは参照なのでselfが保持されます&br()&br() doSomethingWithObject(instanceVariable);&br()&br()});&br()&br() &br()&br() &br()&br()id localVariable = instanceVariable;&br()&br()dispatch_async(queue, ^{&br()&br() // localVariableは値なので、localVariableが保持されます(selfではありません)&br()&br()&br() doSomethingWithObject(localVariable);&br()&br()});| #right(){[[前のページ>Getting Started with Blocks]]　　[[次のページ>]]} ----

Movie Overlay

2010-05-05T16:55:38+09:00

ぐりぐり

Declaring and Creating Blocks

2010-03-04T23:47:16+09:00

Conceptual Overview

2010-03-02T17:40:48+09:00

Getting Started with Blocks

2010-02-28T13:50:09+09:00

Blocks Programming Topics

2010-02-28T13:06:30+09:00

//0.下はいじらない Tags:&tags() //1.以下に続けてADCでの分類を書き込みリンクする。「ガイド小見出し(日本語名)」、まで書く &link_toppage(トップ) > [[ガイド>Guides]] > 言語 > ブロックプログラミング概論 //前後のページへのリンクをはる。ページ最下部にも同じものがあるので忘れずにリンクする //2.ガイド小見出しページ名(日本語名)を見出し1で書く。wiki内のリンクで用いられるタイトルになる。翻訳元にもリンクする。 *ブロックプログラミング概論 [[翻訳元>http://developer.apple.com/mac/library/documentation/Cocoa/Conceptual/Blocks/Articles/00_Introduction.html]] //3.翻訳元の最終更新日を書くこのページの最終更新：&date() ADCの最終更新：2009-10-19 //目次は自動生成目次 #contents(fromhere=true) //4.以下、用語は頻繁に出てくる単語の翻訳ガイドラインを参照しながら翻訳する。 //5.ある程度書き終わったらタグ（未完または完成、カテゴリ名×3）をつけて下線を引く(広告との境)。これで終了。それではGood Luck! //中見出しは下線を引く *イントロダクション(Introduction) ---- 　ブロックオブジェクトはランタイム特有のCレベルの構文です。これらは通常のC関数に似ていますが、実行可能なコードに加えて自動(スタック)メモリまたは手動(ヒープ)メモリに束縛された変数も収容しています。ブロックを使えば、関数表現をAPIに渡したり、自由にストアしたり、マルチスレッド上で使ったりすることができます。　ブロックはMac OS X v10.6のデベロッパーツールとして同梱されているGCCと[[Clang>http://clang.llvm.org/]]で使うことができます。ブロックランタイムはオープンソースであり、[[LLVM’s compiler-rt subproject repository>http://llvm.org/svn/llvm-project/compiler-rt/trunk/]]で見ることができます。またブロックは[[N1370: Apple’s Extensions to C>http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1370.pdf]](ここにはガーベジコレクションも含まれています)というスタンダードCワーキンググループでも提供されています。Objective-CもC++もC由来の言語なので、ブロックは３つの全ての言語(Objective-C++も同様)で動作するように設計されています。(構文にはこの目標が表れています。) 　ブロックとは何か、C、C++、Objective-Cでどのように使うのかを学び、プログラムをより効率的、保守的にする為にこのドキュメントを読んでください。 **このドキュメントの構成(Organization of This Document) ---- このドキュメントは以下のチャプターから構成されています。 - [[「ブロックを始めよう」]]では簡潔で実践的なブロックの導入を提供しています。 - [[「大まかなコンセプト」]]ではブロックの概念の導入を提供しています。 - [[「ブロックの宣言と生成」]]ではブロック変数の宣言の仕方とブロックの実装の仕方を説明しています。 - [[「ブロックと変数」]]ではブロックと変数間の関係を説明し、__blockストレージをタイプ修飾子と定義します。 - [[「ブロックを使う」]]では様々なブロックの用法を例示します。 #right(){[[次のページ>]]} ----

NSValue Class Reference

2010-02-25T23:26:23+09:00

//0.下はいじらない Tags:&tags() //1.以下に続けてADCでの分類を書き込みリンクする。「NSHogeのクラスリファレンス」、まで書く &link_toppage(トップ) > [[リファレンス]] > データ管理：データ型とコレクション > NSValue クラスリファレンス //2.リファレンス日本語名を見出し1で書く。wiki内のリンクで用いられるタイトルになる。翻訳元にもリンクする。 *NSValue クラスリファレンス [[翻訳元>http://developer.apple.com/mac/library/documentation/Cocoa/Reference/Foundation/Classes/NSValue_Class/Reference/Reference.html#//apple_ref/occ/cl/NSValue]] //3.翻訳元の最終更新日を書くこのページの最終更新：&date() ADCの最終更新：2007-10-31 //4.以下、用語は頻繁に出てくる単語の翻訳ガイドラインを参照しながら翻訳する。 //5.ある程度書き終わったらタグ（未完または完成、カテゴリ名×3）をつけて下線を引く(広告との境)。これで終了。それではGood Luck! //本文開始↓ |BGCOLOR(#eef):継承するクラス|BGCOLOR(#eef):[[NSObject>NSObject Class Reference]]| |準拠しているプロトコル|[[NSCoding>NSCoding Protocol Reference]]&br()[[NSCopying Protocol Reference]]&br()[[NSObject (NSObject)>NSObject Protocol Reference]]| |BGCOLOR(#eef):フレームワーク|BGCOLOR(#eef):/System/Library/Frameworks/[[Foundation.framework>Foundation Framework]]| |使用可能な環境|Mac OS X v10.0 以降| |BGCOLOR(#eef):コンパニオンガイド|BGCOLOR(#eef):[[Number and Value Programming Topics for Cocoa]]| |宣言ファイル|NSGeometry.h&br()NSRange.h&br()NSValue.h| |BGCOLOR(#eef):サンプルコード|BGCOLOR(#eef):[[LightTable]]&br()[[QTAudioContextInsert]]&br()[[QTAudioExtractionPanel]]&br()[[Quartz Composer WWDC 2005 TextEdit]]&br()[[Sketch+Accessibility]]| **概観(Overview) ---- 　NSValueクラスのオブジェクトはCやObjective-Cの単独なデータの単純なコンテナです。このオブジェクトはint、float、charだけでなく、ポインタや構造体、オブジェクトのid型などのようなどんなスカラー型も持つことができます。このクラスはこのようなデータ型をNSArrayやNSSetのような要素がオブジェクトであることを要求するコレクションに入れられるようにする為に使います。NSValueオブジェクトは常に変更不能です。 **採用しているプロトコル(Adopted Protocols) ---- [[NSCoding>NSCoding Protocol Reference]] &space(8)&link_anchor(page=NSCoding Protocol Reference,encodeWithCoder:){- encodeWithCoder:} &space(8)&link_anchor(page=NSCoding Protocol Reference,initWithCoder:){- initWithCoder:} [[NSCopying>NSCopying Protocol Reference]] &space(8)&link_anchor(page=NSCopying Protocol Reference,copyWithZone:){- copyWithZone:} **このクラスでできること(Tasks) ---- **NSValueオブジェクトの作成(Creating an NSValue) &space(8)&link_anchor(initWithBytes:objCType:){– initWithBytes:objCType:} &space(8)&link_anchor(valueWithBytes:objCType:){+ valueWithBytes:objCType:} &space(8)&link_anchor(value:withObjCType:){+ value:withObjCType:} &space(8)&link_anchor(valueWithNonretainedObject:){+ valueWithNonretainedObject:} &space(8)&link_anchor(valueWithPointer:){+ valueWithPointer:} &space(8)&link_anchor(valueWithPoint:){+ valueWithPoint:} &space(8)&link_anchor(valueWithRange:){+ valueWithRange:} &space(8)&link_anchor(valueWithRect:){+ valueWithRect:} &space(8)&link_anchor(valueWithSize:){+ valueWithSize:} ***データへのアクセス(Accessing Data) &space(8)&link_anchor(getValue:){– getValue:} &space(8)&link_anchor(nonretainedObjectValue){– nonretainedObjectValue} &space(8)&link_anchor(objCType){– objCType} &space(8)&link_anchor(pointValue){– pointValue} &space(8)&link_anchor(pointerValue){– pointerValue} &space(8)&link_anchor(rangeValue){– rangeValue} &space(8)&link_anchor(rectValue){– rectValue} &space(8)&link_anchor(sizeValue){– sizeValue} ***オブジェクトの比較(Comparing Objects) &space(8)&link_anchor(isEqualToValue:){– isEqualToValue:} **クラスメソッド ---- ***&anchor(option=nolink,value:withObjCType:){value:withObjCType:} ***&anchor(option=nolink,valueWithBytes:objCType:){valueWithBytes:objCType:} ***&anchor(option=nolink,valueWithNonretainedObject:){valueWithNonretainedObject:} ***&anchor(option=nolink,valueWithPoint:){valueWithPoint:} ***&anchor(option=nolink,valueWithPointer:){valueWithPointer:} ***&anchor(option=nolink,valueWithRange:){valueWithRange:} ***&anchor(option=nolink,valueWithRect:){valueWithRect:} ***&anchor(option=nolink,valueWithSize:){valueWithSize:} **インスタンスメソッド ---- ***&anchor(option=nolink,getValue:){getValue:} ***&anchor(option=nolink,initWithBytes:objCType:){initWithBytes:objCType:} ***&anchor(option=nolink,isEqualToValue:){isEqualToValue:} ***&anchor(option=nolink,nonretainedObjectValue){nonretainedObjectValue} ***&anchor(option=nolink,objCType){objCType} ***&anchor(option=nolink,pointValue){pointValue} ***&anchor(option=nolink,pointerValue){pointerValue} ***&anchor(option=nolink,rangeValue){rangeValue} ***&anchor(option=nolink,rectValue){rectValue} ***&anchor(option=nolink,sizeValue){sizeValue} ----

NSBlockOperation Class Reference

2010-02-25T23:10:05+09:00

//0.下はいじらない Tags:&tags() //1.以下に続けてADCでの分類を書き込みリンクする。「NSHogeのクラスリファレンス」、まで書く &link_toppage(トップ) > [[リファレンス]] > データ管理：イベント制御 > NSBlockOperation クラスリファレンス //2.リファレンス日本語名を見出し1で書く。wiki内のリンクで用いられるタイトルになる。翻訳元にもリンクする。 *NSBlockOperation クラスリファレンス [[翻訳元>http://developer.apple.com/mac/library/documentation/Cocoa/Reference/NSBlockOperation_class/Reference/Reference.html]] //3.翻訳元の最終更新日を書くこのページの最終更新：&date() ADCの最終更新：2009-02-23 //4.以下、用語は頻繁に出てくる単語の翻訳ガイドラインを参照しながら翻訳する。 //5.ある程度書き終わったらタグ（未完または完成、カテゴリ名×3）をつけて下線を引く(広告との境)。これで終了。それではGood Luck! //本文開始↓ |BGCOLOR(#eef):継承するクラス|BGCOLOR(#eef):[[NSOperation>NSOperation Class Reference]] : [[NSObject>NSObject Class Reference]]| |TOP:準拠しているプロトコル|[[NSObject (NSObject)>NSObject Protocol Reference]]| |BGCOLOR(#eef):フレームワーク|BGCOLOR(#eef):/System/Library/Frameworks/[[Foundation.framework>Foundation Framework]]| |使用可能な環境|Mac OS X v10.6以降| |TOP:BGCOLOR(#eef):宣言ファイル|BGCOLOR(#eef):NSOperation.h| |TOP:コンパニオンガイド|[[Threading Programming Guide]]| **概観(Overview) ---- 　NSBlockOperationクラスは一つ以上のブロックの同時実行を管理する、[[NSOperation]]の具体サブクラスです。それぞれの処理で独立したオブジェクトを生成する必要がなく、すぐに数個のブロックを実行したいときにこのオブジェクトを使うことができます。二つ以上のブロックを実行している時は、処理自体は全てのブロックの実行が終わって初めて終了したと見なされます。　ブロック処理に加えられたブロックは標準の優先度を持って適切なワークキューへ割り当てられます。ブロック自体にはその実行状況についてどんな仮定も含めるべきではありません。　ブロックの詳細については、[[Blocks Programming Topics]]を参照してください。 **このクラスでできること(Tasks) ---- ***処理中のブロックの管理(Managing the Blocks in the Operation) &space(8)&link_anchor(blockOperationWithBlock:){+ blockOperationWithBlock:} &space(8)&link_anchor(addExecutionBlock:){– addExecutionBlock:} &space(8)&link_anchor(executionBlocks){– executionBlocks} **クラスメソッド ---- ***&anchor(option=nolink,blockOperationWithBlock:){blockOperationWithBlock:} 　NSBlockOperationオブジェクトを生成し、指定されたブロックを加えて返します。 &space(1)+ (id)blockOperationWithBlock:(void (^)(void))&italic(){block} &bold(){パラメータ} - &italic(){block} -- 新しいブロック処理のリストに加えるブロックです。このブロックは引数や戻り値に何も持たないようにしてください。 &bold(){戻り値} - 新しいブロック処理オブジェクトです。 &bold(){使用可能な条件} - Mac OS X v10.6以降 &bold(){宣言ファイル} - NSOperation.h **インスタンスメソッド ---- ***&anchor(option=nolink,addExecutionBlock:){addExecutionBlock:} 　指定されたブロックを受信先の実行されるブロックのリストに加えます。 &space(1)- (void)addExecutionBlock:(void (^)(void))&italic(){block} &bold(){パラメータ} - &italic(){block} -- 受信先のリストに加えるブロックです。このブロックは引数や戻り値に何も持たないようにしてください。 &bold(){解説} - 指定されたブロックは実行状況について何の仮定も持つべきではありません。 - 受信先が実行中の時か、既に実行が終了している時にこのメソッドを呼び出すとNSInvalidArgumentExceptionが発生します。 &bold(){使用可能な条件} - Mac OS X v10.6以降 &bold(){宣言ファイル} - NSOperation.h ***&anchor(option=nolink,executionBlocks){executionBlocks} 　受信先に関連図蹴られたブロックを収容した配列を返します。 &space(1)- ([[NSArray>NSArray Class Reference]] *)executionBlocks &bold(){戻り値} - ブロックの配列です。この配列中のブロックはもともとはaddExecutionBlock:メソッドを使って加えられたブロックの複製です。 &bold(){使用可能な条件} - Mac OS X v10.6以降 &bold(){宣言ファイル} - NSOperation.h ----

NSDictionary Class Reference

2010-02-24T22:01:41+09:00

//0.下はいじらない Tags:&tags() //1.以下に続けてADCでの分類を書き込みリンクする。「NSHogeのクラスリファレンス」、まで書く &link_toppage(トップ) > [[リファレンス]] > データ管理：データ型とコレクション > NSDictionary クラスリファレンス //2.リファレンス日本語名を見出し1で書く。wiki内のリンクで用いられるタイトルになる。翻訳元にもリンクする。 *NSDictionary クラスリファレンス [[翻訳元>http://developer.apple.com/mac/library/documentation/Cocoa/Reference/Foundation/Classes/NSDictionary_Class/Reference/Reference.html]] //3.翻訳元の最終更新日を書くこのページの最終更新：&date() ADCの最終更新：2009-08-28 //4.以下、用語は頻繁に出てくる単語の翻訳ガイドラインを参照しながら翻訳する。 //5.ある程度書き終わったらタグ（未完または完成、カテゴリ名×3）をつけて下線を引く(広告との境)。これで終了。それではGood Luck! //本文開始↓ |BGCOLOR(#eef):継承するクラス|BGCOLOR(#eef):[[NSObject>NSObject Class Reference]]| |TOP:準拠しているプロトコル|[[NSCoding>NSCoding Protocol Reference]]&br()[[NSCopying>NSCopying Protocol Reference]]&br()[[NSMutableCopying>NSMutableCopying Protocol Reference]]&br()[[NSFastEnumeration>NSFastEnumeration Protocol Refernece]]&br()[[NSObject (NSObject)>NSObject Protocol Reference]]| |BGCOLOR(#eef):フレームワーク|BGCOLOR(#eef):/System/Library/Frameworks/[[Foundation.framework>Foundation Franework]]| |使用可能な環境|Mac OS X v10.0以降| |TOP:BGCOLOR(#eef):宣言ファイル|BGCOLOR(#eef):NSDictionary.h&br()NSFileManager.h&br()NSKeyValueCoding.h| |TOP:コンパニオンガイド|[[Collections Programming Topics for Cocoa]]&br()[[Property List Programming Guide]]| |TOP:BGCOLOR(#eef):サンプルコード|BGCOLOR(#eef):[[From A View to A Movie]]&br()[[From A View to A Picture]]&br()[[People]]&br()[[QTCoreVideo301]]&br()[[Quartz Composer WWDC 2005 TextEdit]]| **概観(Overview) ---- 　NSDictionaryクラスはオブジェクトをキーと値の対で管理する変更不能なプログラマティックインターフェースを宣言しています。このクラス、また必要によりサブクラスのNSMutableDictionaruクラスを使うことによって、任意のキーに関連づけられたデータを効率的に取得することができます。(ここでは便宜的に、&bold(){辞書}という単語を実際のクラスに関係なくこれらのサブクラスのうちの一つのクラスのインスタンスをさす言葉として使います。) 　辞書中のキーと値のペアはエントリと呼ばれます。それぞれのエントリはキーを表す一つ目のオブジェクトと、そのキーに対応する値である二つ目のオブジェクトから成り立ちます。辞書では、キーは一意的なものです。つまり、一つの辞書中に、等しい(&link_anchor(){isEqual:}メソッドによって決定される)二つのキーは存在しません。通常、どんな(NSCopyingプロトコルに準拠している——以下を参照)オブジェクトでもキーになり得ます。しかし、キー値コーディングを使用する時はキーは文字列でなければならない([[Key-Value Coding Fundaentals]]を参照してください)ことに注意してください。nilはキーや値になりえません。辞書中で空の値を表現したい時は、[[NSNull>NSNull Class Reference]]オブジェクトを使用してください。　NSDictionaryのインスタンスは変更不能な辞書です。そのインスタンスのエントリは生成時に決定し、それ以後は変更できません。[[NSMutableDictionary]]のインスタンスは変更可能な辞書です。このインスタンスではいつでもエントリを追加したり削除したりでき、メモリも必要に応じて自動的に確保されます。辞書クラスはNSCopyingとNSMutableCopyingプロトコルに準拠し、辞書間での型変換を容易にしています。　NSDictionaryとNSMutableDictionaryはクラスクラスタの一部です。つまり、このインターフェースから生成したオブジェクトは正確にはこれら二つのクラスのインスタンスではありません。もっと適切に言えば、これらのインスタンスはこれらの非公開なサブクラスのインスタンスです。辞書のクラスは非公開ですが、そのインターフェースは公開されています。なぜなら、インターフェースは抽象スーパークラスであるNSDictionaryとNSMutableDictionaryで宣言されているからです。　内部的には、辞書はストレージの構成と与えられたキーに対応する値に素早くアクセスする為にハッシュテーブルを使っています。しかし、このクラス群で定義されているメソッドはハッシュテーブルやハッシュ関数、ハッシュされたキーの複雑な働きを隠蔽しています。以下で定義されているメソッドではキーを直接用い、ハッシュされた形では用いません。　辞書にエントリを追加するメソッドは、(全ての辞書の)初期化の過程や(変更可能な辞書の)変更の過程であるかにかかわらず引数のキーをコピーし(キーはNSCopyingプロトコルに準拠しなければなりません)、その複製を辞書に加えます。それぞれに対応する値には辞書の使用中に解放されないことを保証する為に&link_anchor(){retain}メッセージが送られます。 ***列挙(Enumeration) 　辞書のコンテンツは&link_anchor(){keyEnumerator}や&link_anchor(){objectEnumerator}によって返されるNSEnumeratorを使ってそれぞれキー、値を列挙することができます。Mac OS X v10.5以降上では、NSDictionaryは[[NSFastEnumeration]]プロトコルをサポートしていますので、for...in構文を使って辞書中のキーを列挙することができます。以下の例で説明します。 |BGCOLOR(#eef):NSArray *keys = [NSArray arrayWithObjects:@"key1", @"key2", @"key3", nil];&br()NSArray *objects = [NSArray arrayWithObjects:@"value1", @"value2", @"value3", nil];&br()NSDictionary *dictionary = [NSDictionary dictionaryWithObjects:objects forKeys:keys];&br() &br()for (id key in dictionary) {&br() NSLog(@"key: %@, value: %@", key, [dictionary objectForKey:key]);&br()}| 　Mac OS X v10.6以降では、NSDictionaryはブロックオブジェクトを使用した列挙をサポートしています。 ***プリミィティブメソッド(Primitive Methods) 　NSDictionaryの3つのプリミィティブメソッドである、&link_anchor(){count}、&link_anchor(){objectForKey:}、&link_anchor(){keyEnumerator}はこのインターフェース中の他のメソッドの基礎を提供しています。&link_anchor(){count}メソッドは辞書中のエントリの数を返します。&link_anchor(){objectForKey:}は与えられたキーに関連づけられた値を返します。&link_anchor(){keyEnumerator}は辞書中のキーを順番に参照する為のオブジェクトを返します。ここで宣言されているその他のメソッドはこれらのメソッドを一回、またはそれ以上呼び出して動作しています。プリミティブメソッド以外のメソッドは、一度に複数のエントリにアクセスする便利な手段を提供します。 ***記述と永続性(Desctiptions and Persistance) 　プロパティリスト形式で文字列やファイルに書き出すには、それぞれdescription...や&link_anchor(){writeToFile:atomically:}メソッドが使用できます。これらをカスタムデータオブジェクトのストレージの永続化に使用するのは一般的には推奨されません。代替手段としては[[Archives and Serializations Programming Guide for Cocoa]]を参照してください。 ***Toll-Freeブリッジ(Toll-Free Bridging) 　NSDictionaryは対応するCore Foundationの[[CFDictionary Reference]]と「toll-freeブリッジ」です。つまり、関数やメソッド中のCore Foundation型はブリッジしているFoundationオブジェクトと相互に交換可能だということです。したがって、メソッド中のNSDictionary *パラメータにCFDictionaryRefを渡すことも、CFDictionaryRefパラメータにNSDicationaryインスタンスを渡すこともできます(コンパイル時の警告を押さえるにはその型にキャストします)。このブリッジはNSDictionaryの具体サブクラスにも適用されます。toll-freeブリッジについての詳細はInterchangeable Data Typesを参照してください。 **採用しているプロトコル(Adopted Protocols) ---- [[NSCoding>NSCoding Protocol Reference]] &space(8)&link_anchor(page=NSCoding Protocol Reference,encodeWithCoder:){– encodeWithCoder:} &space(8)&link_anchor(page=NSCoding Protocol Reference,initWithCoder:){– initWithCoder:} [[NSCopying>NSCopying Protocol Reference]] &space(8)&link_anchor(page=NSCopying Protocol Reference,copyWithZone:){– copyWithZone:} [[NSMutableCopying>NSMutableCopying Protocol Reference]] &space(8)&link_anchor(page=NSMutableCopying Protocol Reference,mutableCopyWithZone:){– mutableCopyWithZone:} [[NSFastEnumeration>NSFastEnumeration Protocol Reference]] &space(8)&link_anchor(page=NSFastEnumeration Protocol Reference,countByEnumeratingWithState:objects:count:){– countByEnumeratingWithState:objects:count:} **このクラスでできること(Tasks) ---- ***辞書の生成(Creating a Dictionary) &space(8)&link_anchor(dictionary){+ dictionary} &space(8)&link_anchor(dictionaryWithContentsOfFile:){+ dictionaryWithContentsOfFile:} &space(8)&link_anchor(dictionaryWithContentsOfURL:){+ dictionaryWithContentsOfURL:} &space(8)&link_anchor(dictionaryWithDictionary:){+ dictionaryWithDictionary:} &space(8)&link_anchor(dictionaryWithObject:forKey:){+ dictionaryWithObject:forKey:} &space(8)&link_anchor(dictionaryWithObjects:forKeys:){+ dictionaryWithObjects:forKeys:} &space(8)&link_anchor(dictionaryWithObjects:forKeys:count:){+ dictionaryWithObjects:forKeys:count:} &space(8)&link_anchor(dictionaryWithObjectsAndKeys:){+ dictionaryWithObjectsAndKeys:} ***NSDictionaryインスタンスの初期化(Initializing an NSDictionary Instance) &space(8)&link_anchor(initWithContentsOfFile:){– initWithContentsOfFile:} &space(8)&link_anchor(initWithContentsOfURL:){– initWithContentsOfURL:} &space(8)&link_anchor(initWithDictionary:){– initWithDictionary:} &space(8)&link_anchor(initWithDictionary:copyItems:){– initWithDictionary:copyItems:} &space(8)&link_anchor(initWithObjects:forKeys:){– initWithObjects:forKeys:} &space(8)&link_anchor(initWithObjects:forKeys:count:){– initWithObjects:forKeys:count:} &space(8)&link_anchor(initWithObjectsAndKeys:){– initWithObjectsAndKeys:} ***エントリの数え上げ(Counting Entries) &space(8)&link_anchor(count){– count} ***辞書の比較(Comparing Dictionaries) &space(8)&link_anchor(isEqualToDictionary:){– isEqualToDictionary:} ***キーや値へのアクセス(Accessing Keys and Values) &space(8)&link_anchor(allKeys){– allKeys} &space(8)&link_anchor(allKeysForObject:){– allKeysForObject:} &space(8)&link_anchor(allValues){– allValues} &space(8)&link_anchor(getObjects:andKeys:){– getObjects:andKeys:} &space(8)&link_anchor(objectForKey:){– objectForKey:} &space(8)&link_anchor(objectsForKeys:notFoundMarker:){– objectsForKeys:notFoundMarker:} &space(8)&link_anchor(valueForKey:){– valueForKey:} ***辞書の列挙(Enumerating Dictionaries) &space(8)&link_anchor(keyEnumerator){– keyEnumerator} &space(8)&link_anchor(objectEnumerator){– objectEnumerator} &space(8)&link_anchor(enumerateKeysAndObjectsUsingBlock:){– enumerateKeysAndObjectsUsingBlock:} &space(8)&link_anchor(enumerateKeysAndObjectsWithOptions:usingBlock:){– enumerateKeysAndObjectsWithOptions:usingBlock:} ***辞書の整理(Sorting Dictionaries) &space(8)&link_anchor(keysSortedByValueUsingSelector:){– keysSortedByValueUsingSelector:} &space(8)&link_anchor(keysSortedByValueUsingComparator:){– keysSortedByValueUsingComparator:} &space(8)&link_anchor(keysSortedByValueWithOptions:usingComparator:){– keysSortedByValueWithOptions:usingComparator:} ***辞書の濾過(Filtering Dictionaries) &space(8)&link_anchor(keysOfEntriesPassingTest:){– keysOfEntriesPassingTest:} &space(8)&link_anchor(keysOfEntriesWithOptions:passingTest:){– keysOfEntriesWithOptions:passingTest:} ***辞書のストア(Storing Dictionaries) &space(8)&link_anchor(writeToFile:atomically:){– writeToFile:atomically:} &space(8)&link_anchor(writeToURL:atomically:){– writeToURL:atomically:} ***ファイル属性へのアクセス(Accessing File Attributes) &space(8)&link_anchor(fileCreationDate){– fileCreationDate} &space(8)&link_anchor(fileExtensionHidden){– fileExtensionHidden} &space(8)&link_anchor(fileGroupOwnerAccountID){– fileGroupOwnerAccountID} &space(8)&link_anchor(fileGroupOwnerAccountName){– fileGroupOwnerAccountName} &space(8)&link_anchor(fileHFSCreatorCode){– fileHFSCreatorCode} &space(8)&link_anchor(fileHFSTypeCode){– fileHFSTypeCode} &space(8)&link_anchor(fileIsAppendOnly){– fileIsAppendOnly} &space(8)&link_anchor(fileIsImmutable){– fileIsImmutable} &space(8)&link_anchor(fileModificationDate){– fileModificationDate} &space(8)&link_anchor(fileOwnerAccountID){– fileOwnerAccountID} &space(8)&link_anchor(fileOwnerAccountName){– fileOwnerAccountName} &space(8)&link_anchor(filePosixPermissions){– filePosixPermissions} &space(8)&link_anchor(fileSize){– fileSize} &space(8)&link_anchor(fileSystemFileNumber){– fileSystemFileNumber} &space(8)&link_anchor(fileSystemNumber){– fileSystemNumber} &space(8)&link_anchor(fileType){– fileType} ***記述の生成(Creating a Description) &space(8)&link_anchor(description){– description} &space(8)&link_anchor(descriptionInStringsFileFormat){– descriptionInStringsFileFormat} &space(8)&link_anchor(descriptionWithLocale:){– descriptionWithLocale:} &space(8)&link_anchor(descriptionWithLocale:indent:){– descriptionWithLocale:indent:} **クラスメソッド ---- ***&anchor(option=nolink,dictionary){dictionary} ***&anchor(option=nolink,dictionaryWithContentsOfFile:){dictionaryWithContentsOfFile:} ***&anchor(option=nolink,dictionaryWithContentsOfURL:){dictionaryWithContentsOfURL:} ***&anchor(option=nolink,dictionaryWithDictionary:){dictionaryWithDictionary:} ***&anchor(option=nolink,dictionaryWithObject:forKey:){dictionaryWithObject:forKey:} ***&anchor(option=nolink,dictionaryWithObjects:forKeys:){dictionaryWithObjects:forKeys:} ***&anchor(option=nolink,dictionaryWithObjects:forKeys:count:){dictionaryWithObjects:forKeys:count:} ***&anchor(option=nolink,dictionaryWithObjectsAndKeys:){dictionaryWithObjectsAndKeys:} **インスタンスメソッド ---- ***&anchor(option=nolink,allKeys){allKeys} ***&anchor(option=nolink,allKeysForObject:){allKeysForObject:} ***&anchor(option=nolink,allValues){allValues} ***&anchor(option=nolink,count){count} ***&anchor(option=nolink,description){description} ***&anchor(option=nolink,descriptionInStringsFileFormat){descriptionInStringsFileFormat} ***&anchor(option=nolink,descriptionWithLocale:){descriptionWithLocale:} ***&anchor(option=nolink,descriptionWithLocale:indent:){descriptionWithLocale:indent:} ***&anchor(option=nolink,enumerateKeysAndObjectsUsingBlock:){enumerateKeysAndObjectsUsingBlock:} ***&anchor(option=nolink,enumerateKeysAndObjectsWithOptions:usingBlock:){enumerateKeysAndObjectsWithOptions:usingBlock:} ***&anchor(option=nolink,fileCreationDate){fileCreationDate} ***&anchor(option=nolink,fileExtensionHidden){fileExtensionHidden} ***&anchor(option=nolink,fileGroupOwnerAccountID){fileGroupOwnerAccountID} ***&anchor(option=nolink,fileGroupOwnerAccountName){fileGroupOwnerAccountName} ***&anchor(option=nolink,fileHFSCreatorCode){fileHFSCreatorCode} ***&anchor(option=nolink,fileHFSTypeCode){fileHFSTypeCode} ***&anchor(option=nolink,fileIsAppendOnly){fileIsAppendOnly} ***&anchor(option=nolink,fileIsImmutable){fileIsImmutable} ***&anchor(option=nolink,fileModificationDate){fileModificationDate} ***&anchor(option=nolink,fileOwnerAccountID){fileOwnerAccountID} ***&anchor(option=nolink,fileOwnerAccountName){fileOwnerAccountName} ***&anchor(option=nolink,filePosixPermissions){filePosixPermissions} ***&anchor(option=nolink,fileSize){fileSize} ***&anchor(option=nolink,fileSystemFileNumber){fileSystemFileNumber} ***&anchor(option=nolink,fileSystemNumber){fileSystemNumber} ***&anchor(option=nolink,fileType){fileType} ***&anchor(option=nolink,getObjects:andKeys:){getObjects:andKeys:} ***&anchor(option=nolink,initWithContentsOfFile:){initWithContentsOfFile:} ***&anchor(option=nolink,initWithContentsOfURL:){initWithContentsOfURL:} ***&anchor(option=nolink,initWithDictionary:){initWithDictionary:} ***&anchor(option=nolink,initWithDictionary:copyItems:){initWithDictionary:copyItems:} ***&anchor(option=nolink,initWithObjects:forKeys:){initWithObjects:forKeys:} ***&anchor(option=nolink,initWithObjects:forKeys:count:){initWithObjects:forKeys:count:} ***&anchor(option=nolink,initWithObjectsAndKeys:){initWithObjectsAndKeys:} ***&anchor(option=nolink,isEqualToDictionary:){isEqualToDictionary:} ***&anchor(option=nolink,keyEnumerator){keyEnumerator} ***&anchor(option=nolink,keysOfEntriesPassingTest:)keysOfEntriesPassingTest:} ***&anchor(option=nolink,keysOfEntriesWithOptions:passingTest:){keysOfEntriesWithOptions:passingTest:} ***&anchor(option=nolink,keysSortedByValueUsingComparator:){keysSortedByValueUsingComparator:} ***&anchor(option=nolink,keysSortedByValueUsingSelector:){keysSortedByValueUsingSelector:} ***&anchor(option=nolink,keysSortedByValueWithOptions:usingComparator:){keysSortedByValueWithOptions:usingComparator:} ***&anchor(option=nolink,objectEnumerator){objectEnumerator} ***&anchor(option=nolink,objectForKey:){objectForKey:} ***&anchor(option=nolink,objectsForKeys:notFoundMarker:){objectsForKeys:notFoundMarker:} ***&anchor(option=nolink,valueForKey:){valueForKey:} ***&anchor(option=nolink,writeToFile:atomically:){writeToFile:atomically:} ***&anchor(option=nolink,writeToURL:atomically:){writeToURL:atomically:} ----