unix

UNIX コマンドを実行して出力を返す

プラットフォームに依存しないコードには、system コマンドを使用してください。

構文

[status,cmdout] = unix(command)

説明

[status,cmdout] = unix(command) は、オペレーティング システムを呼び出して指定のコマンドを実行し、コマンドの標準出力を cmdout に返します。

MATLAB^® はシェル プログラムを使用して、与えられたコマンドを実行します。ユーザー システムの環境変数を確認することによって、どのシェル プログラムを使用するかを定義します。MATLAB は、最初に変数 MATLAB_SHELL を確認し、空または定義されていない場合は、SHELL を確認します。SHELL が空または定義されていない場合、MATLAB は /bin/sh を使用します。

制限についてのヒントと詳細は、system を参照してください。

例

オペレーティング システム コマンドのステータスと出力の表示

cd コマンドを使用して現在のフォルダーを表示します。status がゼロの場合はコマンドが正常に完了したことを示します。MATLAB は現在のフォルダーを含む文字ベクトルを cmdout に返します。

command = 'cd';
[status,cmdout] = unix(command)

入力引数

command — UNIX^® コマンド

文字ベクトル

UNIX コマンド。文字ベクトルとして指定します。command は UNIX シェルで実行されますが、MATLAB を起動したシェルとは異なる場合があります。

例: 'ls'

出力引数

status — コマンド終了ステータス

0 | 非ゼロの整数

コマンド終了ステータス。0 または非ゼロの整数として返されます。コマンドが正常に終了した場合、status は 0 です。それ以外の場合、status は非ゼロの整数です。

• command がアンパサンド文字 (&) を含む場合、status は command 開始時の終了ステータスです。

• command がアンパサンド文字 (&) を含まない場合、status は command 完了時の終了ステータスです。

cmdout — オペレーティング システム コマンドの出力

文字ベクトル

オペレーティング システム コマンドの出力。文字ベクトルとして返されます。システム シェルでは Unicode^® 非対応文字が正しく表示されない場合があります。

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。 (R2024b 以降)

使用上の注意および制限:

• Windows^® と UNIX では、呼び出し元プロセスの stdin が継承されます。

• UNIX では、2 番目の出力が要求されると、stdout がパイプにリダイレクトされます。それ以外の場合、stdout は呼び出し元プロセスから継承されます。

• Windows では、nargout によって、パイプから読み取られた出力を変数に格納するか、呼び出し元プロセスの stdout に送るかが決定されます。引数の数が 1 の場合、パイプからの出力は stdout に送られます。それ以外の場合、変数に格納されます。

バージョン履歴

R2006a より前に導入

参考

system | cmdsep

トピック

• 外部コマンド、スクリプト、プログラムの実行