Class

NSFileHandle

An object-oriented wrapper for a file descriptor. ファイル記述子のためのオブジェクト指向のラッパー。

Declaration 宣言

@interface NSFileHandle : NSObject

Overview 概要

You use file handle objects to access data associated with files, sockets, pipes, and devices. For files, you can read, write, and seek within the file. For sockets, pipes, and devices, you can use a file handle object to monitor the device and process data asynchronously. あなたは、ファイルハンドルオブジェクトを使って、ファイル、ソケット、パイプ、そしてデバイスと結びつけられたデータにアクセスします。ファイルに対して、あなたは読み、書き、そしてファイル内部のシークが可能です。ソケット、パイプ、そしてデバイスに対して、あなたはファイルハンドルオブジェクトを使ってデバイスの監視およびデータ処理が非同期に可能です。

Most creation methods for NSFileHandle cause the file handle object to take ownership of the associated file descriptor. NSFileHandleに対する大部分の作成メソッドは、ファイルハンドルオブジェクトにその結びつけられたファイル記述子の所有権を取らせます。 This means that the file handle object both creates the file descriptor and is responsible for closing it later, usually when the system deallocates the file handle object. If you want to use a file handle object with a file descriptor that you created, use the initWithFileDescriptor: method or use the initWithFileDescriptor:closeOnDealloc: method and pass NO for the flag parameter. あるファイルハンドルオブジェクトをあなたが作成したファイル記述子とともに使うことを望むならば、initWithFileDescriptor:メソッドを使ってください、またはinitWithFileDescriptor:closeOnDealloc:メソッドを使ってNOflagパラメータを渡してください。

Run Loop Considerations 実行ループ考察

When using a file handle object to communicate asynchronously with a socket, you must initiate the corresponding operations from a thread with an active run loop. Although the read, accept, and wait operations themselves are performed asynchronously on background threads, the file handle uses a run loop source to monitor the operations and notify your code appropriately. ファイルハンドルオブジェクトを使って非同期にソケットと通信する場合、あなたは該当する演算を、アクティブ実行ループを持つスレッドから開始しなければなりません。読み込み、受け取り、そして待ち受けの演算処理それら自体はバックグラウンドスレッド上で非同期に実行されるけれども、ファイルハンドルは実行ループソースを使うことで演算処理を監視して適切にあなたのコードに通知します。 Therefore, you must call those methods from your application’s main thread or from any thread where you’ve configured a run loop and are using it to process events.

Topics 話題

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

Getting a File Handle ファイルハンドルを取得する

Getting a File Descriptor ファイル記述子を所得する

Reading from a File Handle Synchronously ファイルハンドルから同期的に読み出す

Reading Asynchronously with Notifications 通知で非同期に読み出す

Writing to a File Handle ファイルハンドルに書き込む

Seeking Within a File ファイルの内部をシークする

Operating on a File ファイルに関する操作

Monitoring for Readability and Writability 読み出し可能性と書き込み可能性を監視する

Set these properties if you want to use a block that reads or writes based on the file handle’s availability. これらプロパティを設定してください、もしあなたがファイルハンドラの利用可能性に基づいて読み出しまたは書き込みをするブロックを使いたいならば。

Constants 定数

Notifications 通知

NSFileHandle posts several notifications related to asynchronous background I/O operations. They are set to post when the run loop of the thread that started the asynchronous operation is idle. NSFileHandleは、非同期バックグラウンドI/O演算に関連したいくらかの通知を投函します。それらは、非同期演算を開始したスレッドの実行ループがアイドル状態である時に投函するよう設定されます。

Deprecated 非推奨

Relationships 関係

Inherits From 継承元

Conforms To 次に準拠

See Also 参照

Managed File Access ファイルアクセスを管理する