# TO\_SINGLE\_BYTE

## Syntax

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

###

***

## 개요

입력된 다중 바이트 문자열을 가능한 경우 해당하는 단일 바이트(ASCII) 문자로 변환한다.

입력 문자열에서 다중 바이트 문자가 미리 정의된 매핑 테이블에 의해 단일 바이트 값(대개 ASCII 코드 0x20 이상의 값)으로 치환되며, 변환이 불가능한 문자는 원래 그대로 반환된다.

#### 파라미터

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

###

***

## 예제

```sql
SELECT TO_SINGLE_BYTE('Ｈｅｌｌｏ, ｗｏｒｌｄ!');
-- 예제 결과: 'Hello, world!'

 to_single_byte 
----------------
 Hello, world!
(1 row)
```

###
