다음을 통해 공유


문자열 함수

.NET Framework Data Provider for SQL Server(SqlClient)에서는 입력 String에 대해 연산을 수행하고 String 또는 숫자 값 결과를 반환하는 String 함수를 제공합니다. 이 함수는 SqlClient를 사용할 때 사용 가능한 SqlServer 네임스페이스에 있습니다. 공급자의 네임스페이스 속성이 있으면 특정 구문(예: 형식 및 함수)에 대해 이 공급자가 사용하는 접두사를 Entity Framework에서 찾을 수 있습니다.

다음 표에서는 SqlClient String 함수를 보여 줍니다.

함수 설명
ASCII(expression) 문자열 식에서 가장 왼쪽 문자의 ASCII 코드 값을 반환합니다.

인수

expression: ASCII String 형식의 유효한 식입니다.

반환 값

Int32입니다.

예제

SqlServer.ASCII('A')
CHAR(expression) Int32 코드를 ASCII String으로 변환합니다.

인수

expression: Int32입니다.

반환 값

ASCII String입니다.

예제

SqlServer.char(97)
CHARINDEX(expression1, expression2 [, start_location]) 문자열에서 지정된 식이 시작되는 위치를 반환합니다.

인수

expression1: 찾을 문자열 시퀀스를 포함하는 식입니다. 이 식은 String(ASCII 또는 유니코드) 형식 또는 Binary 형식일 수 있습니다.

expression2: 지정된 시퀀스를 검색할 식(일반적으로 열)입니다. 이 식은 String(ASCII 또는 유니코드) 형식 또는 Binary 형식일 수 있습니다.

start_location:(옵션) expression2에서 expression1 검색을 시작할 문자 위치를 나타내는 Int64(SQL Server 2000에서는 반환되지 않음) 또는 Int32입니다. start_location이 지정되지 않았거나 음수이거나 0이면 expression2의 시작 부분에서 검색이 시작됩니다.

반환 값

Int32입니다.

예제

SqlServer.CHARINDEX('h', 'habcdefgh', 2)
DIFFERENCE(expression, expression) 두 문자열의 SOUNDEX 값을 비교하여 유사성을 계산합니다.

인수

ASCII 또는 유니코드 String 형식입니다. expression은 상수, 변수 또는 열일 수 있습니다.

반환 값

두 문자 식의 SOUNDEX 값을 비교하여 차이를 나타내는 Int32를 반환합니다. 범위는 0에서 4까지입니다. 0은 유사점이 적거나 없음을 나타내며 4는 유사점이 많거나 동일한 값임을 나타냅니다.

예제

// The following example returns a DIFFERENCE value of 4,

//the least possible difference or the best match.

SqlServer.DIFFERENCE('Green','Greene');
LEFT(expression, count) 문자열의 왼쪽부터 지정된 수만큼의 문자를 반환합니다.

인수

expression: 유니코드 또는 ASCII String 형식입니다. character_expression을 명시적으로 변환하려면 CAST 함수를 사용합니다.

count: character_expression에서 반환할 문자 수를 지정하는 Int64(SQL Server 2000에서는 반환되지 않음) 또는 Int32 형식입니다.

반환 값

유니코드 또는 ASCII String입니다.

예제

SqlServer.LEFT('SQL Server', 4)
LEN(expression) 지정한 String 식의 후행 공백을 제외한 문자 수를 반환합니다.

인수

expression: String(유니코드 또는 ASCII) 형식 또는 Binary 형식의 식입니다.

반환 값

Int32입니다.

예제

SqlServer.LEN('abcd')
LOWER(expression) 대문자 데이터를 소문자로 변환한 후 String 식을 반환합니다.

인수

expression: String 형식의 유효한 식입니다.

반환 값

String.

예제

SqlServer.LOWER('AbB')
LTRIM(expression) 선행 공백을 제거하고 String 식을 반환합니다.

인수

expression: String 형식의 유효한 식입니다.

반환 값

String.

예제

SqlServer.LTRIM(' d')
NCHAR(expression) 유니코드 표준의 정의에 따라 지정된 정수 코드에 해당하는 유니코드 String을 반환합니다.

인수

expression: Int32입니다.

반환 값

유니코드 String입니다.

예제

SqlServer.NCHAR(65)
PATINDEX('%pattern%', expression) 지정된 String 식에서 처음 발견된 패턴의 시작 위치를 반환합니다.

인수

'%pattern%': ASCII 또는 유니코드 String 형식입니다. 와일드카드 문자를 사용할 수 있지만 첫 번째 또는 마지막 문자를 검색할 때 이외에는 패턴 앞뒤에 % 문자가 있어야 합니다.

expression: 지정된 패턴을 검색할 ASCII 또는 유니코드 String입니다.

반환 값

Int32입니다.

예제

SqlServer.PATINDEX('abc', 'ab')
QUOTENAME('char_string' [, 'quote_char']) 입력 문자열이 유효한 SQL Server 2005 구분 식별자가 되도록 구분 기호를 추가한 유니코드 String을 반환합니다.

인수

char_string: 유니코드 String입니다.

quote_char: 구분 기호로 사용되는 단일 문자로 된 문자열입니다. 작은따옴표( ' ), 왼쪽 또는 오른쪽 대괄호( [ ] ) 또는 큰따옴표( " )일 수 있습니다. quote_char를 지정하지 않은 경우 대괄호가 사용됩니다.

반환 값

유니코드 String입니다.

예제

SqlServer.QUOTENAME('abc[]def')
REPLACE(expression1, expression2, expression3) 문자 식을 다른 문자 식으로 바꿉니다.

인수

expression1: 검색할 문자열 식입니다. expression1은 유니코드 또는 ASCII String 형식일 수 있습니다.

expression2:찾을 부분 문자열입니다. expression2은 유니코드 또는 ASCII String 형식일 수 있습니다.

expression3: 대체 문자열입니다. expression3은 유니코드 또는 ASCII String 형식일 수 있습니다.

예제

SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression) 문자 식을 지정한 횟수만큼 반복합니다.

