ページの先頭行へ戻る
Systemwalker Centric Manager API・スクリプトガイド

6.3.11 gets(ファイルから1行読む)

機能説明

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

記述形式

gets channelIDvarname

オプション

channelID

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

varname

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

復帰値

varnameを指定した場合

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

varnameを省略した場合

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

注意事項

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

使用例

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

gets stdin buf

実行結果/出力形式

なし