BINARY


>>-BINARY--(--string-expression--+-----------+--)--------------><
                                 '-, integer-'

스키마는 SYSIBM입니다.

string-expression

문자열, 그래픽 문자열 또는 2진 문자열 데이터 유형의 값을 리턴하는 표현식

integer

결과 BINARY 데이터 유형의 길이 속성을 지정하는 정수 상수 값입니다. 값은 1 - 255여야 합니다. integer가 지정되지 않은 경우 결과의 길이 속성은 다음 값 중 작은 값입니다.

BINARY 데이터 유형의 최대 길이
바이트 단위로 표시된 string-expression의 데이터 유형에 대한 길이 속성:
- string-expression이 2진 문자열, FOR BIT DATA인 문자열 또는 문자열 단위가 OCTETS인 문자열인 경우 길이 속성
- string-expression이 CODEUNITS16 또는 2바이트의 문자열 단위를 사용하는 그래픽 문자열인 경우 길이 속성에 2를 곱한 값
- string-expression이 CODEUNITS32의 문자열 단위를 사용하는 문자열 또는 그래픽 문자열인 경우 길이 속성에 4를 곱한 값

string-expression이 비어 있는 문자열이고 integer 인수가 지정되지 않은 경우 오류가 리턴됩니다(SQLSTATE 42815).

함수의 결과는 BINARY입니다. 첫 번째 인수가 널(NULL)일 수 있는 경우, 결과는 널(NULL)일 수 있습니다. 첫 번째 인수가 널(NULL)인 경우, 결과는 널(NULL) 값입니다.

실제 길이는 결과의 길이 속성과 동일합니다. 2진 문자열로 변환되는 string-expression의 길이가 결과의 길이 속성보다 짧은 경우 결과는 결과의 길이까지 16진수 0으로 채워집니다. 2진 문자열로 변환되는 string-expression의 길이가 결과의 길이 속성보다 긴 경우 잘립니다.

다음 상황에서 경고(SQLSTATE 01004)가 리턴됩니다.

첫 번째 인수는 문자열 또는 그래픽 문자열(CLOB 또는 DBCLOB 제외)이며 비공백 문자는 잘립니다.
첫 번째 인수는 2진 문자열(BLOB 제외)이며 16진수가 아닌 0은 잘립니다.

예

다음 함수는 길이 속성이 1이고 값이 BX'00'인 고정 길이 2진 문자열을 리턴합니다.
```
   SELECT BINARY('',1)
     FROM SYSIBM.SYSDUMMY1
```
다음 함수는 길이 속성이 5이고 값이 BX'4B42480000'인 고정 길이 2진 문자열을 리턴합니다.
```
   SELECT BINARY('KBH',5)
     FROM SYSIBM.SYSDUMMY1
```
다음 함수는 길이 속성이 3이고 값이 BX'4B4248'인 고정 길이 2진 문자열을 리턴합니다.
```
   SELECT BINARY('KBH') 
     FROM SYSIBM.SYSDUMMY1
```
다음 함수는 길이 속성이 3이고 값이 BX'4B4248'인 고정 길이 2진 문자열을 리턴합니다.
```
   SELECT BINARY('KBH ',3) 
     FROM SYSIBM.SYSDUMMY1
```
다음 함수는 길이 속성이 3이고 값이 BX'4B4248'이며 경고가 있는 고정 길이 2진 문자열을 리턴합니다(SQLSTATE 01004).
```
   SELECT BINARY('KBH 93',3) 
     FROM SYSIBM.SYSDUMMY1
```

BINARY 스칼라 함수

예