version 11 (Modified)
GET FIELD PROPERTIES (fieldPtr | tableNum{; fieldNum}; fieldType{; fieldLength{; indexed{; unique{; invisible}}}})
| 引数 | 型 | 説明 | |
| fieldPtr | tableNum | ポインタ | 数値 | テーブル番号、またはフィールドポインタ | |
| fieldNum | 数値 | テーブル番号を渡した場合は、フィールド番号 | |
| fieldType | 数値 | フィールドのタイプ | |
| fieldLength | 数値 | 文字フィールドの場合、長さ | |
| indexed | ブール | True = インデックス付き、False = インデックスなし | |
| unique | ブール | True = 重複不可、 False = 重複あり | |
| invisible | ブール | True = 非表示、 False = 表示 |
説明
GET FIELD PROPERTIESコマンドは、tableNumとfieldNumまたはfieldPtrで指定したフィールドの情報を返します。
以下のいずれかの引数を渡します。
・引数tableNumとfieldNum、または
・fieldPtrにフィールドへのポインタ
コマンドの実行後、以下の情報が返されます。
・fieldTypeにはフィールドのタイプが返されます。以下のような定義済みの定数値が返されます。
| 定数 | タイプ | 値 |
| Is Alpha Field | 倍長整数 | 0 |
| Is Text | 倍長整数 | 2 |
| Is Real | 倍長整数 | 1 |
| Is Float | 倍長整数 | 35 |
| Is Integer | 倍長整数 | 8 |
| Is LongInt | 倍長整数 | 9 |
| Is Integer 64 bits | 倍長整数 | 25 |
| Is Date | 倍長整数 | 4 |
| Is Time | 倍長整数 | 11 |
| Is Boolean | 倍長整数 | 6 |
| Is Picture | 倍長整数 | 3 |
| Is Subtable | 倍長整数 | 7 |
| Is BLOB | 倍長整数 | 30 |
・引数fieldLenには、フィールドタイプが文字 (つまり、fieldType=Is Alpha Field) の場合、フィールドの長さが返されます。その他のフィールドタイプに対しては、fieldLenの値は意味を持ちません。
・引数indexedには、フィールドにインデックスが設定されていない場合はFalseが、フィールドにインデックスが設定されている場合はTrueが返されます。indexedの値は、フィールドタイプが文字、整数、倍長整数、実数、日付、時間、ブールの場合にだけ意味を持ちます。
・引数uniqueには、フィールドが重複不可に設定されているときはTrueが、そうでないときにはFalseが返されます。重複不可設定はインデックスフィールドにのみできます。
・引数invisibleには、フィールドが非表示に設定されているときにはTrueが、そうでないときにはFalseが返されます。非表示設定は4D標準の(ラベルやチャートなど)エディタで所定のフィールドを隠すために使うことができます。
例題
1. 以下の例は、変数vType、vLength、vIndex、vUnique、vInvisibleにテーブル番号=1、フィールド番号=3のフィールドの属性を設定します。
GET FIELD PROPERTIES(1; 3;vType;vLength;vIndex;vUnique;vInvisible)
2. 以下の例は、変数vType、vLength、vIndex、vUnique、vInvisibleに[Table3]Field2という名前のフィールドの属性を設定します。
GET FIELD PROPERTIES(->[Table3]Field2;vType;vLength;vIndex;vUnique;vInvisible)
参照