Systemwalker Centric Manager スクリプトガイド - UNIX/Windows(R)共通 -

2.3.11 gets（ファイルから1行読む）

◆機能説明

ファイルまたは標準入力から1行読み込みます。

◆記述形式

gets channelID 【varname】

◆オプション

channelID

openコマンドの復帰値として取得したチャンネルIDを指定します。また、“stdin”を指定することにより、標準入力からの読み込みを行います。

varname

読み込んだ行の内容を格納する変数名を指定します。省略時は、読み込んだ行の内容は復帰値として返されます。

◆復帰値

varnameを指定した場合

読み込んだ文字列の文字数を返します。1文字も読み込まずファイルの末尾に達した場合は、-1を返します。

varnameを省略した場合

読み込んだ文字列を返します。

◆注意事項

読み込みされる“1行”とは、ファイル内の現在の読み込み位置(open直後は先頭、以後読み込みを行うごとに読み込んだ分だけ移動)から改行またはファイルの末尾までのことを指します。なお、varnameで指定した変数には、改行コードは格納されません。

◆使用例

標準入力から1行(改行まで)のデータを読み込み、変数bufに格納します。

gets stdin buf

◆実行結果/出力形式

なし