LOTUSSCRIPT 言語


Get ステートメント

バイナリファイルまたはランダムファイルからデータを変数に読み込みます。

構文

Get #fileNumber , [ recordNumber ] , variableName

要素

fileNumber


recordNumber
variableName
使用法

ファイル内のバイト位置またはレコード位置は常に 1 です。読み込み処理のたびに、ファイル内の位置は次のように増加します。


Get ステートメントは変数の型に応じてデータを variableName に読み込みます。次の表は、データ型ごとの Get ステートメントの動作を示しています。
variableName のデータ型Get ステートメントの動作
Variant 型最初の 2 バイトを、読み込むデータの DataType として解釈します。

DataType が EMPTY または NULL のときは、データの読み込みを中止し、variableName を EMPTY または NULL に設定します。

DataType が数値のときは、その型のデータの保持に使用されるバイト数分を読み込みます。

Byte 型: 1 バイト

Boolean 型: 2 バイト

Integer 型: 2 バイト

Long 型: 4 バイト

Single 型: 4 バイト

Double 型: 8 バイト

Currency 型: 8 バイト

Date/Time 型: 8 バイト

固定長文字列指定された文字数を読み込みます。たとえば、変数が String*10 として宣言されると、正確に 10 文字を読み込みます
可変長文字列Get ステートメントの動作は、使用しているファイルのタイプによって異なります。

ランダムファイル最初の 2 バイトを読み込み、文字列の長さを調べます。その文字数分を読み込みます。variableName がランダムファイルのレコードより大きい場合は、variableName がいっぱいになるまでファイルからデータを読み込みます。variableName がいっぱいになると、ファイル位置は次のレコードに進みます。

バイナリファイル:バイナリファイルの場合は、variableName に設定されている文字列の長さと等しいバイト数をファイルから読み込みます。variableName が初期化されていなければ、ファイルからは何のデータも読み込まれません

ユーザー定義型の変数データの読み込みに必要なバイト数は、ユーザー定義データ型のすべてのメンバの読み込みに必要なバイト数の合計になります。動的配列、リスト、オブジェクトを含めることはできません
メモ LotusScript 4 では 64K より長い文字列が可能ですが、GET および PUT ステートメントを使用して読み書きできる文字列の長さにはまだ制限があります。長い文字列を処理するファイルタイプの唯一の組み合わせは、バイナリファイルと可変長文字列です。固定長文字列、Variant 型の変数内の文字列、およびランダムファイルは 64K を超える文字列を処理しません。これは、それらに、文字列の長さを含む 2 バイトのヘッダーがあるためです。2 バイトでは 64K を超える長さを表せません。


関連項目