NSFileManagerItemReplacementOptions Options for specifying the behavior of file replacement operations.
ファイル置換操作の挙動を指定しているオプション。
The item containing the content you want to replace. あなたが置き換えるのを望む内容を含んでいる項目。
Instance Method
インスタンスメソッド
replace
replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error:
Replaces the contents of the item at the specified URL in a manner that ensures no data loss occurs.
データ損失が生じないことを保証する流儀で、指定されたURLで項目の内容を置き換えます。
Availability 有効性
- iOS 4.0+
- iPadOS 4.0+
- macOS 10.6+
- Mac Catalyst 13.1+
- tvOS 9.0+
- watchOS 2.0+
Technology
- Foundation ファウンデーション
Declaration 宣言
Parameters パラメータ
originalItemURLnewItemURLThe item containing the new content for
original. It is recommended that you put this item in a temporary directory as provided by the OS. If a temporary directory is not available, put this item in a uniquely named directory that is in the same directory as the original item.Item URL originalに対する新しい内容を含んでいる項目。あなたがこの項目をOSによって提供されるような一時ディレクトリの中に置くことは推奨されます。一時ディレクトリが利用可能でないならば、この項目を独特に命名されたディレクトリの中においてください、それは元の項目と同じディレクトリの中にです。Item URL backupItemNameIf provided, the name used to create a backup of the original item. 提供されるならば、元の項目のバックアップを作成するのに使われる名前。
The backup is automatically placed in the same directory as the original item. If an error occurs during the creation of the backup item, the operation fails. If there is already an item with the same name as the backup item, that item will be removed. バックアップは、自動的に元の項目と同じディレクトリの中に位置します。バックアップ項目の作成の間にエラーが発生するならば、操作は失敗します。バックアップ項目と同じ名前を持つ項目が既にあるならば、その項目は取り除かれます。
The backup item will be removed in the event of success unless the
NSFileoption is provided inManager Item Replacement Without Deleting Backup Item options. バックアップ項目は、イベントの成功において取り除かれます、NSFileオプションがManager Item Replacement Without Deleting Backup Item optionsにおいて提供される場合を除いて。options オプションThe options to use during the replacement. Typically, you pass
NSFilefor this parameter, which uses only the metadata from the new item. You can also combine the options described inManager Item Replacement Using New Metadata Only NSFileusing the C-bitwise OR operator. 置換の間に使うためのオプション。概して、あなたはManager Item Replacement Options NSFileをこのパラメータに渡します、それは新しい項目からのメタデータのみ使います。あなたはまた、Manager Item Replacement Using New Metadata Only NSFileで記述されるオプションをCビット単位OR演算子を使って結合できます。Manager Item Replacement Options resultingURLOn input, a pointer for a URL object. When the item is replaced, this pointer is set to the URL of the new item. If no new file system object is required, the URL object in this parameter may be the same passed to the
originalparameter. However, if a new file system object is required, the URL object may be different. For example, replacing an RTF document with an RTFD document requires the creation of a new file. 入力では、URLオブジェクトに対するポインタ。項目が置き換えられた場合、このポインタは新しい項目のURLに設定されます。新しいファイルシステムオブジェクトが必要とされないならば、このパラメータの中のURLオブジェクトはItem URL originalパラメータに渡されたものと同じであるかもしれません。しかしながら、新しいファイルシステムオブジェクトが必要とされるならば、URLオブジェクトは異なるでしょう。例えば、RTF書類をRTFD書類で置き換えることは、新しいファイルの作成を必要とします。Item URL errorOn input, a pointer to an error object. If an error occurs, this pointer is set to an error object containing the error information. You may specify
nilfor this parameter if you do not want the error information. 入力では、エラーオブジェクトへのポインタ。エラーが発生するならば、このポインタはエラー情報を含んでいるエラーオブジェクトへと設定されます。あなたは、nilをこのパラメータに対して指定するかもしれません、もしあなたがエラー情報を望まないならば。
Return Value 戻り値
YES if the replacement was successful or NO if an error occurred.
置き換えが成功したならばYESまたはエラーが発生したならばNO。
Discussion 議論
By default, the creation date, permissions, Finder label and color, and Spotlight comments of the original item are preserved on the new item. You can configure which metadata is preserved using the options parameter.
初期状態で、元の項目の作成日、権限、Finderのラベルとカラー、そしてSpotlightコメントは、新しい項目上で保たれます。あなたは、どのメタデータが保たれるかoptionsパラメータを使って構成設定できます。
This method works only when the original and new parameters are located on the same volume. Attempting to call this method by passing original and new parameters that have locations on different volumes results in an error. Instead, you can call the URLFor method, passing NSItem as the search path directory, to get a temporary URL on the destination's volume that is suitable for use with this method.
このメソッドは、originalとnewパラメータが同じボリューム上に位置する場合にのみ働きます。このメソッドを異なるボリューム上に位置するoriginalとnewパラメータを渡すことによって呼び出す試みは、エラーという結果になります。代わりに、あなたはURLForメソッドを呼び出して、NSItemを検索パスディレクトリとして渡して、行き先のボリューム上の一時URLを得ることができます、それはこのメソッドで使うのに適します。
If an error occurs and the original item is not in the original location or a temporary location, the resulting error object contains a user info dictionary with the key "NSFile. The value assigned to that key is an NSURL object with the location of the item. The error code is one of the file-related errors described in NSError Codes.
エラーが発生するそして元の項目が元の場所や一時的場所にないならば、結果のエラーオブジェクトはキー"NSFileをもつユーザ情報辞書を含みます。そのキーに割り当てられた値は、項目の場所を持つNSURLオブジェクトです。エラーコードは、NSErrorコードにおいて記述されるファイル関連エラーの１つです。