GetFieldSelections(), bir alandaki geçerli seçimler ile bir string 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:
- field_name: Hesaplanacak 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 dikkate alınır. Daha fazla bilgi için şuraya bakın: Alternatif Durumlar.
Örnekler
Aşağıdaki örnekler, bir liste kutusuna yüklenen First name alanını kullanır.
Örnek 1: First name içinde John seçilmiştir
GetFieldSelections ([First name])
'John' döndürür
Örnek 2: First name içinde John ve Peter seçilmiştir
GetFieldSelections ([First name])
'John,Peter' döndürür
Örnek 3: First name içinde John ve Peter seçilmiştir
GetFieldSelections ([First name],'; ')
'John; Peter' döndürür
Örnek 4: First name içinde John, Sue, Mark seçilmiştir
GetFieldSelections ([First name],';',2)
"NOT Jane;Peter" döndürür çü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 '|');
