Class

Process

An object that represents a subprocess of the current process.

Declaration 宣言 

class Process : NSObject

Overview 概要

Using the Process class, your program can run another program as a subprocess and can monitor that program’s execution. A Process object creates a separate executable entity; it’s different from Thread because it doesn’t share memory space with the process that creates it.

A process operates within an environment defined by the current values for several items: the current directory, standard input, standard output, standard error, and the values of any environment variables. プロセスは、いくつかの項目：現在のディレクトリ、標準入力、標準出力、標準エラー、そして何らかの環境変数の値に対して、現在の値によって定義されるある環境内で演算します。 By default, a Process object inherits its environment from the process that launches it. If there are any values that should be different for the process (for example, if the current directory needs to change), change the value before your app launches it. Your app can’t change a process’s environment while it’s running.

You can only run a Process object once. Subsequent attempts raise an error. その後の試みはエラーを引き起こします。

Topics 話題

Creating and Initializing a Process Object

class func run(URL, arguments: [String], terminationHandler: ((Process) -> Void)?) -> Process
Creates and runs a task with a specified executable and arguments.
init()
Returns an initialized process object with the environment of the current process.

Returning Process Information

var processIdentifier: Int32
The receiver’s process identifier. レシーバのもつプロセス識別子。

Running and Stopping a Process

func run()
Runs the process with the current environment.
func interrupt()
Sends an interrupt signal to the receiver and all of its subtasks. 割り込み信号をレシーバとそれの下位タスクの全てに送ります。
func resume() -> Bool
Resumes execution of a suspended task.
func suspend() -> Bool
Suspends execution of the receiver task. レシーバタスクの遂行を一時停止します。
func terminate()
Sends a terminate signal to the receiver and all of its subtasks. 終止信号をレシーバとそれの下位タスクの全てに送ります。
func waitUntilExit()
Blocks the process until the receiver is finished.

Querying the Process State

var isRunning: Bool
A status that indicates whether the receiver is still running.
var terminationStatus: Int32
The exit status the receiver’s executable returns.
var terminationReason: Process.TerminationReason
The reason the system terminated the task.

Configuring a Process Object

var arguments: [String]?
The command arguments that the system uses to launch the executable.
var currentDirectoryURL: URL?
The current directory for the receiver.
var environment: [String : String]?
The environment for the receiver.
var executableURL: URL?
The receiver’s executable.
var qualityOfService: QualityOfService
The default quality of service level the system applies to operations the task executes.
var standardError: Any?
The standard error for the receiver.
var standardInput: Any?
The standard input for the receiver.
var standardOutput: Any?
The standard output for the receiver.

Process Termination Handler

var terminationHandler: ((Process) -> Void)?
A completion block the system invokes when the task completes.

Constants 定数

enum Process.TerminationReason
Constants that specify the termination reason values that the system returns.
enum QualityOfService
Constants that indicate the nature and importance of work to the system.

Notifications 通知

class let didTerminateNotification: NSNotification.Name
Posted when the task has stopped execution. タスクが遂行を停止した時に投函されます。

Deprecated 非推奨

class func launchedProcess(launchPath: String, arguments: [String]) -> Process
Creates and launches a task with a specified executable and arguments. あるタスクをある指定された実行形式ファイルと引数で作成して起動します。
Deprecated 非推奨
var currentDirectoryPath: String
Sets the current directory for the receiver. レシーバに対する現在のディレクトリを設定します。
Deprecated 非推奨
var launchPath: String?
Sets the receiver’s executable. レシーバのもつ実行可能ファイルを設定します。
Deprecated 非推奨
func launch()
Launches the task represented by the receiver. レシーバによって表されるタスクを起動します。
Deprecated 非推奨

Relationships 関係

Inherits From 継承元

See Also 参照

Tasks and Pipes タスクとパイプ

class Pipe
A one-way communications channel between related processes. 関連プロセス間の一方通行通信経路。