@LDESCENDANTS

指定されたメンバー・リスト内のメンバーのすべての子孫、または指定された世代またはレベルまでのすべての子孫を戻します。この関数は、指定されたメンバーを除外します。

この関数を別の関数のパラメータとして使用できます。関数にはメンバーのリストが必要です。

構文

@LDESCENDANTS ((memberSetFunction) [,genLevNum])

パラメータ

memberSetFunction

メンバーのリストを戻すメンバー・セット関数。

この関数の使用方法によって、許可されるメンバー・セット関数が決まります。次のガイドラインに従います。

この関数を(FIX文内ではなく)単独で使用する場合は、@LISTを使用してメンバー名を指定する必要があります。例:
```
@LIST(mbr1,mbr2,...)
```
@LDESCENDANTSがFIX文内で使用されている場合は、@UDAや@ATTRIBUTEなどのメンバー・セット関数を使用できます。例:
```
@UDA(dimName,uda)
```
```
@ATTRIBUTE (attMbrName)
```
この場合、@LISTを使用するかどうかを選択できます。たとえば、次の文は両方とも有効で、文は同じ結果を返します。

@ATTRIBUTEのみを使用する例:
```
FIX
(@LDESCENDANTS(@ATTRIBUTE(Caffeinated_True),@ATTRIBUTE(Ounces_12),"200-40"))
...
ENDFIX;
```
@LISTおよび@ATTRIBUTEの使用例:
```
FIX
(@LDESCENDANTS(@LIST(@ATTRIBUTE(Caffeinated_True),@ATTRIBUTE(Ounces_12),"200-40")))
...
ENDFIX;
```

注意:

指定したメンバー・リストのすべてのメンバーは、同じディメンションのものである必要があります。

genLevNum

オプション。メンバーを選択する上限の絶対世代番号または絶対レベル番号を定義する整数値。正の整数は世代番号を表します。 0または負の整数はレベル番号を表します。

例

すべての例は、Sample.Basicデータベースのものです。

@LDESCENDANTS(@LIST("100”,"200”,"300”))

100-10、100-20、100-30 (100の子孫)、200-10、200-20、200-30、200-40 (200の子孫)、300-10、300-20、300-30 (300の子孫)を返します。

@LDESCENDANTS(@LIST(“Market”),-1)

East、West、SouthおよびCentral (指定されたメンバーMarketのレベル1までの子孫)を戻します。

FIX
(@LDESCENDANTS(@UDA(Market,"Major Market”)))
...
ENDFIX;

New York、Massachusetts、Florida、ConnecticutおよびNew Hampshire (指定されたEastの子孫)、Illinois、Ohio、Wisconsin、Missouri、IowaおよびColorado (指定されたCentralの子孫)を戻します。 CaliforniaおよびTexas (指定されたメンバー)には子孫がないため、除外されます。

FIX
(@LDESCENDANTS(@ATTRIBUTE(Caffeinated_True),@ATTRIBUTE(Ounces_12),"200–40”))
...
ENDFIX;

指定されたメンバー(100-10、100-20、200-10、300-30。カフェイン・コート済、12オンス・ドリンクおよび200-40)のいずれにも子孫がないため、空のリストを戻します。