# TO\_MULTI\_BYTE

## Syntax

```sql
TO_MULTI_BYTE
(
  str  IN text
)
RETURNS text;
```

###

***

## 개요

단일 바이트(ASCII) 문자를 데이터베이스 인코딩에 따른 해당 다중 바이트 문자로 변환한다.

예를 들어, ASCII 범위(0x20 \~ 0x7E)에 해당하는 문자는 미리 정의된 다중 바이트 매핑 테이블(UTF8, EUC\_JP, EUC\_CN 등)에 따라 변환된다.

데이터베이스 인코딩이 해당 매핑 테이블 중 하나에 해당하면, 입력 문자열의 각 문자를 대응하는 다중 바이트 문자열로 치환하고, 그 외의 문자는 그대로 반환한다.

#### 파라미터

| 파라미터 | 설명                                                     |
| ---- | ------------------------------------------------------ |
| str  | `text` 타입이다; 변환할 대상 문자열이다. ASCII 문자들이 다중 바이트 문자로 치환된다. |

###

***

## 예제

```sql
SELECT TO_MULTI_BYTE('Hello, World!');

       to_multi_byte        
----------------------------
 Ｈｅｌｌｏ，　Ｗｏｒｌｄ！
(1 row)
```

###