인수

char_expression: 유니코드 또는 ASCII String 형식입니다.

int_expression: Int64(SQL Server 2000에서는 지원되지 않음) 또는 Int32입니다.

반환 값

유니코드 또는 ASCII String 형식입니다.

예제

SqlServer.REPLICATE('aa',2)
REVERSE(expression) 문자 위치가 입력 문자열의 역순으로 된 유니코드 또는 ASCII String을 반환합니다.

인수

expression: 유니코드 또는 ASCII String 형식입니다.

반환 값

유니코드 또는 ASCII String 형식입니다.

예제

SqlServer.REVERSE('abcd')
RIGHT(char_expression, count) 지정된 문자 수만큼 문자열의 오른쪽 부분을 반환합니다.

인수

char_expression: 유니코드 또는 ASCII String 형식입니다. character_expression을 명시적으로 변환하려면 CAST 함수를 사용합니다.

count: character_expression에서 반환할 문자 수를 지정하는 Int64(SQL Server 2000에서는 반환되지 않음) 또는 Int32 형식입니다.

반환 값

ASCII String 형식입니다.

예제

SqlServer.RIGHT('SQL Server', 6)
RTRIM(expression) 후행 공백을 제거하고 유니코드 또는 ASCII String을 반환합니다.

인수

expression: 유니코드 또는 ASCII String 형식입니다.

반환 값

유니코드 또는 ASCII String 형식입니다.

예제

SqlServer.RTRIM(' d e ')
SOUNDEX(expression) 두 문자열의 유사성을 계산하는 4자(SOUNDEX) 코드를 반환합니다.인수

expression: 유니코드 또는 ASCII String 형식입니다.

반환 값

ASCII String입니다. 4자(SOUNDEX) 코드는 두 문자열의 유사성을 계산하는 문자열입니다.

예제

Select SqlServer.SOUNDEX('Smith'), SqlServer.SOUNDEX('Smythe') FROM {1}

반환

----- ----- S530 S530
SPACE(int_expression) 반복되는 공백으로 구성된 ASCII String을 반환합니다.

인수

int_expression: 공백 수를 나타내는 Int64(SQL Server 2000에서는 반환되지 않음) 또는 Int32입니다.

반환 값

ASCII String입니다.

예제

SqlServer.SPACE(2)
STR(float_expression [, length [, decimal]]) 숫자 데이터에서 변환된 ASCII String을 반환합니다.

인수

float _expression: 소수점이 있는 근사치(Double) 데이터 형식의 식입니다.

length: (선택 사항) 전체 길이를 나타내는 Int32입니다. 소수점, 부호, 숫자 및 공백을 포함한 길이입니다. 기본값은 10입니다.

decimal:(선택 사항) 소수점 이하 자릿수를 나타내는 Int32입니다. decimal은 16보다 작거나 같아야 합니다. decimal이 16을 초과할 경우 결과가 소수점 이하 16자릿수에서 잘립니다.

반환 값

ASCII String입니다.

예제

SqlServer.STR(212.0)
STUFF(str_expression, start, length, str_expression_to_insert) 문자열 식에서 지정된 시작점부터 지정된 길이만큼 문자를 삭제하고 다른 문자 집합을 삽입합니다.

인수

str_expression: 유니코드 또는 ASCII String입니다.

start: 삭제 및 삽입을 시작하는 위치를 지정하는 Int64(SQL Server 2000에서는 반환되지 않음) 또는 Int32 값입니다.

length: 삭제할 문자 수를 지정하는 Int64(SQL Server 2000에서는 반환되지 않음) 또는 Int32 값입니다.

str_expression_to_insert: 유니코드 또는 ASCII String입니다.

반환 값

유니코드 또는 ASCII String입니다.

예제

SqlServer.STUFF('abcd', 2, 2, 'zz')
SUBSTRING(str_expression, start, length) String 식의 일부를 반환합니다.

인수

str_expression: String(유니코드 또는 ASCII) 형식 또는 Binary 형식의 식입니다.

start: 부분 문자열이 시작되는 위치를 지정하는 Int64(SQL Server 2000에서는 반환되지 않음) 또는 Int32입니다. 1은 문자열의 첫 번째 문자를 가리킵니다.

length: 식에서 반환할 문자 수를 지정하는 Int64(SQL Server 2000에서는 반환되지 않음) 또는 Int32입니다.

반환 값

String(ASCII 또는 유니코드) 형식 또는 Binary 형식입니다.

예제

SqlServer.SUBSTRING('abcd', 2, 2)
UNICODE(expression) 유니코드 표준에서 정의한 대로 입력 식에 있는 첫 글자의 정수 값을 반환합니다.

인수

expression: 유니코드 String입니다.

반환 값

Int32입니다.

예제

SqlServer.UNICODE('a')
UPPER(expression) 소문자 데이터를 대문자로 변환한 후 String 식을 반환합니다.

인수

expression: ASCII 또는 유니코드 String 형식의 식입니다.

반환 값

ASCII 또는 유니코드 String 형식입니다.

예제

SqlServer.UPPER('AbB')

SqlClient에서 지원하는 String 함수에 대한 자세한 내용은 문자열 함수(Transact-SQL)를 참조하세요.

참고 항목