카테고리:

문자열 및 이진 함수 (일치/비교)

LEFT

입력값의 맨 왼쪽 하위 문자열을 반환합니다. LEFT(STR,N)은 SUBSTR(STR,1,N)과 동등합니다.

참고 항목

RIGHT , SUBSTR , SUBSTRING

구문

LEFT( <string_expr> , <length_expr> )
Copy

인자

string_expr

이는 VARCHAR 또는 BINARY 값이어야 합니다.

length_expr

길이는 정수로 평가되는 식이어야 합니다. 다음을 지정해야 합니다.

  • 입력이 VARCHAR 인 경우 반환할 UTF-8 문자 수입니다.

  • 입력이 BINARY 인 경우 반환할 바이트 수입니다.

길이는 0보다 크거나 같아야 합니다. 길이가 음수이면 함수는 빈 문자열을 반환합니다.

반환

반환된 값의 데이터 타입은 입력 값(BINARY 또는 VARCHAR)의 데이터 타입과 동일합니다.

데이터 정렬 세부 정보

데이터 정렬은 VARCHAR 입력에 적용됩니다. 첫 번째 매개 변수의 입력 데이터 타입이 BINARY 인 경우 데이터 정렬이 적용되지 않습니다.

데이터 정렬이 구문적으로 허용되지만, 데이터 정렬은 처리에 영향을 주지 않습니다. 예를 들어, 2자 및 3자 문자가 있는 언어(예: 헝가리어의 《dzs》, 체코어의 《ch》)는 여전히 길이 인자에 대해 두 개 또는 세 개의 문자(한 문자가 아님)로 계산합니다.

그러나 반환된 값은 첫 번째 인자의 데이터 정렬 사양을 유지합니다. 이는 반환된 값이 중첩 함수 호출의 일부로서 다른 함수에 전달되는 경우에 유용할 수 있습니다.

SELECT LEFT('ABCDEF', 3);

-------------------+
 LEFT('ABCDEF', 3) |
-------------------+
 ABC               |
-------------------+
Copy