TOKENCOUNT(SSIS 식)TOKENCOUNT (SSIS Expression)

지정된 구분 기호로 구분된 토큰을 포함하는 문자열의 토큰 수를 반환합니다.Returns the number of tokens in a string that contains tokens separated by the specified delimiters.

구문Syntax

TOKENCOUNT(character_expression, delimiter_string)  

인수Arguments

character_expressioncharacter_expression
구분 기호로 구분된 토큰이 포함된 문자열입니다.A string that contains tokens separated by delimiters.

delimiter_stringdelimiter_string
구분 기호 문자가 포함된 문자열입니다.A string that contains delimiter characters. 예를 들어 "; ,”에는 세미콜론, 공백 및 쉼표의 세 구분 문자가 포함되어 있습니다.For example, "; ,” contains three delimiter characters semi-colon, a blank space, and a comma.

결과 형식Result Types

DT_I4DT_I4

주의Remarks

다음 설명은 TOKEN 함수에 적용됩니다.The following remarks apply to the TOKEN function:

  • 구분 기호 문자열은 하나 이상의 구분 기호 문자를 포함할 수 있습니다.The delimiter string can contain one or more delimiter characters.

  • 선행 구분 기호는 생략합니다.Leading delimiters are skipped.

  • TOKENCOUNT는 DT_WSTR 데이터 형식에서만 실행됩니다.TOKENCOUNT works only with the DT_WSTR data type. 문자열 리터럴이나 DT_STR 데이터 형식의 데이터 열인 character_expression 인수는 TOKEN 연산을 수행하기 전에 DT_WSTR 데이터 형식으로 암시적으로 캐스팅됩니다.A character_expression argument that is a string literal or a data column with the DT_STR data type is implicitly cast to the DT_WSTR data type before TOKEN performs its operation. 다른 데이터 형식은 DT_WSTR 데이터 형식으로 명시적으로 캐스팅되어야 합니다.Other data types must be explicitly cast to the DT_WSTR data type.

  • character_expression이 null인 경우 TOKENCOUNT는 0(영)을 반환합니다.TOKENCOUNT returns 0 (zero) if the character_expression is null.

  • 변수 및 열을 이 식의 인수로 사용할 수 있습니다.You can use variables and columns as arguments for this expression.

식 예Expression Examples

다음 예에서는 문자열에 “01”, “12”, “2011”의 토큰 3개가 있으므로 TOKENCOUNT 함수에서 3을 반환합니다.In the following example, the TOKENCOUNT function returns 3 because the string contains three tokens: “01”, “12”, “2011”.

TOKENCOUNT("01/12/2011", "/")  

다음 예에서는 토큰 4개(“a”, “little”, “white”, “dog”)가 있으므로 TOKENCOUNT 함수에서 4를 반환합니다.In the following example, the TOKENCOUNT function returns 4 because there are four tokens (“a”, “little”, “white”, “dog”).

TOKENCOUNT("a little white dog"," ")  

다음 예에서 TOKENCOUNT 함수는 1을 반환합니다.In the following example, the TOKENCOUNT function returns 1. 이 함수는 입력 문자열에서 구분 기호를 구문 분석하고 문자열에 구분 기호가 없으므로 전체 문자열을 첫 번째 토큰으로 추가합니다.The function parses the input string for delimiters and since there are none in the string, it just adds the entire string as the first token.

TOKENCOUNT("a little white dog","|")  

다음 예에서 TOKENCOUNT 함수는 4를 반환합니다.In the following example, the TOKENCOUNT function returns 4. 이 예의 구분 기호 문자열에는 구분 기호가 5개 포함되어 있습니다.The delimiter string in this example contains 5 delimiters. 입력 문자열에는 “a”, “little”, “white”, “dog”의 4개 토큰이 포함되어 있습니다.The input string contains 4 tokens: “a”, “little”, “white”, “dog”.

TOKENCOUNT("a:little|white dog","| ,.:")  

다음 예에서 TOKENCOUNT 함수는 4를 반환합니다.In the following example, the TOKENCOUNT function returns 4. 모든 선행 공백 문자는 무시합니다.It ignores all the leading space characters.

TOKENCOUNT("        a little white dog", " ")  

관련 항목:See Also

함수 ( SSIS 식 )Functions (SSIS Expression)