# LEAST

## Syntax

```sql
LEAST
(
  expr1       IN anynonarray,
  expr_array  IN variadic anyarray
)
RETURNS anynonarray;
```

###

***

## 개요

LEAST 함수는 전달된 인자들 중에서 가장 작은 값을 반환한다.

만약 인자 중 하나라도 NULL이면, 전체 결과가 NULL이 된다.

PostgreSQL 기본 함수는 모든 인자가 NULL일 때만 NULL을 반환하는데, 이 함수는 하나라도 NULL이면 NULL이 된다.

#### 파라미터

| 파라미터        | 설명                                                                                                                               |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------- |
| expr1       | `anynonarray` 타입이다; 비교할 첫 번째 값. NULL이 아니어야 한다.                                                                                   |
| expr\_array | <p><code>VARIADIC anyarray</code> 타입이다; 추가 인자들을 담은 배열이다.<br>배열 안에 NULL이 있으면 전체 결과가 NULL이 된다.<br>배열의 원소들의 타입은 expr1과 동일해야 한다.</p> |

###

***

## 예제

```sql
# 테스트 1
SELECT LEAST(5, 3, 9);

 least 
-------
     3
(1 row)


# 테스트 2
SELECT LEAST('apple'::text, 'banana', 'cherry'); -- 결과: apple (문자열 사전순 비교)

 least 
-------
 apple
(1 row)

# 테스트 3
SELECT LEAST(10, NULL, 7); -- 결과: NULL

 least 
-------
      
(1 row)
```

###
