AutoShell › AutoShell コア リファレンス › AutoShell の一般コマンド › dir、ls コマンド -- ファイルおよびディレクトリ情報の取得（Funclet）

dir、ls コマンド -- ファイルおよびディレクトリ情報の取得（Funclet）

これらのコマンド（funclet）は、ローカル システムまたはリモート システムの指定されたディレクトリ内のコンテンツ情報をリスト表示します。 set alternate to コマンドを使用して、ファイルに出力を書き込むことができます。

コマンドの構文は以下のとおりです。

{dir|ls} mask [-silent] [-retval] [-l] [-user username] [-pass password] [-key key phrase] [-port portnumber]

mask

オプションで絶対パスまたは相対パスのディレクトリ指定を含む検索マスクで文字列を定義します。

検索マスクは、DOS のワイルドカード検索と互換性のある、簡略化された正規表現構文を使用します。

• * は、ゼロ個以上の任意の文字に一致します。
• ? は、任意の 1 文字に一致します。
• [abc] は、a、b または c のいずれか 1 文字に一致します。
• [a-f] は、a ～ f のいずれかに一致します。
• [^a-f] は、a ～ f 以外のいずれかに一致します。
• [-_] は、- または _ に一致します。[^-_] はそのほかの任意の文字に一致します。 開始角かっこ、または ^ の直後に指定されている場合、ダッシュ「-」は特殊文字ではありません。
• [a^] は、a または a^ に一致します。 （開始角かっこの直後に指定されていない場合、キャレット「^」は特殊文字ではありません）。
• ¥*、¥?、¥[、¥]、¥¥ は、それぞれ 1 個の *、?、[、]、¥ に一致します。

  他の文字はすべて特殊文字ではありません。それぞれの文字に一致します。

  デフォルト： ""

-silent

（オプション）アクティブな出力ストリームへの出力を抑制します。

-retval

（オプション）戻り値を表す配列を作成します。 配列にはファイルの情報が格納されます。 各要素は、ファイル名を表す文字列で構成されます。 引数 -l を指定すると、各要素は以下の項目を含む配列で構成されます。

• item[0] - ファイル名を表す文字列
• item[1] - ファイル サイズを表す数値
• item[2] - 最終変更日時を表す日付
• item[3] - ディレクトリ フラグを表すブール値
• item[4] - パスを含む完全修飾ファイル名を表す文字列

-l

（オプション）出力に長いリスト形式を使用します。

-user username

（オプション）リモート ノードへのログインに使用するユーザ名を指定します。 ユーザ名はパスワードまたは公開鍵認証に必要です。 ユーザ名を指定しない場合、AutoShell へのログイン時に入力されたユーザ名が使用されます。 引用符で囲まれていない引数トークンは自動的に文字列に変換されます。 式が自動的に引用されないようにするには、式をかっこで囲みます。

デフォルト： $$User

-pass password

（オプション）リモート ノードへのログインに使用するパスワードを指定します。 パスワードを指定しない場合、AutoShell へのログイン時に入力されたパスワードが使用されます。 このコマンドを発行した後に非表示でパスワードを入力するには、引数としてオプションのプロンプトと PW_GET() を指定します。 引用符で囲まれていない引数トークンは自動的に文字列に変換されます。 式が自動的に引用されないようにするには、式をかっこで囲みます。

デフォルト： $$Pass

-key key

（オプション）リモート ノードへのログインに使用する、RSA の秘密鍵が保存されているファイルへの絶対パスまたは相対パスを指定します。 秘密鍵とパスワードが指定された場合、AutoShell はまず公開鍵でログオンしようとします。公開鍵でのログオンに失敗した場合は、パスワードでログオンします。 引用符で囲まれていない引数トークンは自動的に文字列に変換されます。 式が自動的に引用されないようにするには、式をかっこで囲みます。 このパラメータは、公開鍵認証を使用して、オンザフライで SSH セッションを作成する場合にのみ必要です。

デフォルト： ""

phrase

秘密鍵のパスフレーズを指定します。 キーが暗号化されていない場合、パスフレーズは不要です。 このコマンドを発行した後に非表示でパスワードを入力するには、引数としてオプションのプロンプトと PW_GET() を指定します。 引用符で囲まれていない引数トークンは自動的に文字列に変換されます。 式が自動的に引用されないようにするには、式をかっこで囲みます。

デフォルト： ""

-port portnumber

（オプション）ターゲット システムに接続するポートです。

デフォルト： SSH の標準ポート 22。

例

現在のディレクトリにあるファイル名を取得します。

dir

ディレクトリ c:¥test にあるファイル名を取得します。

dir c:/test

ディレクトリ c:¥test と c:¥test¥more にあるファイル名を取得し、ファイル test.list のコンテンツとして出力します。

set alternate to test.list
dir c:¥test
dir c:¥test¥more
set alternate to

リモート サーバ ascli1 の c:¥temp にあるディレクトリのコンテンツをリスト表示します。

dir ascli1::c:/temp

後で処理するためにディレクトリ c:/test/more にあるファイル名を配列で取得し、標準出力への出力を抑制します。

set result disp off
aRet = dir c:/test/more -silent -retval

後で処理するためにディレクトリ c:/test/more にあるファイルの詳細情報を配列で取得します。

aRet = dir c:/test/more -silent -retval -l

関連項目

cd、chdir コマンド -- ディレクトリの変更（Cmdlet、Funclet）

pwd コマンド -- 作業ディレクトリ名の出力（Cmdlet）

set alternate to コマンド -- 別の出力ファイルを設定する（Cmdlet）