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 값' 형식이 대신 사용됩니다. 기본값은 6입니다.
- state_name: 특정 시각화를 위해 선택된 대체 상태의 이름입니다. state_name 인수를 사용하는 경우 지정된 상태 이름과 연관된 선택만 고려됩니다. 자세한 내용은 대체 상태을 참조하십시오.
예
다음 예는 목록 상자에 로드된 First name 필드를 사용합니다.
예 1: First name에서 John이 선택됩니다.
GetFieldSelections ([First name])
'John'를 반환합니다.
예 2: First name에서 John과 Peter가 선택됩니다.
GetFieldSelections ([First name])
'John,Peter'를 반환합니다.
예 3: First name에서 John과 Peter가 선택됩니다.
GetFieldSelections ([First name],'; ')
'John; Peter'를 반환합니다.
예 4: 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 '|');
