GetFieldSelections - 圖表函數
GetFieldSelections() 傳回 string 及欄位中的目前選項。
若只有兩個或一個值未選取,會分別使用格式「NOT x,y」或「NOT y」。若選取所有值,且所有值的計數大於max_values,則會傳回文字 ALL。
語法:
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
傳回的資料類型: 字串
格式 | 描述 |
---|---|
'a, b, c' |
若所選值的數量為 max_values 或更少,傳回的字串是所選值的清單。 值以 value_sep 作為分隔符號來區隔。 |
'NOT a, b, c' |
若未選值的數量為 max_values 或更少,傳回的字串是未選值的清單,以 NOT 為前置詞。 值以 value_sep 作為分隔符號來區隔。 |
'x of y' |
x = 所選值的數量 y = 值的總數 這會在 max_values < x < ( y - max_values) 時傳回。 |
'ALL' | 若選取所有值,則會傳回。 |
'-' | 若未選取任何值,則會傳回。 |
<search string> | 若您已使用搜尋選取,會傳回搜尋字串。 |
引數:
引數 | 描述 |
---|---|
field_name | 包含待測量之資料範圍的欄位。 |
value_sep | 要置於欄位值之間的分隔符號。預設為 ', '。 |
max_values |
要個別列出的欄位值上限。要個別列出的欄位值上限。 若選取大量的值,則會改用 'x of y values' (第 x 個值,共 y 個值) 的格式。預設為 6。 |
state_name |
為特定視覺化選擇的替代狀態名稱。如果使用 state_name 引數,則只有與指定狀態名稱關聯的選項才會納入考量。 如需詳細資訊,請參閱將替代狀態用於比較分析。 |
範例與結果:
下列範例使用載入到篩選窗格的 First name 欄位。
範例 | 結果 |
---|---|
假定已在 First name 中選取 John。 GetFieldSelections ([First name]) |
「John」 |
假定已選取 John 和 Peter。 GetFieldSelections ([First name]) |
「John,Peter」 |
假定已選取 John 和 Peter。 GetFieldSelections ([First name],'; ') |
「John; Peter」 |
假定已在 First name 中選取 John、Sue、Mark。 GetFieldSelections ([First name],';',2) |
「NOT Jane;Peter」,因為值 2 指明為 max_values 引數的值。若未指明,結果就會是 John; Sue; Mark. |
範例中使用的資料:
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 '|');