テキストファイルから読み取る関数

プロンプトは、ファイルダイアログボックスのファイルとディレクトリ、または、フォルダリストの下に表示されるメッセージです。

ファイルは、refnumまたは絶対ファイルパスにできます。

パスの場合、この関数はそのパスで指定したファイルを開きます。デフォルトでは、ファイルダイアログボックスを表示してファイルを選択するように指示します。

空または相対パスを指定した場合やファイルが存在しない場合は、この関数はエラーを返します。

カウントは、関数が読み取る文字数または行数の最大値です。

最大文字数/行数に到達する前にファイルの末尾に到達した場合、読み取られる文字数または行数は、それよりも少なくなります。カウントが0未満の場合、関数は、現在のファイル位置から開始してファイル全体を読み取ります。デフォルトでは、ライン読み取りショートカットメニュー項目の横にチェックマークが付いている場合は1行を読み取り、項目の横のチェックマークが外れている場合はファイル全体を読み取ります。

エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。

refnum出力は、関数が読み取るファイルのrefnumです。ファイルの処理によって、この出力は他のファイル関数に配線できます。デフォルトは、ファイルがファイルパスによって参照されるか、ファイルダイアログボックスから選択される場合、ファイルを閉じます。ファイルがrefnumの場合、またはrefnum出力を他の関数に配線した場合、ファイルを閉じるまで、LabVIEWはファイルが使用中であるとみなします。

テキストには、ファイルから読み取られたテキストが含まれています。デフォルトでは、このパラメータはファイルの最初のラインから読み取られた文字を含む文字列です。カウントを配線する場合は、このパラメータはファイルから読み取られたラインを含む文字列の配列です。関数を右クリックしてショートカットメニューのライン読み取りのチェックマークをオフにすると、このパラメータはファイルから読み取られた文字を含む文字列となります。

キャンセルされたは、ファイルダイアログボックスをキャンセルするとTRUEになります。

それ以外は、関数がエラーを返した場合でもキャンセルされたがFALSEになります。

エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。