Type Method 型メソッド

fileHandleForUpdatingURL:error:

Returns a file handle initialized for reading and writing to the file, device, or named socket at the specified URL. 指定されたURLでのファイル、デバイス、または名前付きソケットの読み書きのために初期化されるファイルハンドルを返します。

Declaration 宣言 

+ (instancetype)fileHandleForUpdatingURL:(NSURL *)url 
                                   error:(NSError * _Nullable *)error;

Parameters パラメータ

url

The URL of the file, device, or named socket to access. アクセスするファイル、デバイス、または名前付きソケットのURL。

error

If an error occurs, upon return contains an NSError object that describes the problem. Pass NULL if you do not want error information. エラーが発生するならば、戻りでは、問題を記述するNSErrorオブジェクトを含みます。NULLをあなたがエラー情報を望まないならば渡してください。

Return Value 戻り値

The initialized file handle object or nil if no file exists at url. 初期化されたファイルハンドルオブジェクトまたは、ファイルがurlで存在しないならばnil。

Discussion 議論

The file pointer is set to the beginning of the file. The returned object responds to both NSFileHandleread... messages and writeData:. ファイルポインタは、ファイルの始まりに設定されます。返されるオブジェクトはNSFileHandleread...メッセージとwriteData:の両方に応答します。

When using this method to create a file handle object, the file handle owns its associated file descriptor and is responsible for closing it. このメソッドを使ってファイルハンドルオブジェクトを作成する場合、ファイルハンドルは、それの結び付けられたファイル記述子を所有し、そしてそれを閉じることに責任を持ちます。

See Also 参照

Creating a File Handle ファイルハンドルを作成する

- initWithFileDescriptor:
Creates and returns a file handle object associated with the specified file descriptor.
- initWithFileDescriptor:closeOnDealloc:
Creates and returns a file handle object associated with the specified file descriptor and deallocation policy.
+ fileHandleForReadingAtPath:
Returns a file handle initialized for reading the file, device, or named socket at the specified path. 指定されたパスでのファイル、デバイス、または名前付きソケットの読み込みのために初期化されるファイルハンドルを返します。
+ fileHandleForReadingFromURL:error:
Returns a file handle initialized for reading the file, device, or named socket at the specified URL. 指定されたURLでのファイル、デバイス、または名前付きソケットの読み込みのために初期化されるファイルハンドルを返します。
+ fileHandleForWritingAtPath:
Returns a file handle initialized for writing to the file, device, or named socket at the specified path. 指定されたパスでのファイル、デバイス、または名前付きソケットへの書き出しのために初期化されるファイルハンドルを返します。
+ fileHandleForWritingToURL:error:
Returns a file handle initialized for writing to the file, device, or named socket at the specified URL. 指定されたURLでのファイル、デバイス、または名前付きソケットへの書き出しのために初期化されるファイルハンドルを返します。
+ fileHandleForUpdatingAtPath:
Returns a file handle initialized for reading and writing to the file, device, or named socket at the specified path. 指定されたパスでのファイル、デバイス、または名前付きソケットの読み書きのために初期化されるファイルハンドルを返します。
- initWithCoder:
Returns a file handle initialized from data in an unarchiver.

Related Documentation 関連文書

availableData
The data currently available in the receiver. レシーバにおいて現在利用可能なデータ。
- readDataOfLength:
Reads data synchronously up to the specified number of bytes.
- readDataToEndOfFile
Reads the available data synchronously up to the end of file or maximum number of bytes.
- writeData:
Writes the specified data synchronously to the file handle.