# VerifyString

VerifyString 함수는 문자열을 확인하고 합격/불합격 결과를 생성하는 데 사용됩니다.

## VerifyString 입력

매개 변수 | 설명
문자열 | 텍스트 문자열을 지정하거나 텍스트 문자열을 포함하는 스프레드시트 셀에 대한 참조를 지정합니다.
필드 문자열 | 문자열에 포함된 문자 수를 지정하고 문자열의 다양한 위치에 어떤 문자가 있어야 하는지에 대한 정보를 제공합니다.
필드 정의 | 선택 사항으로, 필드 정의 설정을 사용해 필드 문자열에 대해 사용자 정의 항목을 생성할 수 있습니다. 이러한 입력값들이 필드 문자열에 포함될 경우, 삽입되는 위치에서 유효한 문자 목록을 제한하게 됩니다.

### 필드 문자열

필드 문자열의 구성 요소는 (A - Z), (a - z), (0 - 9), 대시(-), 점(.), 공백( ) 등 모든 영문자 및 숫자가 될 수 있습니다.

필드 문자열의 각 문자는 인덱싱된 필드 위치에 해당합니다. 필드 문자열에는 최소한 해당 문자열에 포함되어 있는 문자와 동일한 개수의 위치가 포함되어 있어야 해당 문자열 확인에 합격합니다. 예컨대, 문자가 10개 있지만 필드 문자열에는 문자가 9개 밖에 지정되어 있지 않은 경우, 가장 일치도가 높은 9개만 반환됩니다. 하지만, 문자가 8개 있는데 필드 문자열에 문자가 9개 정의되어 있는 경우, 이 함수는 #ERR을 반환합니다. 기본 설정상, 필드 문자열 내 각 위치는 별표(*) 문자 또는 영문자 및 숫자로 된 "와일드카드"로 표시됩니다. 와일드카드란 문자열 내 어떤 위치에 어떤 문자가 오더라도 유효하다는 의미입니다.

사전 정의된 필드 문자열 입력값은 다음과 같습니다:

필드 문자열 입력 | 설명 | 유효한 문자
* | 와일드카드 | 글꼴의 트레이닝된 모든 문자.
N | 숫자 | 0123456789
A | 알파벳 대문자 | ABCDEFGHIJKLMNOPQRSTUVWXYZ
a | 알파벳 소문자 | abcdefghijklmnopqrstuvwxyz
H | 16진수, 알파벳 대문자 및 숫자 | 0123456789ABCDEF
h | 16진수, 알파벳 소문자 및 숫자 | 0123456789abcdef
O | 8진수 | 01234567

필드 문자열 예:

- 예 1: 필드 문자열이 **********AN인 경우, 첫 10개 필드 문자열 위치에서 해당 글꼴로된 모든 문자가 유효합니다. 하지만 11번째 위치에서는 확인 중 알파벳 대문자 입력값만 고려 대상이 됩니다. 또한 12번째 위치에서는 숫자 입력값만 고려 대상입니다.

- 예 2: 글꼴에 숫자 입력값 0 - 9와 슬래시(/)만 포함됩니다. 필드 문자열이 NN/NN/NN인 경우, 첫 번째와 두 번째, 네 번째와 다섯 번째, 일곱 번째와 여덟 번째 위치에서 숫자 입력값만 간주 대상이 됩니다. 세 번째와 여섯 번째 위치에서는 슬래시(/)만 고려 대상이 됩니다.

  하지만 필드 문자열이 NN/NN/AA인 경우, 글꼴에 알파벳 문자 입력값이 전혀 포함되어 있지 않기 때문에 판독 결과 #ERR이 반환됩니다.

### 필드 정의

선택 사항으로, 필드 정의 설정을 사용해 필드 문자열에 대해 사용자 정의 입력값을 생성할 수 있습니다. 이러한 입력값들이 필드 문자열에 포함될 경우, 삽입되는 위치에서 유효한 문자 목록을 제한하게 됩니다.

이 필드에 새 정의를 추가하여 미리 정의된 정의를 덮어쓸 수 있습니다. 예를 들어 필드 정의의 값이 A=A인 경우 필드 정의 A=A가 미리 정의된 필드 문자열 항목을 덮어쓰기 때문에 A 문자만 유효한 문자로 간주됩니다.

필드 정의 예:

- 예 1: 필드 정의의 값이 #=123;$=3456;%=789이고 필드 문자열이 #$%*******인 경우 첫 번째 위치에서 유효한 문자는 1, 2, 3 중 하나입니다. 두 번째 위치의 유효한 문자는 3, 4, 5, 6입니다. 세 번째 위치에서는 7, 8, 9만 유효합니다. 네 번째부터 열 번째 위치까지는 해당 글꼴 내 모든 문자가 유효합니다.
- 예 2: 필드 정의의 값이 #=123;$=3456;%=789, A=A이고 필드 문자열이 #$%******A인 경우 첫 번째 위치에서 유효한 문자는 1, 2, 3 중 하나입니다. 두 번째 위치의 유효한 문자는 3, 4, 5, 6입니다. 세 번째 위치에서는 7, 8, 9만 유효합니다. 네 번째부터 아홉 번째 위치까지는 해당 글꼴 내 모든 문자가 유효합니다. 또, 필드 정의 A=A가 사전 정의된 필드 문자열 입력값을 재매핑하기 때문에 열 번째 위치에서는 A 문자만 고려 대상이 됩니다.

## VerifyString 출력

반환 | 참조된 Text 데이터 구조에서 문자열의 합격/불합격 상태. 입력 매개 변수 중 하나라도 유효하지 않은 경우 #ERR. 0 = 불합격 1 = 합격