OCTET_LENGTH 함수

지정된 문자열의 길이를 바이트 수대로 반환합니다.

구문

OCTET_LENGTH(expression)

인수

expression

CHAR 문자열, VARCHAR 문자열, VARBYTE 표현식 또는 암시적으로 CHAR, VARCHAR 또는 VARBYTE 형식으로 평가되는 표현식입니다.

반환 타입

INTEGER

OCTET_LENGTH 함수는 입력 문자열의 바이트 수를 나타내는 정수를 반환합니다.

입력 문자열이 문자열인 경우 LEN 함수는 바이트 수가 아닌 멀티바이트 문자열의 실제 문자 수를 반환합니다. 예를 들어 VARCHAR(12) 열에 4바이트 중국 문자 3개가 저장되어야 한다고 가정했을 때 OCTET_LENGTH 함수는 해당 문자열에 대해 12를 반환하고 LEN 함수는 동일한 문자열에 대해 3을 반환합니다.

사용 노트

표현식이 CHAR 문자열인 경우 함수는 CHAR 문자열의 길이를 반환합니다. 예를 들어 CHAR(6) 입력의 출력은 CHAR(6)입니다.

표현식이 VARCHAR 문자열인 경우 후행 공백이 계산됩니다.

예제

후행 공백 3개가 있는 문자열 francais를 CHAR 및 VARCHAR 형식으로 캐스팅할 때 바이트 수를 반환하려면 다음 예제를 사용합니다. 자세한 내용은 CAST 함수 단원을 참조하십시오.

SELECT OCTET_LENGTH(CAST('francais   ' AS CHAR(15))) AS octet_length_char, OCTET_LENGTH(CAST('francais   ' AS VARCHAR(15))) AS octet_length_varchar;

+-------------------+----------------------+
| octet_length_char | octet_length_varchar |
+-------------------+----------------------+
|                15 |                   11 |
+-------------------+----------------------+

français 문자열의 바이트 수와 문자 수를 반환하려면 다음 예제를 사용합니다.

SELECT OCTET_LENGTH('français'), LEN('français');

+--------------+-----+
| octet_length | len |
+--------------+-----+
|            9 |   8 |
+--------------+-----+

문자열 français를 VARBYTE로 캐스팅할 때 바이트 수를 반환하려면 다음 예제를 사용합니다.

SELECT OCTET_LENGTH(CAST('français' AS VARBYTE));

+--------------+
| octet_length |
+--------------+
|            9 |
+--------------+