4D v16.3

DISTINCT ATTRIBUTE VALUES

ホーム

 
4D v16.3
DISTINCT ATTRIBUTE VALUES

DISTINCT ATTRIBUTE VALUES 


 

DISTINCT ATTRIBUTE VALUES ( objectField ; path ; valuesArray ) 
引数   説明
objectField  フィールド in 重複しない属性値の一覧を取得したいオブジェクトフィールド
path  テキスト in 重複しない値を取得したい属性へのパス
valuesArray  テキスト配列, 倍長整数配列, ブール配列, 日付配列, Time array in 属性パス内の重複しない値

説明   

テーマ: 配列

DISTINCT ATTRIBUTE VALUES コマンドは、フィールドが所属するテーブルのカレントセレクションのobjectField引数で指定したフィールド内の、path引数で指定した属性から取得した重複しない(固有の)値を含む配列valuesArrayを作成します。objectField引数で指定するフィールドはオブジェクト型でなければならないという点に注意して下さい。コマンドはインデックスつきのフィールドにもインデックスなしのフィールドにも使用できます。

path 引数には、有効な属性へのパスを渡します。ネストされた属性へのパスを定義するには標準のドット表記を使用して下さい。例えば、"company.address.number"のようにです。オブジェクト属性名は大文字と小文字を区別するという点に注意して下さい。

valuesArray引数に渡す配列は、path引 数で指定した属性と同じ型でなければならないという点に注意して下さい。値はスカラー値である、以下の配列型のみがサポートされます: テキスト、数字、ブール、日付、時間(ポインター、オブジェクト、Blob、画像はサポートされません)。 全てのフィールドの属性の値が同じ型であるということを確認して下さい。そうでない場合にはエラーが返されます。例えば、属性において、一つのレコードに"Monday"、別のレコードに10125が入っていた場合、エラーが返されます。

呼び出し後に、配列のサイズはセレクション内で見つかった固有の値の数と同じになります。コマンドはカレントセレクションまたはカレントレコードを変更しません。

このコマンドでは"length"仮想プロパティが使用できます。配列型の全ての属性に対して自動的に使用可能で、配列のサイズ、つまり格納される要素の数を提供します。このプロパティはクエリで使用される事を想定して設計されています(QUERY BY ATTRIBUTEQUERY BY ATTRIBUTEを参照して下さい)。またDISTINCT ATTRIBUTE VALUESコマンドに対して使用する事で、属性の異なる配列サイズを取得することもできます。

例題  

データベースに、[Customer]full_Data というオブジェクトフィールドがあり、レコードが15ある場合を考えます:

以下のコードを実行した場合:

 ARRAY LONGINT(aLAges;0)
 ARRAY LONGINT(aLAgesChild;0)
 ARRAY LONGINT(aLChildNum;0)
 ALL RECORDS([Customer])
  //"age"属性の重複しない値を取得
 DISTINCT ATTRIBUTE VALUES([Customer]full_Data;"age";aLAges)
  //"Children"配列の"age"属性の重複しない値を取得
 DISTINCT ATTRIBUTE VALUES([Customer]full_Data;"Children[].age";aLAgesChild)
  //length仮想プロパティを使用して子供の重複しない値を取得
 DISTINCT ATTRIBUTE VALUES([Customer]full_Data;"Children.length";aLChildNum)

aLAges 配列には以下の要素が格納されます:

要素
133
235
336
440
542
644
752
854
960

aLAgesChild 配列には以下の要素が格納されます:

要素
12
23
34
45
56
610
712
814
915
1016

aLChildNum 配列には以下の要素が格納されます:

要素
11
22
33



参照 


DISTINCT ATTRIBUTE PATHS

 
プロパティ 

プロダクト: 4D
テーマ: 配列
番号: 1397

This command can be run in preemptive processes

 
履歴 

New
初出: 4D v16

 
タグ 

object, object field

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v16)
ランゲージリファレンス ( 4D v16.1)
ランゲージリファレンス ( 4D v16.2)
ランゲージリファレンス ( 4D v16.3)