GetFieldSelections(), bir alandaki geçerli seçimler ile bir dize döndürür.
Değerlerin ikisi dışında tümü ya da biri dışında tümü seçilirse, sırasıyla 'NOT x,y' veya 'NOT y' biçimi kullanılır. Tüm değerleri seçerseniz ve tüm değerlerin sayımı max_values değerinden büyükse, ALL metni döndürülür.
Söz Dizimi:
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
Dönüş verileri türü: dize
| Biçim | Açıklama |
|---|---|
| 'a, b, c' |
Seçilen değerlerin sayısı max_values veya daha azsa, döndürülen dize seçilen değerlerin bir listesidir. Değerler sınırlayıcı olarak value_sep ile ayrılır. |
| 'NOT a, b, c' |
Seçilmeyen değerlerin sayısı max_values veya daha azsa, döndürülen dize seçilmeyen değerlerin öneki NOT olan bir listesidir. Değerler sınırlayıcı olarak value_sep ile ayrılır. |
| 'x of y' |
x = seçilen değerlerin sayısı y = toplam değer sayısı Bu, max_values < x < (y - max_values) olduğunda döndürülür. |
| 'ALL' | Tüm değerler seçildiyse döndürülür. |
| '-' | Hiçbir değer seçilmediyse döndürülür. |
| <search string> | Arama kullanarak seçim yaptıysanız, arama dizesi döndürülür. |
Bağımsız Değişkenler:
| Bağımsız Değişkenler | Açıklama |
|---|---|
| field_name | Ölçülecek veri aralığını içeren alan. |
| value_sep | Alan değerleri arasına koyulacak ayırıcı. Varsayılan, ', ' işaretidir. |
| max_values |
Ayrı ayrı listelenecek olan alan değerlerinin maksimum sayısıdır. Çok sayıda değer seçildiğinde, bunun yerine 'x/y değer' biçimi kullanılır. Varsayılan 6'dır. |
| state_name |
Belirli bir görselleştirme için seçilen alternatif durumun adı. state_name bağımsız değişkeni kullanılırsa yalnızca belirtilen durum adıyla ilişkili seçimler hesaba katılır. Daha fazla bilgi için bkz. Karşılaştırmalı analiz için alternatif durumları kullanma. |
Örnekler ve sonuçlar:
Aşağıdaki örnekte, bir filtre bölmesine yüklenen First name alanı kullanılmaktadır.
| Örnekler | Sonuçlar |
|---|---|
|
First name içinde John seçildiği varsayılırsa. GetFieldSelections ([First name]) |
'John' |
|
John ve Peter seçildiği varsayılırsa. GetFieldSelections ([First name]) |
'John,Peter' |
|
John ve Peter seçildiği varsayılırsa. GetFieldSelections ([First name],'; ') |
'John; Peter' |
|
First name içinde John, Sue, Mark seçildiği varsayılırsa. GetFieldSelections ([First name],';',2) |
'NOT Jane;Peter'; çünkü max_values bağımsız değişkeninin değeri olarak 2 değeri belirtilmektedir. Aksi takdirde, sonuç John; Sue; Mark. olurdu. |
Örnekte kullanılan veriler:
Names:
LOAD * inline [
First name|Last name|Initials|Has cellphone
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC|No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');