foldersearch

2021/05/22 04:09 Macro::TTL コマンドリファレンス

【Tera Term マクロ言語】コマンドリファレンス

foldersearch 機能

[ファイル操作コマンド]

フォルダがあるか確かめます。

コマンドライン

foldersearch <foldername>

機能説明

フォルダが存在するかどうか調べます。

チェックする対象としてはフォルダのみとなります。
<foldername> で指定したフォルダが存在する場合は、<result> に 1 が返ります。
<foldername> で指定したフォルダが存在しないまたはファイルが存在する場合は、<result> に 0 が返ります。

<foldername>

フォルダ名を指定します。

指定した名前のファイルが存在する場合は、対象がフォルダではないため 0 (フォルダは存在しない) を返します。
このため、フォルダ作成コマンド foldercreate の実行前チェックとしては不足*1しており、ファイルが存在するかどうかも併せてチェックする必要があります。

パラメータの説明

指定するパラメータは以下の通りです。

パラメータ	型	パラメータ説明
<foldername>	文字列	フォルダ名を指定します。

対象バージョン

バージョン 4.69 以降で利用可能です。

戻り値

戻り値として以下の変数が定義されます。

変数名	値	意味
result	0	<foldername> で指定したフォルダが存在しない
result	1	<foldername> で指定したフォルダが存在する

種別：ファイル操作	Ver	機能の簡易説明
foldercreate	4.69以降	フォルダを作成する。
folderdelete	4.69以降	フォルダを削除する。

使用方法

使用例

・フォルダの有無を確認する場合

foldersearch 'data'
if result=0 messagebox 'Folder not found.' 'error'

・フォルダ作成前に同名ファイル/フォルダの有無をチェックする場合

name = 'data'
filesearch name
if result=1 then
    foldersearch name
    if result=1 then
        sprintf2 msg '%s is a folder.' name
        messagebox msg ''
    else
        sprintf2 msg '%s is a file.' name
        messagebox msg ''
    endif
else
    sprintf2 msg '%s is not found.' name
    messagebox msg ''
endif

サンプル

以下のサンプルが存在します。

備考

特にありません。

Tera Term のススメ