STUFF(Transact-SQL)

STUFF 함수는 다른 문자열에 문자열을 삽입합니다. 이 함수는 지정된 시작 위치와 문자 수에 따라 첫 번째 문자열의 문자를 삭제하고 두 번째 문자열을 시작 위치에 삽입합니다.

Transact-SQL 구문 표기 규칙

구문

STUFF ( character_expression , start , length , replaceWith_expression )

인수

• character_expression
  문자 데이터의 식입니다. character_expression은 문자나 이진 데이터의 상수, 변수 또는 열일 수 있습니다.

• start
  삭제 및 삽입 시작 위치를 지정하는 정수 값입니다. start 또는 length가 음수이면 Null 문자열이 반환됩니다. start가 첫 번째 character_expression보다 길면 Null 문자열이 반환됩니다. start는 bigint 형식일 수 있습니다.

• length
  삭제할 문자 수를 지정하는 정수입니다. length가 첫 번째 character_expression보다 길면 마지막 character_expression의 마지막 문자까지 삭제됩니다. length는 bigint 형식일 수 있습니다.

• replaceWith_expression
  문자 데이터의 식입니다. character_expression은 문자나 이진 데이터의 상수, 변수 또는 열일 수 있습니다. 이 식은 start부터 시작하여 character_expression의 length 문자를 대체합니다.

반환 형식

character_expression이 지원되는 문자 데이터 형식 중 하나이면 문자 데이터를 반환합니다. character_expression이 지원되는 이진 데이터 형식 중 하나이면 이진 데이터를 반환합니다.

주의

시작 위치 또는 길이가 음수이거나 시작 위치가 첫 번째 문자열의 길이를 넘어서면 null 문자열이 반환됩니다. 시작 위치가 0일 경우 Null 값이 반환됩니다. 삭제할 길이가 첫 번째 문자열보다 길면 첫 번째 문자열의 첫 번째 문자까지 삭제됩니다.

결과 값이 반환 유형이 지원하는 최대값보다 크면 오류가 발생합니다.

보조 문자(서로게이트 쌍)

SC 데이터 정렬을 사용할 경우 character_expression 및 replaceWith_expression 모두 서로게이트 쌍을 포함할 수 있습니다. 길이 매개 변수가 character_expression의 각 서로게이트를 단일 문자로 계산합니다.

예

다음 예에서는 첫 문자열 abcdef에서 2 위치의 b부터 세 문자를 삭제하고 삭제 지점에 두 번째 문자열을 삽입하여 만든 문자열을 반환합니다.

SELECT STUFF('abcdef', 2, 3, 'ijklmn');
GO

결과 집합은 다음과 같습니다.

--------- 
aijklmnef 

(1 row(s) affected)

참고 항목

참조

데이터 형식(Transact-SQL)

문자열 함수(Transact-SQL)