문자열 함수
.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)를 참조하세요.